Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

String.prototype.endsWith — verificar o final de uma cadeia

String.prototype.endsWith verifica se uma cadeia termina com o texto indicado e devolve true ou false. Distingue maiúsculas de minúsculas, não altera a cadeia e permite definir um limite final anterior para a verificação.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

str.endsWith(searchString[, endPosition])

String.prototype.endsWith compara searchString com o final de uma cadeia e devolve true ou false sem alterar o original. A comparação distingue maiúsculas de minúsculas e opera em unidades de código UTF-16, sem normalização Unicode. É um método da biblioteca padrão ECMAScript, não uma API do browser.

O parâmetro opcional endPosition define um limite final exclusivo: o método verifica o final do prefixo até esse limite, não uma subcadeia que começa nesse ponto. Se o argumento for omitido ou for passado undefined, é usado o comprimento total. Após a conversão para um número inteiro, o valor é limitado ao intervalo entre 0 e o comprimento da cadeia; os valores negativos não contam para trás a partir do final. As posições são medidas em unidades de código UTF-16.

Se searchString estiver vazio, o método devolve true, mesmo no limite 0, desde que a conversão de endPosition, quando necessária, seja bem-sucedida. A conversão ocorre antes da comparação: passar 0n como valor de endPosition causa um TypeError mesmo que searchString esteja vazio. O argumento searchString é convertido numa cadeia; por isso, se for omitido, é usado o texto "undefined". Um argumento reconhecido como expressão regular causa um TypeError. Chamar o método com null ou undefined como valor de this também causa um TypeError.

No exemplo, o limite 10 fica imediatamente depois de report.txt, pelo que verificar .txt devolve true, apesar de a cadeia completa terminar em .bak. Verificar .BAK devolve false porque as maiúsculas e minúsculas são diferentes.

Exemplos

const filename = "report.txt.bak";
console.log(filename.endsWith(".bak"));
console.log(filename.endsWith(".txt", 10));
console.log(filename.endsWith(".BAK"));
console.log(filename.endsWith("", 0));

Resultado

true
true
false
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes