English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

JavaScript 配列 splice() メソッド

 JavaScript配列オブジェクト

splice()メソッドは、既存の要素を削除したり、新しい要素を追加することで配列を変更します。

追加する要素数と削除する要素数が異なる場合、配列の長さも異なります。

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

文法:

array.splice(start, deleteCount, [item1, item2, ...])
var months = ['Jan' 'Mar' 'Apr' 'Jun'];
months.splice(1, 0, 'Feb');// adding 'Feb' at index 1
テストを試してみる‹/›

ブラウザの互換性

テーブルの数字は、splice()メソッドを完全にサポートする最初のブラウザのバージョンを指定しています:

メソッド
splice()115.5

パラメータの値

パラメータ説明
start配列に追加を開始/削除する要素のインデックス。負の値を指定すると、配列の末尾から位置を指定します。
deleteCount(オプション)削除する要素数。0に設定すると、要素は削除されません。
item1, item2, ...(オプション)配列に追加する要素、以下から開始索引start要素を指定しない場合、splice()は配列から要素を削除するだけです。

技術的詳細

返り値:削除された要素を含む配列(あれば)を返します
JavaScriptバージョン:ECMAScript 1

さらに例

以下に4インデックスで置き換え1個の要素:

var months = ['Jan' 'Feb' 'Mar' 'Apr' 'Jun'];
months.splice(4, 1, 'May');   // replace 'Jun' with 'May' at index 4
テストを試してみる‹/›

インデックス3から削除1個の要素:

var months = ['Jan' 'Feb' 'Mar' 'Apr' 'Jun'];
months.splice(3, 1);
テストを試してみる‹/›

インデックス2から削除2個の要素:

var months = ['Jan' 'Feb' 'Mar' 'Apr' 'Jun'];
months.splice(2, 2);
テストを試してみる‹/›

インデックス0から削除2個の要素を削除して、4個の値:

var months = ['Jan' 'Feb' 'Mar' 'Apr' 'Jun'];
months.splice(0, 2, 'A' 'B' 'C' 'D');
テストを試してみる‹/›

このsplice()メソッドは削除された要素を含む配列を返します:

var months = ['Jan' 'Feb' 'Mar' 'Apr' 'Jun'];
var arr = months.splice(2, 2);
テストを試してみる‹/›

 JavaScript配列オブジェクト