JavaScript Array copyWithin() メソッド

定義と使用法

copyWithin() このメソッドは配列の要素を配列内の別の場所にコピーし、既存の値を上書きします。

copyWithin() このメソッドは配列に追加のアイテムを追加することは決してしません。

ヒント：copyWithin() このメソッドは元の配列を上書きします。

例

例1

最初の2つの配列要素を最後の2つの配列要素にコピーします：

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.copyWithin(2, 0);

実際に試してみる

例2

最初の2つの配列要素を3番目と4番目の位置にコピーします：

var fruits = ["Banana", "Orange", "Apple", "Mango", "Kiwi", "Papaya"];
fruits.copyWithin(2, 0, 2);

実際に試してみる

文法

array.copyWithin(target, start, end)

パラメータの値

パラメータ 説明
target 必須。要素をコピーするインデックス位置。
start オプション。コピーを開始するインデックス位置（デフォルトは 0）。
end オプション。コピーを停止するインデックス位置（デフォルトは array.length）。

技術的詳細

返り値： 配列、変更された配列。
JavaScript バージョン： ECMAScript 6

ブラウザのサポート

テーブルの数字は、このメソッドを完全にサポートする最初のブラウザのバージョンを示しています。

Chrome Edge Firefox Safari Opera
Chrome 45 Edge Firefox 32 Safari 9 Opera 32
2015年9月 2015年7月 2014年9月 2015年9月 2015年9月

注釈：Internet Explorer は copyWithin() メソッドをサポートしていません。

関連ページ

チュートリアル：JavaScript 配列

チュートリアル：JavaScript 配列 Const

チュートリアル：JavaScript 配列メソッド

チュートリアル：JavaScript 配列のソート

チュートリアル：JavaScript 配列のイテレーション