HOWTO · JavaScript
JavaScript で配列から最初の要素を削除する
この記事では、JavaScript の配列から最初の要素を削除する方法を解説します。
このページの内容
JavaScriptの配列から最初の要素を削除するには、元の配列を変更するshift()またはsplice(0, 1)を使います。元の配列を残したい場合は、slice(1)またはfilter()で新しい配列を作成できます。shift()は削除した要素を単一の値として返し、splice(0, 1)は配列として返します。
元の配列を変更して最初の要素を削除する
shift()とsplice()は、どちらも元の配列から要素を削除します。常に先頭の要素を削除するならshift()を使います。指定した位置での削除や複数要素の削除にも同じ操作を使いたい場合は、splice()が適しています。
shift()はインデックス0の要素を削除し、残りの要素を前方に詰めて、削除した値を返します。次の例では、更新後の配列と削除された要素を確認できます。
このセクションのコードと表示されるラベルや出力は英語のままです。
const items = ["first", "second", "third"];
const removed = items.shift();
console.log(JSON.stringify({ items, removed }));
{"items":["second","third"],"removed":"first"}
これらの文を実行すると、itemsには末尾の2つの文字列が残り、removedには"first"が入ります。JSON.stringify()を使うと、JavaScriptランタイムでオブジェクトを1行のJSONとして出力できます。出力例の項目名は英語表記ですが、配列の更新後の内容と取り出された値を示しています。
位置を指定して削除するにはsplice(start, deleteCount)を使います。最初の要素を削除する場合は、startに0、deleteCountに1を渡します。元の配列は変更され、削除された要素を含む配列が返されます。たとえば、const values = ["red", "green", "blue"]に対してconst removed = values.splice(0, 1)を実行すると、valuesは["green", "blue"]になり、removedは["red"]になります。
start引数はインデックスを指定するもので、移動する方向を指定するものではありません。0以上のインデックスは先頭から数え、負のインデックスは末尾から逆向きに数えます(-1は最後の要素を指します)。deleteCountはその位置から削除する要素数です。省略すると、splice()はstart以降の要素をすべて削除します。deleteCountの後に要素を渡すと、その位置に挿入されます。引数の詳細はMDNのsplice()リファレンスを参照してください。
元の配列を変更せずに最初の要素を削除する
slice()とfilter()は新しい配列を返し、入力配列は変更しません。先頭の要素より後ろをそのままコピーするならslice(1)を使います。startインデックスの要素は含まれ、任意のendインデックスの要素は含まれません。そのため、values.slice(1)はインデックス1から末尾までをコピーしますが、values自体から要素を削除するわけではありません。詳しくはslice()のガイドとMDNのslice()リファレンスを参照してください。このガイドは英語版のみです。
条件に基づいて削除する要素を決める場合はfilter()を使います。コールバックは各要素に対して実行され、コールバックがtrueを返した要素は新しい配列に含まれます。先頭の位置だけを除外するには、インデックスで絞り込みます。
const remaining = values.filter((item, index) => index > 0);
この方法では、後続の要素の順序を保ったままvaluesを変更せずに済みます。インデックスによる絞り込みは位置に基づくルールです。配列の順序を変更した後でも、値にかかわらずインデックス0の要素が除外されます。
たとえば、const values = ["red", "green", "blue"]の場合、values.slice(1)とvalues.filter((item, index) => index > 0)のどちらも、["green", "blue"]を含む新しい配列を作り、valuesは["red", "green", "blue"]のままです。
配列の用途に合った方法を選ぶ
- 元の配列を変更し、削除した要素を単一の値として受け取りたい場合は
shift()を使います。 - 元の配列を変更し、削除した要素を配列で受け取りたい場合は
splice(0, 1)を使います。別の位置を削除する場合は、インデックスと要素数を調整できます。 - 最初の要素より後ろを含む新しい配列が必要な場合は
slice(1)を使います。 - 残す要素を条件で決める場合は
filter()を使います。先頭の位置を除外するだけなら、インデックス条件で指定できます。
選択のポイントは、ほかのコードで元の配列を引き続き使う必要があるかどうかです。変更を伴うメソッドは共有されている元の配列を更新するため、その配列への参照にも変更が反映されます。変更を伴わないメソッドは元の配列を残し、別の結果を返します。どの方法でも、残された要素の相対的な順序は保たれます。