本文へ移動
プログラミング大全動かして、比べて、理解する。

JavaScript / コードを試す

Array.prototype.includes() と some() / every()

値が入っているかを調べる includes、条件で調べる some と every の違いをまとめます。 NaN が見つかる理由、型が違うと一致しない話、空配列で every が true になる理由まで確かめます。

固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。

元の教材を読む(別タブ)

コードを編集して試す

ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。

playground.js

8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。

パネルを開くと編集できます。

現在の入力は未実行です。

今回の実行結果
JavaScriptUTF-8 · LF

実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。

「入っているか」を調べる方法は3つあります。何で調べたいかで選びます。

example.js

const nums = [1, 2, 3];

console.log(nums.includes(2));
console.log(nums.some(n => n > 2));
console.log(nums.every(n => n > 0));
固定例の期待出力 · Node 24.22.3
true
true
true
表示用コードUTF-8 · LF
何で調べるか 返るもの
includes() 値そのもの 入っていれば true
some() 条件(1つでも) 1つでも合えば true
every() 条件(全部) 全部合えば true

上のコードは書き換えて実行できます。n > 2 を n > 5 にしてみてください。

includes と indexOf の違い

NaN を見つけられるかどうかが違います。

example.js

const nums = [1, NaN, 3];

console.log(nums.includes(NaN));
console.log(nums.indexOf(NaN));
console.log(nums.includes(3), nums.indexOf(3));
固定例の期待出力 · Node 24.22.3
true
-1
true 2
表示用コードUTF-8 · LF

indexOf() は === で比べます。NaN === NaN は false なので見つかりません。 includes() は SameValueZero という比べ方を使うので見つかります。

詳しくは なぜ NaN === NaN は false なのか にあります。

「あるか」を知りたいだけなら includes() を使ってください。 indexOf(x) !== -1 は読みにくく、NaN で間違えます。

型が違うと一致しない

includes() は型変換をしません。

example.js

const nums = [1, 2, 3];

console.log(nums.includes('2'));
console.log(nums.includes(2));
console.log(['1', '2'].includes(1));
固定例の期待出力 · Node 24.22.3
false
true
false
表示用コードUTF-8 · LF

フォームから来た値は文字列です。そのまま渡すと必ず false になります。

example.js

const allowed = [1, 2, 3];
const input = '2';

console.log(allowed.includes(input));
console.log(allowed.includes(Number(input)));
固定例の期待出力 · Node 24.22.3
false
true
表示用コードUTF-8 · LF

変換の注意は 文字列を数値に変換する にあります。

オブジェクトは参照で比べる

中身が同じでも、別々に作ったものは別物です。

javascript失敗・注意の例

const users = [{ id: 1 }];

console.log(users.includes({ id: 1 }));
固定例の期待出力 · Node 24.22.3
false
表示用コードUTF-8 · LF

中身で調べたいなら some() を使ってください。

example.js

const users = [{ id: 1 }, { id: 2 }];

console.log(users.some(u => u.id === 1));
console.log(users.every(u => u.id > 0));
固定例の期待出力 · Node 24.22.3
true
true
表示用コードUTF-8 · LF

見つかったところで止まる

some() は真になった時点、every() は偽になった時点で止まります。

example.js

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);
固定例の期待出力 · Node 24.22.3
some  : 2
every : 2
表示用コードUTF-8 · LF

どちらも5件のうち2件しか見ていません。

includes() も途中で止まりますが、回数は数えられません(関数を渡さないため)。

空配列では every が true になる

ここが引っかかりどころです。

example.js

console.log([].some(n => n > 0));
console.log([].every(n => n > 0));
固定例の期待出力 · Node 24.22.3
false
true
表示用コードUTF-8 · LF

every() は「条件に合わないものが1つも無い」を返します。 要素が0件なら、合わないものも0件です。だから true です。

数学ではこれを空虚な真と呼びます。仕様どおりの正しい動きです。

実務では困ることがあります。「全員が同意したか」を every() で調べると、 誰もいないときに「全員同意」になります。

example.js

const members = [];

console.log(members.every(m => m.agreed));
console.log(members.length > 0 && members.every(m => m.agreed));
固定例の期待出力 · Node 24.22.3
true
false
表示用コードUTF-8 · LF

件数を先に確かめてください。

穴のある配列での違い

includes() は疎な配列の穴を undefined として見ます。 indexOf() は飛ばします。

example.js

const sparse = [1, , 3];

console.log(sparse.includes(undefined));
console.log(sparse.indexOf(undefined));
固定例の期待出力 · Node 24.22.3
true
-1
表示用コードUTF-8 · LF

find() と同じで、includes() は穴を見に行きます。 filter() や map() は飛ばします。揃っていません。

途中から探す

第2引数で開始位置を指定できます。

example.js

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));
固定例の期待出力 · Node 24.22.3
true
true
false
true
表示用コードUTF-8 · LF

負の数は後ろから数えます。-1 は最後の要素からです。

文字列にも includes がある

同じ名前で、部分文字列を調べます。

example.js

const text = 'abcdef';

console.log(text.includes('cd'));
console.log(text.indexOf('cd'));
console.log(text.startsWith('ab'), text.endsWith('ef'));
固定例の期待出力 · Node 24.22.3
true
2
true true
表示用コードUTF-8 · LF

配列の includes() は要素そのもの、文字列の includes() は部分文字列です。 名前は同じでも、調べているものが違います。

example.js

console.log(['abc'].includes('b'));
console.log('abc'.includes('b'));
固定例の期待出力 · Node 24.22.3
false
true
表示用コードUTF-8 · LF

選び方

やりたいこと 使うもの
その値が入っているか includes()
条件に合うものが1つでもあるか some()
全部が条件に合うか every()(空配列に注意)
合うものを取り出したい find()
合うものを全部取り出したい filter()
何番目かを知りたい indexOf() / findIndex()

filter(...).length > 0 と書かないでください。 最後まで数えてしまいます。 some() なら見つかった時点で止まります。

example.js

const nums = [1, 2, 3, 4, 5];

console.log(nums.filter(n => n > 3).length > 0);
console.log(nums.some(n => n > 3));
固定例の期待出力 · Node 24.22.3
true
true
表示用コードUTF-8 · LF

出典

この教材の原文(Markdown・別タブ)