String.prototype.endsWith()

O método endsWith() determina se uma string termina com os caracteres da string especificada, retornando true ou false.

Sintaxe

str.endsWith(stringSendoBuscada[, tamanho])

Parâmetros

stringSendoBuscada

Os caracteres a serem pesquisados no final da string.

tamanho

Opcional. Se fornecido substitui o tamanho considerado da string passada. Se omitido, o valor padrão é o tamanho da string.

Valor de Retorno

true se os caracteres passados forem encontrados no final da string; de outra forma, false.

Descrição

Este método permite que você determine se uma string termina ou não com outra string. Este método é case-sensitive.

Exemplos

Usando 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

Este método foi adicionada a especificação ECMAScript 6 e talvez não esteja disponível em todos as implementações JavaScript ainda. No entanto, voccê pode  "polyfill" String.prototype.endsWith() com o seguinte snippet:

if (!String.prototype.endsWith)
  String.prototype.endsWith = function(searchStr, Position) {
      // This works much better than >= because
      // it compensates for NaN:
      if (!(Position < this.length))
        Position = this.length;
      else
        Position |= 0; // round position
      return this.substr(Position - searchStr.length,
                         searchStr.length) === searchStr;
  };

Especificações

Browser compatibilidade

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Veja também

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