String.endsWith

JavaScript 1.8.6 で導入

概要

対象の文字列が引数に指定された別の文字列を末尾に持つ文字列であるか否かを示す真偽値を返します。

String のメソッド
実装されたバージョン JavaScript 1.8.6
ECMAScript エディション (ECMAScript Harmony)

構文

var endsWithFlug = str.endsWith(searchString [, position]);

引数

searchString
検索対象とする文字列
position
数値。この引数が指定された場合、その位置を末尾として判定します。

説明

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

var str = "To be, or not to be, that is the question.";

alert( str.endsWith("question") );  // true
alert( str.endsWith("to be") );     // false
alert( str.endsWith("to be", 19) ); // 19 文字目を末尾として検索。 true が返る。

Polyfill

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

if (!String.prototype.endsWith) {
    Object.defineProperty(String.prototype, 'endsWith', {
        enumerable: false,
        configurable: false,
        writable: false,
        value: function (searchString, position) {
            position = position || this.length;
            position = position - searchString.length;
            return this.lastIndexOf(searchString) === position;
        }
    });
}

【訳注: このコードは Object.defineProperty が実装済の環境を対象としています。】

関連情報

Document Tags and Contributors

Contributors to this page: ethertank
最終更新者: ethertank,