TypedArray.prototype.join()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2016年9月以降、すべてのブラウザーで利用可能です。
join() は TypedArray インスタンスのメソッドで、この型付き配列のすべての要素を、カンマまたは指定する区切り文字で連結して新しい文字列を作成して返します。型付き配列に 1 つの項目しかない場合、その項目は区切り文字を使用せずに返します。このメソッドのアルゴリズムは Array.prototype.join() と同じです。
試してみましょう
const uint8 = new Uint8Array([10, 20, 30, 40, 50]);
console.log(uint8.join());
// 予想される結果: "10,20,30,40,50"
console.log(uint8.join(""));
// 予想される結果: "1020304050"
console.log(uint8.join("-"));
// 予想される結果: "10-20-30-40-50"
構文
js
join()
join(separator)
引数
separator省略可-
配列の各要素を区切る文字列を指定します。
separatorは、必要であれば文字列に変換されます。省略した場合、配列の要素はカンマ (",") で区切られます。
返値
型付き配列の要素をすべて連結した文字列です。 array.length が 0 の場合は空文字列を返します。
解説
詳細については、 Array.prototype.join() をご覧ください。このメソッドは汎用的ではなく、型付き配列インスタンスに対してのみ呼び出すことができます。
例
join() の使用
js
const uint8 = new Uint8Array([1, 2, 3]);
uint8.join(); // '1,2,3'
uint8.join(" / "); // '1 / 2 / 3'
uint8.join(""); // '123'
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Language Specification # sec-%typedarray%.prototype.join |