String.prototype.endsWith()

概要

endsWith() メソッドは、対象の文字列が引数に指定された別の文字列を末尾に持つ文字列であるか否かを示す真偽値を返します。

構文

str.endsWith(searchString[, position])

引数

searchString

検索対象とする文字列

position

任意。文字列が指定した長さであるかのように、文字列内の検索を行います。デフォルト値は文字列の実際の長さであり、指定した長さによって決められる範囲に制限します。

説明

このメソッドは、対象の文字列が引数に指定された別の文字列で終わる文字列であるか否かを判定し、その結果を示す真偽値を返します。

例

endsWith() を使う

var 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

Polyfill

以下のスニペットを用いる事で、 String.prototype.endsWith() メソッドが実装されていない環境でもこれをエミュレートできます。

if (!String.prototype.endsWith) {
  String.prototype.endsWith = function(searchString, position) {
      var subjectString = this.toString();
      if (typeof position !== 'number' || !isFinite(position) || Math.floor(position) !== position || position > subjectString.length) {
        position = subjectString.length;
      }
      position -= searchString.length;
      var lastIndex = subjectString.indexOf(searchString, position);
      return lastIndex !== -1 && lastIndex === position;
  };
}

仕様

ブラウザ実装状況

関連情報

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