TypedArray.prototype.join()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
join() は TypedArray インスタンスのメソッドで、この型付き配列のすべての要素を、カンマまたは指定する区切り文字で連結して新しい文字列を作成して返します。型付き配列に 1 つの項目しかない場合、その項目は区切り文字を使用せずに返します。このメソッドのアルゴリズムは Array.prototype.join() と同じです。
試してみましょう
const uint8 = new Uint8Array([10, 20, 30, 40, 50]);
console.log(uint8.join());
// Expected output: "10,20,30,40,50"
console.log(uint8.join(""));
// Expected output: "1020304050"
console.log(uint8.join("-"));
// Expected output: "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'
仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-%typedarray%.prototype.join |