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

Especificação Status Comentário
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'String.prototype.endsWith' in that specification.
Padrão Definição inicial.
ECMAScript (ECMA-262)
The definition of 'String.prototype.endsWith' in that specification.
Padrão em tempo real
Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
endsWithChrome Full support 41Edge Full support 12Firefox Full support 17IE No support NoOpera Full support 28Safari Full support 9WebView Android Full support ≤37Chrome Android Full support 36Firefox Android Full support 17Opera Android Full support 24Safari iOS Full support 9Samsung Internet Android Full support 3.0nodejs Full support 4.0.0
Full support 4.0.0
Full support 0.12
Disabled
Disabled From version 0.12: this feature is behind the --harmony runtime flag.

Legend

Full support  
Full support
No support  
No support
User must explicitly enable this feature.
User must explicitly enable this feature.

Veja também