join() メソッドは、配列のすべての要素を文字列に結合します。このメソッドは Array.prototype.join() と同じアルゴリズムを持ちます。TypedArray は、ここでは型付き配列型の1つです。
このインタラクティブな例のソースは GitHub リポジトリに保存されています。インタラクティブなサンプルプロジェクトに貢献したい場合は https://github.com/mdn/interactive-examples をクローンしてプルリクエストを送ってください。
構文
typedarray.join([separator = ',']);
引数
separator- オプション。各要素を分割する文字列を指定します。必要であれば、separatorは文字列に変換されます。省略されたら、typed arrayの要素はカンマ (",") で分割されます。
戻り値
すべての配列要素を結合した文字列。
例
var uint8 = new Uint8Array([1,2,3]);
uint8.join(); // '1,2,3'
uint8.join(' / '); // '1 / 2 / 3'
uint8.join(''); // '123'
ポリフィル
TypedArray という名前のグローバルオブジェクトがないため、ポリフィルは「必要に応じて」行わなければなりません。
// https://tc39.github.io/ecma262/#sec-%typedarray%.prototype.join
if (!Uint8Array.prototype.join) {
Object.defineProperty(Uint8Array.prototype, 'join', {
value: Array.prototype.join
});
}
Object.defineProperty をサポートしていない本当に時代遅れの JavaScript エンジンをサポートする必要がある場合は、Array.prototype メソッドを列挙しないように入力しないことをお勧めします。
仕様
| 仕様書 | ステータス | コメント |
|---|---|---|
| ECMAScript 2015 (6th Edition, ECMA-262) TypedArray.prototype.join の定義 |
標準 | 初期定義 |
| ECMAScript Latest Draft (ECMA-262) TypedArray.prototype.join の定義 |
ドラフト |
ブラウザ実装状況
このページの互換性テーブルは構造化データから生成されます。データに貢献したい場合は https://github.com/mdn/browser-compat-data をチェックして、プルリクエストを送ってください。
Update compatibility data on GitHub
| デスクトップ | モバイル | サーバー | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
join | Chrome 完全対応 45 | Edge 完全対応 14 | Firefox 完全対応 37 | IE 未対応 なし | Opera 完全対応 32 | Safari 未対応 なし | WebView Android 完全対応 45 | Chrome Android 完全対応 45 | Firefox Android 完全対応 37 | Opera Android 完全対応 32 | Safari iOS 未対応 なし | Samsung Internet Android 完全対応 5.0 | nodejs 完全対応 4.0.0 |
凡例
- 完全対応
- 完全対応
- 未対応
- 未対応