String.prototype.endsWith()

O método endsWith() indica se uma string termina com determinados caracteres, 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 da string passada. Se omitido, o valor padrão é o tamanho da string.

Valor retornado

true se os caracteres passados forem encontrados no final da string. Do contrário, retorna false.

Descrição

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

Exemplos

Usando endsWith()

var str = 'Ser ou não ser, eis a questão';

console.log(str.endsWith('questão')); // retorna true
console.log(str.endsWith('ser'));     // retorna false
console.log(str.endsWith('ser', 14)); // retorna true

Polyfill

Este método foi adicionada na especificação ECMAScript 6 e talvez não esteja disponível em todos as implementações JavaScript ainda. No entanto, você pode criá-lo adicionando o seguinte código:

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

Navegadores compatíveis

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()