JavaScript splice()メソッド

Array 对象参考手册JavaScript Array オブジェクト

例

配列に新しい要素を追加する:

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

fruits出力結果:

Banana,Orange,Lemon,Kiwi,Apple,Mango

試してみる »

定義と用法

splice() メソッドは、配列内の要素を追加または削除するために使用します。

注意:このメソッドは元の配列を変更します。

戻り値

要素を1つ削除した場合は、1つの要素を含む配列を返します。何も削除しなかった場合は、空の配列を返します。


ブラウザサポート

すべての主要ブラウザが splice() をサポートしています。

Chrome IE Edge Firefox Safari Opera
対応 対応 対応 対応 対応 対応

構文

array.splice(index,howmany,item1,.....,itemX)

パラメータ Values

引数 説明
index 必須。要素を追加/削除する位置を指定します。
この引数は、挿入および(または)削除を開始する配列要素のインデックスで、数値でなければなりません。
howmany 省略可能。削除する要素の数を指定します。数値である必要がありますが、"0" にすることもできます。
この引数を指定しない場合、index から元の配列の末尾までのすべての要素が削除されます。
item1, ..., itemX 省略可能。配列に追加する新しい要素

戻り値

Type 説明
Array arrayObject から要素が削除された場合、削除された要素を含む配列を返します。

技術詳細

JavaScript バージョン: 1.2


その他の例

例

配列の3番目の要素を削除し、配列の3番目の位置に新しい要素を追加します:

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.splice(2,1,"Lemon","Kiwi");

fruits出力結果:

Banana,Orange,Lemon,Kiwi,Mango

試してみる »

例

3番目の位置から後ろの2つの要素を削除します:

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

fruits出力結果:

Banana,Orange

試してみる »

例:配列内の指定された要素を削除する

const array = [2, 5, 9];

document.write(array);

const index = array.indexOf(5); // 要素5を削除
if (index > -1) { // 見つかった指定要素を削除
  array.splice(index, 1); // 要素を削除
}
document.write("<br>")
// array = [2, 9]
document.write(array);

試してみる »


Array 对象参考手册JavaScript Array オブジェクト

その他の拡張