JavaScript Array toSpliced()メソッド
例
配列内の要素の順序を反転させます:
//配列を作成
const sites = ["Google", "サンプル", "JYSHARE", "Taobao"];
//2番目の位置に "Zhihu" と "Wiki" を追加
const sites2 = sites.toSpliced(2, 0, "Zhihu", "Wiki");
document.getElementById("demo").innerHTML = sites2;
出力結果:
Google,サンプル,Zhihu,Wiki,JYSHARE,Taobao
試してみる »
定義と使用法
toSpliced() メソッドは、配列に要素を追加および/または削除するために使用されます。
toSpliced() メソッドは新しい配列を返します。
toSpliced() メソッドは元の配列を変更しません。
toSpliced() は splice() メソッドのコピーバージョンです。
ブラウザサポート
toSpliced() は ES2023 の機能です。
2023年7月以降、すべての最新ブラウザがこの機能をサポートしています:
| Chrome 110 | Edge 110 | Firefox 115 | Safari 16.4 | Opera 96 |
| Feb 2023 | Feb 2023 | Jul 2023 | Mar 2023 | May 2023 |
構文
array.toSpliced(index, count, item1, ..., itemX)
引数
| 引数 | 説明 |
|---|---|
| index(必須) | 要素を追加または削除するインデックス(位置)。負の値は配列の末尾から数えます。 |
| count(オプション) | 削除する要素の数。 |
| item1, ...(オプション) | 追加する新しい要素。 |
戻り値
| 型 | 説明 |
|---|---|
| Array | 変更された新しい配列を含みます。 |
その他の例
要素を削除:
例
const fruits = ["Banana", "Orange", "Apple", "Mango"];
const fruits2 = fruits.toSpliced(2, 2); // ["Banana", "Orange"]
const fruits2 = fruits.toSpliced(2, 2); // ["Banana", "Orange"]
要素を削除して追加:
例
const fruits = ["Banana", "Orange", "Apple", "Mango"];
const fruits2 = fruits.toSpliced(2, 1, "Lemon", "Kiwi"); // ["Banana", "Orange", "Lemon", "Kiwi", "Mango"]
const fruits2 = fruits.toSpliced(2, 1, "Lemon", "Kiwi"); // ["Banana", "Orange", "Lemon", "Kiwi", "Mango"]
その他の拡張
JavaScript Array オブジェクト