String.prototype.endsWith()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

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

試してみましょう

構文

js
endsWith(searchString)
endsWith(searchString, endPosition)

引数

searchString

str の末尾で検索される文字の集合です。正規表現にすることはできません。正規表現ではない値はすべて文字列に変換されますので、省略したり undefined を渡したりすると、endsWith()"undefined" という文字列を検索します。これはおそらく望むところではないでしょう。

endPosition 省略可

searchString が見つかると期待される末尾の位置(searchString の最後の文字 +1 のインデックス)です。既定値は str.length です。

返値

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

例外

TypeError

searchString正規表現であった場合。

解説

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

endsWith() の使用

js
const 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

仕様書

Specification
ECMAScript Language Specification
# sec-string.prototype.endswith

ブラウザーの互換性

BCD tables only load in the browser

関連情報