JavaScript / コードを試す
Array.prototype.includes() と some() / every()
値が入っているかを調べる includes、条件で調べる some と every の違いをまとめます。 NaN が見つかる理由、型が違うと一致しない話、空配列で every が true になる理由まで確かめます。
固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。
コードを編集して試す
ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。
8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。
パネルを開くと編集できます。
現在の入力は未実行です。
入力中のコードをこの例へ置き換えます。
実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。
「入っているか」を調べる方法は3つあります。何で調べたいかで選びます。
const nums = [1, 2, 3]; console.log(nums.includes(2)); console.log(nums.some(n => n > 2)); console.log(nums.every(n => n > 0));
true true true
| 何で調べるか | 返るもの | |
|---|---|---|
includes() |
値そのもの | 入っていれば true |
some() |
条件(1つでも) | 1つでも合えば true |
every() |
条件(全部) | 全部合えば true |
上のコードは書き換えて実行できます。n > 2 を n > 5 にしてみてください。
includes と indexOf の違い
NaN を見つけられるかどうかが違います。
const nums = [1, NaN, 3]; console.log(nums.includes(NaN)); console.log(nums.indexOf(NaN)); console.log(nums.includes(3), nums.indexOf(3));
true -1 true 2
indexOf() は === で比べます。NaN === NaN は false なので見つかりません。
includes() は SameValueZero という比べ方を使うので見つかります。
詳しくは なぜ NaN === NaN は false なのか にあります。
「あるか」を知りたいだけなら includes() を使ってください。
indexOf(x) !== -1 は読みにくく、NaN で間違えます。
型が違うと一致しない
includes() は型変換をしません。
const nums = [1, 2, 3]; console.log(nums.includes('2')); console.log(nums.includes(2)); console.log(['1', '2'].includes(1));
false true false
フォームから来た値は文字列です。そのまま渡すと必ず false になります。
const allowed = [1, 2, 3]; const input = '2'; console.log(allowed.includes(input)); console.log(allowed.includes(Number(input)));
false true
変換の注意は 文字列を数値に変換する にあります。
オブジェクトは参照で比べる
中身が同じでも、別々に作ったものは別物です。
const users = [{ id: 1 }];
console.log(users.includes({ id: 1 }));false
中身で調べたいなら some() を使ってください。
const users = [{ id: 1 }, { id: 2 }]; console.log(users.some(u => u.id === 1)); console.log(users.every(u => u.id > 0));
true true
見つかったところで止まる
some() は真になった時点、every() は偽になった時点で止まります。
const nums = [1, 2, 3, 4, 5]; let calls = 0; nums.some((n) => { calls++; return n === 2; }); console.log('some :', calls); calls = 0; nums.every((n) => { calls++; return n < 2; }); console.log('every :', calls);
some : 2 every : 2
どちらも5件のうち2件しか見ていません。
includes() も途中で止まりますが、回数は数えられません(関数を渡さないため)。
空配列では every が true になる
ここが引っかかりどころです。
console.log([].some(n => n > 0)); console.log([].every(n => n > 0));
false true
every() は「条件に合わないものが1つも無い」を返します。
要素が0件なら、合わないものも0件です。だから true です。
数学ではこれを空虚な真と呼びます。仕様どおりの正しい動きです。
実務では困ることがあります。「全員が同意したか」を every() で調べると、
誰もいないときに「全員同意」になります。
const members = []; console.log(members.every(m => m.agreed)); console.log(members.length > 0 && members.every(m => m.agreed));
true false
件数を先に確かめてください。
穴のある配列での違い
includes() は疎な配列の穴を undefined として見ます。
indexOf() は飛ばします。
const sparse = [1, , 3]; console.log(sparse.includes(undefined)); console.log(sparse.indexOf(undefined));
true -1
find() と同じで、includes() は穴を見に行きます。
filter() や map() は飛ばします。揃っていません。
途中から探す
第2引数で開始位置を指定できます。
const nums = [1, 2, 3, 2]; console.log(nums.includes(2)); console.log(nums.includes(2, 2)); console.log(nums.includes(1, 1)); console.log(nums.includes(2, -1));
true true false true
負の数は後ろから数えます。-1 は最後の要素からです。
文字列にも includes がある
同じ名前で、部分文字列を調べます。
const text = 'abcdef'; console.log(text.includes('cd')); console.log(text.indexOf('cd')); console.log(text.startsWith('ab'), text.endsWith('ef'));
true 2 true true
配列の includes() は要素そのもの、文字列の includes() は部分文字列です。
名前は同じでも、調べているものが違います。
console.log(['abc'].includes('b')); console.log('abc'.includes('b'));
false true
選び方
| やりたいこと | 使うもの |
|---|---|
| その値が入っているか | includes() |
| 条件に合うものが1つでもあるか | some() |
| 全部が条件に合うか | every()(空配列に注意) |
| 合うものを取り出したい | find() |
| 合うものを全部取り出したい | filter() |
| 何番目かを知りたい | indexOf() / findIndex() |
filter(...).length > 0 と書かないでください。 最後まで数えてしまいます。
some() なら見つかった時点で止まります。
const nums = [1, 2, 3, 4, 5]; console.log(nums.filter(n => n > 3).length > 0); console.log(nums.some(n => n > 3));
true true