String.prototype.endsWith()

The endsWith() method determines whether a string ends with the characters of another string, returning true or false as appropriate.

Syntax

<var>str</var>.endsWith(<var>searchString</var>[, <var>position</var>])

Parameters

searchString

The characters to be searched for at the end of this string.

position

Optional. Search within this string as if this string were only this long; defaults to this string's actual length, clamped within the range established by this string's length.

Return value

true if the string ends with the characters of the search string; otherwise, false.

Description

This method lets you determine whether or not a string ends with another string. This method is case-sensitive.

Examples

Using 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

This method has been added to the ECMAScript 6 specification and may not be available in all JavaScript implementations yet. However, you can polyfill String.prototype.endsWith() with the following snippet:

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.lastIndexOf(searchString, position);
      return lastIndex !== -1 && lastIndex === position;
  };
}

Specifications

Browser compatibility

See also

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