String includes()
includes() は String 値のメソッドで、大文字と小文字を区別して検索を行い、指定された文字列がこの文字列内で見つかるかどうかを判断し、必要に応じて true または false を返します。
対応ブラウザ
| 機能 | デスクトップ | モバイル | ||||
|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Safari | Chrome Android | Safari iOS | |
| 41 | 12 | 40 | 9 | 41 | 9 | |
注釈 2件
削除済み
- このバージョンで機能が削除されました (48)
対応条件
- 以前は別名で対応していました: contains (18)
基本構文
JAVASCRIPT
const url = 'https://example.com/api/users';
url.includes('api'); // true
url.startsWith('https'); // true
url.endsWith('/users'); // true
// Specifying the search start position
'hello world'.includes('world', 6); // trueライブデモ
実務での使いどころ
-
String includes() の活用
includes() は String 値のメソッドで、大文字と小文字を区別して検索を行い、指定された文字列がこの文字列内で見つかるかどうかを判断し、必要に応じて true または false を返します。
注意点
- 特になし。すべての主要ブラウザで安定して動作する。
アクセシビリティ
- JavaScript による動的更新時は、aria-live リージョンで変更をスクリーンリーダーに通知する。