String.prototype.startsWith()

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

構文

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第６版に追加されました。すべての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 で公開しています。

仕様

ブラウザ実装状況

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

関連情報

• String.prototype.endsWith()
• String.prototype.includes()
• String.prototype.indexOf()
• String.prototype.lastIndexOf()