String.prototype.endsWith()

endsWith() メソッドは文字列が引数で指定された文字列で終わるかを判定して truefalse を返します。

構文

str.endsWith(searchString[, length])

引数

searchString
str の末尾で検索される文字の集合です。
length Optional
指定された場合、 str の長さとして使用されます。既定値は str.length です。

返値

文字列が指定された文字列で終わる場合は true、それ以外の場合は false です。

解説

文字列が特定の文字列で終わるかどうかを判断できます。このメソッドでは (英文字の) 大文字・小文字は区別されます。

endsWith() の使用

let str = 'To be, or not to be, that is the question.'

console.log(str.endsWith('question.'))  // true
console.log(str.endsWith('to be'))      // false
console.log(str.endsWith('to be', 19))  // true

ポリフィル

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

if (!String.prototype.endsWith) {
  String.prototype.endsWith = function(search, this_len) {
    if (this_len === undefined || this_len > this.length) {
      this_len = this.length;
    }
    return this.substring(this_len - search.length, this_len) === search;
  };
}

仕様書

ブラウザーの互換性

BCD tables only load in the browser

関連情報