Widely available すべての主要ブラウザで対応済み。安心して使用可能。
配列 Widely available

Array includes()

Array.prototype.includes() は配列に指定した値が含まれるかを真偽値で返します。NaN の判定も正しく行えます。

配列ES2016

概要

Array.prototype.includes() は配列に指定した値が含まれるかを真偽値で返します。NaN の判定も正しく行えます。

対応ブラウザ

機能 デスクトップ モバイル
Chrome
Edge
Firefox
Safari
Chrome Android
Safari iOS
javascript.builtins.Array.includes
47
14
43
9
47
9
ビルトインオブジェクト
TypedArray.includes

includes() は TypedArray インスタンスのメソッドで、型付き配列の項目内に特定の値が含まれているかどうかを判断し、その結果に応じて true か false を返します。このメソッドは Array.prototype.includes() と同じアルゴリズムです。
47
14
43
10
47
10
1+対応 (バージョン) 未対応 ※注釈あり サブ機能の解説は MDN Web Docs (CC BY-SA 2.5)

基本構文

JAVASCRIPT 
const fruits = ['apple', 'banana', 'cherry'];

fruits.includes('banana'); // true
fruits.includes('grape');  // false

// Checking for NaN (impossible with indexOf)
[1, 2, NaN].includes(NaN); // true
[1, 2, NaN].indexOf(NaN);  // -1

ライブデモ

specificelement. Presenceconfirm

Array to specifiedvalue that include or check..

プレビュー全画面表示

SearchStartposition. specified

2argument in search Startindex specified in..

プレビュー全画面表示

NaN Check

is check in NaN. includecombine also positivecheck in.. with indexOf

プレビュー全画面表示

実務での使いどころ

  • Array includes() の活用

    配列に特定の要素が含まれるかを判定するメソッド。indexOf !== -1 より可読性が高い。

注意点

  • 特になし。すべての主要ブラウザで安定して動作する。

アクセシビリティ

  • JavaScript による動的更新時は、aria-live リージョンで変更をスクリーンリーダーに通知する。

参考リンク

Powered by web-features