String includes()

概要

String.prototype.includes() は文字列に指定した部分文字列が含まれるかを真偽値で返します。indexOf !== -1 より可読性が高く、startsWith/endsWith と合わせて直感的な文字列判定が可能です。

対応ブラウザ

基本構文

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() の活用

  文字列に特定の部分文字列が含まれるかを判定するメソッド。startsWith, endsWith も同時に追加された。

注意点

アクセシビリティ

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

参考リンク

• MDN Web Docs — String includes()
• Can I use — String includes()

Powered by web-features