Widely available すべての主要ブラウザで対応済み。安心して使用可能。

Array copyWithin()

copyWithin() は Array インスタンスのメソッドで、この配列の一部を配列内の他の場所にシャローコピーし、この配列を長さを変更せずに返します。

配列ES2015

対応ブラウザ

機能 デスクトップ モバイル
Chrome
Edge
Firefox
Safari
Chrome Android
Safari iOS
Array.copyWithin
45
12
32
9
45
9
TypedArray.copyWithin

copyWithin() は TypedArray インスタンスのメソッドで、この型付き配列の一部を同じ型付き配列の別の場所にシャローコピーし、この型付き配列の長さを変更せずに返します。このメソッドは Array.prototype.copyWithin() と同じアルゴリズムです。
45
12
34
10
45
10
1+対応 (バージョン) 未対応 ※注釈あり サブ機能の解説は MDN Web Docs (CC BY-SA 2.5)

基本構文

JAVASCRIPT 
const arr = [1, 2, 3, 4, 5];

arr.copyWithin(0, 3); // [4, 5, 3, 4, 5]
arr.copyWithin(1, 3, 4); // [4, 4, 3, 4, 5]

ライブデモ

要素のシフト

配列内の要素を、別のインデックスにずらして上書きします。

プレビュー全画面表示

特定範囲の上書き

インデックス1から1要素分だけ、3番目の要素で上書きします。

プレビュー全画面表示

繰り返しパターンの作成

配列の前半部分を後半にコピーして、繰り返しを作ります。

プレビュー全画面表示

実務での使いどころ

  • Array copyWithin() の活用

    copyWithin() は Array インスタンスのメソッドで、この配列の一部を配列内の他の場所にシャローコピーし、この配列を長さを変更せずに返します。

注意点

  • 特になし。すべての主要ブラウザで安定して動作する。

アクセシビリティ

  • JavaScript による動的更新時は、aria-live リージョンで変更をスクリーンリーダーに通知する。

参考リンク