JavaScriptの配列とオブジェクト — forEach・map・filterの使い分け

JavaScriptの配列とオブジェクト。角かっこで囲むデータと、波かっこのカード。

変数と型が分かっても、まだ何も作れません。足りないのは「複数を扱う書き方」です。

前の回で、値を1つ入れる箱(変数)と、その値の種類(型)を見ました。ただ、実際の画面はたいてい「1件」ではなく「一覧」を扱います。タスクが5件、商品が20件、ログが1000行。これを1つずつ変数に入れることはできません。

この記事では、複数の値をまとめて持つ2つの入れ物(配列とオブジェクト)と、それを1件ずつ処理する繰り返しを、ブラウザの開発者ツールで打ちながら覚えます。次の回で DOM を触るときには、「配列を回して画面に並べる」が当たり前の作業になります。ここを飛ばすと、そこで必ず止まります。

対象レベル: 初級 / 区分: 必修

目次

この記事でわかること

  • 配列は「順番のある入れ物」、オブジェクトは「名前を付けた入れ物」という使い分け
  • 要素を数える length と、最後の要素の番号が length - 1 になる理由
  • for と forEach と map の違い。どれを使うかは「結果が要るか」で決まる
  • map と filter が元の配列を変えないこと、push は変えてしまうこと
  • 存在しないキーを読むと undefined になり、その先を読むとエラーで止まること

この記事でやること

  1. ブラウザの開発者ツールを開いて、そこで打つ
  2. 配列を作って、足す・数える・取り出す
  3. オブジェクトを作って、名前で取り出す
  4. オブジェクトの配列(実務でいちばん多い形)を作る
  5. forEach / map / filter を打ち分けて、結果の違いを目で見る
  6. わざと undefined のエラーを出して、読み方を覚える

先に知る言葉

この記事で初めて出てくる言葉です。 詳しくは用語集にもまとめてあります。

言葉意味
配列順番のある入れ物。 角かっこで書き、番号で取り出す
オブジェクト名前を付けた入れ物。 波かっこで書き、名前で取り出す
キー / 値オブジェクトの名前の側がキー、中身が値
undefined「その名前のものが無い」ときに返る値。エラーではない
アロー関数(x) => ... という短い関数の書き方

前提と作業場所

ブラウザだけで進みます。 VM も Node.js も要りません。前の回で使った開発者ツールを使います。

ブラウザで F12 を押し、Console のタブを開いてください。> の右に打ち込めます。1行打つたびに Enter を押すと、その場で結果が返ります。 ファイルを作る必要はありません。

打ち間違えても壊れません。ページを再読み込みすれば、打ったものは全部消えます。

配列 — 順番のある入れ物

角かっこで囲むと配列になります。

const tasks = ["買い物", "掃除", "返信"];
tasks
(3) ['買い物', '掃除', '返信']

取り出すときは番号を使います。番号は 0 から始まります。

tasks[0]
tasks[2]
tasks[3]
'買い物'
'返信'
undefined

3番目を取ろうとして tasks[3] と書くのが、最初の定番の間違いです。 3件しかない配列の番号は 0・1・2 で、3 は存在しません。エラーにはならず undefined が返ります。エラーが出ないので気づきにくいのが厄介なところです。

件数は length で分かります。

tasks.length
3

件数が3で、最後の番号が2。だから最後の要素はいつも 配列[配列.length - 1] です。

tasks[tasks.length - 1]
'返信'

足す・消す

tasks.push("洗濯");
tasks
(4) ['買い物', '掃除', '返信', '洗濯']

const で宣言したのに中身を変えられました。 ここは混乱しやすいところです。const が固定しているのは「この名前がどの入れ物を指すか」だけで、入れ物の中身は変えられます。別の配列を代入し直すことだけができません。

tasks = ["別の配列"];
Uncaught TypeError: Assignment to constant variable.

末尾を取り除くのは pop です。

tasks.pop();
tasks.length
3

オブジェクト — 名前を付けた入れ物

配列は「順番」で取り出しました。順番に意味がないときは、名前で取り出すほうが安全です。

波かっこで囲むとオブジェクトになります。

const user = { name: "さとう", age: 28, admin: false };
user.name
user.age
'さとう'
28

name や age の部分をキー、その右を値と呼びます。

もしこれを配列で持っていたら、こう書くことになります。

const user2 = ["さとう", 28, false];
user2[1]

user2[1] が何なのか、この行だけ見ても分かりません。 user.age なら読めます。「1番目」に意味がないなら、オブジェクトを使ってください。

無いキーを読むとどうなるか

user.email
undefined

ここもエラーになりません。問題はその先を読んだときです。

user.email.length
Uncaught TypeError: Cannot read properties of undefined (reading 'length')

このエラーは、次の回で必ず出会います。 読み方はこうです。

エラーの部分意味
Cannot read properties of undefinedundefined の中を読もうとした
(reading 'length')読もうとしたのは length

犯人は length ではありません。 その左にある user.email が undefined だったことが原因です。エラーは「読めなかった側」を報告し、「なぜ空だったか」は言いません。 だから . の左を疑ってください。

