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

構文

str.startsWith(searchString[, position])

引数

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

戻り値

文字列が検索文字列の文字で始まる場合はtrue、それ以外の場合はfalse

説明

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

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 Latest Draft (ECMA-262)
String.prototype.startsWith の定義
ドラフト  

ブラウザ実装状況

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

機能 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 以降で動作しているように思われることに注意してください。

関連情報

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

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