この記事は編集レビューを必要としています。
この翻訳は不完全です。英語から この記事を翻訳 してください。
これは Harmony(ECMAScript 6) 提案の一部であり、実験段階の技術です。
この技術の仕様は安定していません。ブラウザ互換性の一覧表を確認してください。またこれらの構文や動作は、仕様変更などにより、新しいバージョンのブラウザでは変更される可能性があるという点に注意してください。
概要
1つの文字列を別の文字列の中に見出すことができるかどうかを判断し、必要に応じてtrue か falseを返します。
構文
str.includes(searchString[, position])
引数
searchString- このString内で検索される文字列。
position- 任意。
searchStringを検索し始めるこのString内の位置。デフォルトは0です。
説明
このメソッドによってある文字列内に別の文字列を含んでいるかどうか判断できます。
大文字小文字の区別
includes() メソッドは大文字と小文字が区別されます。例えば、次のコードではfalseを返します。:
'Blue Whale'.includes('blue'); // returns false
例
例: includes()を使う
var str = 'To be, or not to be, that is the question.';
console.log(str.includes('To be')); // true
console.log(str.includes('question')); // true
console.log(str.includes('nonexistent')); // false
console.log(str.includes('To be', 1)); // false
console.log(str.includes('TO BE')); // false
互換性
このメソッドはECMAScript第6版に追加されました。まだすべてのJavaScriptの実装で利用可能ではないかもしれません。しかしながら、このメソッドを簡単にエミュレートできます。:
if (!String.prototype.includes) {
String.prototype.includes = function() {'use strict';
return String.prototype.indexOf.apply(this, arguments) !== -1;
};
}
仕様
| 仕様 | 状況 | コメント |
|---|---|---|
| ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'String.prototype.includes' in that specification. |
Standard | Initial definition. |
ブラウザ実装状況
| 機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| 基本サポート | 41 | 40 (40) | 未サポート | 未サポート | 未サポート |
| 機能 | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| 基本サポート | 未サポート | 未サポート | 40.0 (40) | 未サポート | 未サポート | 未サポート |
String.prototype.contains
Firefox 18 - 39では、このメソッドの名称は"contains"でした。バグ 1102219で"includes"に名称が変更されました。理由は次のとおりです。:
MooTools 1.2を使用したいくつかのWebサイトはFirefox 17で壊れたと報告がありました。MooToolsのこのバージョンでは、String.prototype.contains() が存在するかどうか調べ、存在しない場合は追加します。Firefox 17でこの関数を紹介して、そのチェックの動作が壊れるMooToolsのString.prototype.contains()の実装に基づいたコードの原因となる方法で変更されました。結果として、この変更はFirefox 17で無効になりました。String.prototype.contains()はFirefox 18以降で利用可能となりました。
MooTools 1.3ではString.prototype.contains()の自身のバージョンに強要しました。だから、応答するWebサイトは壊れませんでした。しかしながら、このメソッドに対するMooTools 1.3 署名 と ECMAScript 6 署名では(第2引数に)違いがあることに注意して下さい。MooTools 1.5+ はES6仕様に一致させるために署名を変更しました。