オブジェクトの配列 — 実務でいちばん多い形

ここまでの2つを組み合わせます。API から返ってくるデータは、たいていこの形です。

const todos = [
  { id: 1, title: "買い物", done: false },
  { id: 2, title: "掃除",   done: true  },
  { id: 3, title: "返信",   done: false }
];
todos.length
todos[1].title
3
'掃除'

「番号で1件を選び、名前で中身を取る」という2段階です。ここが読めれば、次の回で画面に並べられます。

繰り返し — 1件ずつ処理する

forEach — 1件ずつ何かする

todos.forEach(function (todo) {
  console.log(todo.title);
});
買い物
掃除
返信

短く書けます。

todos.forEach((todo) => console.log(todo.title));

=> はアロー関数と呼ばれる書き方で、上と同じ意味です。実際のコードではこちらをよく見ます。

forEach は結果を返しません。 確かめます。

const r = todos.forEach((todo) => todo.title);
r
undefined

「1件ずつ何かするだけ」のときに使うもので、新しい配列が欲しいときには使えません。

map — 1件ずつ変換して、新しい配列を作る

const titles = todos.map((todo) => todo.title);
titles
(3) ['買い物', '掃除', '返信']

元の todos は変わっていません。 確かめます。

todos.length
todos[0].title
3
'買い物'

map は元を残したまま、別の配列を作ります。これが push との決定的な違いです。元を壊さないので、間違えてもやり直せます。

filter — 条件に合うものだけ残す

const remaining = todos.filter((todo) => todo.done === false);
remaining.length
remaining[0].title
2
'買い物'

filter も元を変えません。中に書くのは「残したいなら true になる条件」です。

繋げて書けます。これが実務でいちばん見る形です。

todos.filter((t) => !t.done).map((t) => t.title);
(2) ['買い物', '返信']

!t.done は「done が false なら true」という書き方です。「終わっていないものだけ選んで、タイトルだけ取り出す」と読めます。

for — 番号を自分で回す

for (let i = 0; i < todos.length; i++) {
  console.log(i, todos[i].title);
}
0 '買い物'
1 '掃除'
2 '返信'

番号そのものが要るときだけ、これを使います。 i <= todos.length と書くと1回多く回り、最後で undefined の中を読んでエラーになります。ここも「番号は 0 から」の話です。

使い分け

やりたいこと使うもの返り値
1件ずつ表示する・送るなどforEach無し(undefined)
同じ件数の別の配列が欲しいmap新しい配列
件数を減らしたいfilter新しい配列
番号そのものを使いたいfor無し

迷ったら「結果の配列が要るか」で決めてください。 要らないなら forEach、要るなら map か filter です。

わざと間違えて、エラーを見ておく

次の回で確実に出会うものを、いま出しておきます。

const found = todos.filter((t) => t.id === 99);
found.length
found[0].title
0
Uncaught TypeError: Cannot read properties of undefined (reading 'title')

filter は「見つからなければ空の配列」を返します。 null でも undefined でもありません。空の配列の [0] が undefined で、その中の title を読もうとして止まりました。

だから、取り出す前に件数を見ます。

if (found.length > 0) {
  console.log(found[0].title);
} else {
  console.log("見つかりませんでした");
}
見つかりませんでした

「無いかもしれない」を先に書くのが、この型の対処です。

つまずいたところ

map の中で return を書き忘れました。 波かっこを使う書き方にしたときに起きます。

todos.map((t) => { t.title });
(3) [undefined, undefined, undefined]

波かっこを付けたら return が要ります。 付けないときは書いた式がそのまま返ります。エラーは出ず、undefined が並ぶだけなので気づきにくい失敗です。

forEach の結果を変数に入れて、次の行で使おうとしました。 ずっと undefined で、原因が分からず30分ほど溶かしました。forEach は返さないと覚えるまで、何度か繰り返しました。

push で元の配列を壊しました。 表示用に加工したつもりが、元のデータに追記していて、画面を操作するたびに件数が増え続けました。加工は map か filter、追加だけ push と決めてからは起きていません。

後片づけ

片づけるものはありません。 開発者ツールで打ったものは、ページを再読み込みすれば全部消えます。ファイルも作っていません。

Console をきれいにしたいときは、こう打ってください。

clear()

まとめ

  • 順番に意味があるなら配列、名前で呼びたいならオブジェクト。 実務では「オブジェクトの配列」が最も多い
  • 番号は 0 から。 最後は length - 1。範囲外はエラーではなく undefined
  • 結果の配列が要るなら map か filter、要らないなら forEach
  • map と filter は元を変えない。push は変える
  • Cannot read properties of undefined は、読めなかったものではなく、その左が空だったという意味

参考リンク

次に読む

この記事は 【第3段階】プログラミング の 2 / 7 本目です。

記事
← 前の記事“1” と 1 は等しい — JavaScriptの基本と最初の落とし穴
→ 次の記事Cannot read properties of null の正体 — DOM操作

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次