★ wanayoo — archive 1999 https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/String/includesNouvelle recherche | Portail wanayoo

Account creation on MDN is disabled while we upgrade our moderation mechanisms. If you see something that needs to be fixed, please file a bug: https://bugzilla.mozilla.org/form.doc and we'll handle it as soon as we can. Thanks for your patience!

String.prototype.includes()

この記事は編集レビューを必要としています。

この翻訳は不完全です。英語から この記事を翻訳 してください。

これは 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仕様に一致させるために署名を変更しました。

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: shide55
 最終更新者: shide55,