変数と型が分かっても、まだ何も作れません。足りないのは「複数を扱う書き方」です。
前の回で、値を1つ入れる箱(変数)と、その値の種類(型)を見ました。ただ、実際の画面はたいてい「1件」ではなく「一覧」を扱います。タスクが5件、商品が20件、ログが1000行。これを1つずつ変数に入れることはできません。
この記事では、複数の値をまとめて持つ2つの入れ物(配列とオブジェクト)と、それを1件ずつ処理する繰り返しを、ブラウザの開発者ツールで打ちながら覚えます。次の回で DOM を触るときには、「配列を回して画面に並べる」が当たり前の作業になります。ここを飛ばすと、そこで必ず止まります。
対象レベル: 初級 / 区分: 必修
この記事でわかること
- 配列は「順番のある入れ物」、オブジェクトは「名前を付けた入れ物」という使い分け
- 要素を数える
lengthと、最後の要素の番号がlength - 1になる理由 forとforEachとmapの違い。どれを使うかは「結果が要るか」で決まるmapとfilterが元の配列を変えないこと、pushは変えてしまうこと- 存在しないキーを読むと
undefinedになり、その先を読むとエラーで止まること
この記事でやること
- ブラウザの開発者ツールを開いて、そこで打つ
- 配列を作って、足す・数える・取り出す
- オブジェクトを作って、名前で取り出す
- オブジェクトの配列(実務でいちばん多い形)を作る
forEach/map/filterを打ち分けて、結果の違いを目で見る- わざと
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 undefined | undefined の中を読もうとした |
(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 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。

コメント