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

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 Latest Draft (ECMA-262)
The definition of 'String.prototype.endsWith' in that specification.
Rascunho  

Browser compatibilidade

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
Basic supportChrome Full support 41Edge Full support YesFirefox Full support 17IE No support NoOpera Full support 28Safari Full support 9WebView Android Full support YesChrome Android Full support 36Edge Mobile Full support YesFirefox Android Full support 17Opera Android Full support YesSafari iOS Full support 9Samsung Internet Android Full support Yesnodejs 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

Etiquetas do documento e colaboradores

Etiquetas: 
Colaboradores desta página: houstondapaz, marceloogeda
Última atualização por: houstondapaz,