Array includes()
includes() は Array インスタンスのメソッドで、特定の要素が配列に含まれているかどうかを true または false で返します。
対応ブラウザ
| 機能 | デスクトップ | モバイル | ||||
|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Safari | Chrome Android | Safari iOS | |
| 47 | 14 | 43 | 9 | 47 | 9 | |
| includes() は TypedArray インスタンスのメソッドで、型付き配列の項目内に特定の値が含まれているかどうかを判断し、その結果に応じて true か false を返します。このメソッドは Array.prototype.includes() と同じアルゴリズムです。 | 47 | 14 | 43 | 10 | 47 | 10 |
基本構文
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ライブデモ
実務での使いどころ
-
Array includes() の活用
includes() は Array インスタンスのメソッドで、特定の要素が配列に含まれているかどうかを true または false で返します。
注意点
- 特になし。すべての主要ブラウザで安定して動作する。
アクセシビリティ
- JavaScript による動的更新時は、aria-live リージョンで変更をスクリーンリーダーに通知する。