Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

String.prototype.startsWith()

startsWith() メソッドは文字列が別の文字列の文字で始まるか判断し、その結果に応じて truefalse を返します。

構文

str.startsWith(searchString[, position])

引数

searchString
参照文字列の始まりで検索される文字列
position
オプション。searchStringを検索し始める参照文字列の位置。デフォルトでは、0です。

説明

このメソッドによって、文字列が別の文字列で始まるかどうか判断されます。

startsWith()を使う

//startswith
var str = 'To be, or not to be, that is the question.';

console.log(str.startsWith('To be'));         // true
console.log(str.startsWith('not to be'));     // false
console.log(str.startsWith('not to be', 10)); // true

互換性

このメソッドはECMAScript第6版に追加されました。すべてのJavaScriptの実装でまだ利用可能ではないかもしれません。しかしながら、次のコードでString.prototype.startsWith()をエミュレートできます。:

if (!String.prototype.startsWith) {
    String.prototype.startsWith = function(searchString, position){
      position = position || 0;
      return this.substr(position, searchString.length) === searchString;
  };
}

より強力で最適化されているポリフィルを Mathias Bynens が GitHub で公開しています。

仕様

仕様書 策定状況 コメント
ECMAScript 2015 (6th Edition, ECMA-262)
String.prototype.startsWith の定義
標準 最初期の定義
ECMAScript 2017 Draft (ECMA-262)
String.prototype.startsWith の定義
ドラフト  

ブラウザ実装状況

機能 Chrome Firefox (Gecko) Edge Internet Explorer Opera Safari
基本サポート 41 17 (17) (有) 未サポート 28 9
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート 未サポート 36 17.0 (17) 未サポート 未サポート 未サポート

このメソッドの MSDN ドキュメントでは Internet Explorer でサポートしていないと明示していますが、Internet Explorer 8 以降で動作しているように思われることに注意してください。

関連情報

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

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