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

CKTIS / JavaScript

String.prototype.trimEnd() — remover espaços em branco no final

trimEnd() devolve uma string sem espaços em branco nem terminadores de linha no final. Se a string contiver apenas esses caracteres, o resultado é uma string vazia. A string original não é alterada.

Versão: ECMAScript 2019. The main ECMAScript specification defines String.prototype.trimRight as a legacy alias whose initial value is the same function object as String.prototype.trimEnd.

Sintaxe

str.trimEnd()

String.prototype.trimEnd() remove a sequência mais longa de espaços em branco e terminadores de linha no final da string e devolve o resultado como um valor do tipo string. Se a string contiver caracteres que não pertençam a nenhuma dessas duas categorias, tudo até ao último desses caracteres, inclusive, é mantido. As strings são imutáveis: guarda ou passa adiante o valor devolvido para utilizar o resultado. Se a string contiver apenas caracteres que o método pode remover, o resultado é uma string vazia.

O método não aceita parâmetros para indicar que caracteres devem ser removidos. Utiliza os conjuntos WhiteSpace e LineTerminator do ECMAScript, que incluem, entre outros, espaços, tabulações, terminadores de linha e o espaço não separável \u00A0. Não remove caracteres invisíveis arbitrários nem um sufixo especificado. trimStart() atua no início, enquanto trim() atua em ambas as extremidades.

O método é genérico. Quando invocado através de call, lança um TypeError se o recetor for null ou undefined, antes da conversão para string. Aos restantes valores do recetor, aplica a operação ToString, que também lança um TypeError para um valor primitivo do tipo Symbol.

trimEnd() faz parte do ECMAScript 2019, não das Web APIs. A especificação da linguagem não é uma tabela de compatibilidade de navegadores; verifica a disponibilidade no ambiente de destino, por exemplo com typeof String.prototype.trimEnd === "function". O facto de um repositório utilizar Node 24, por si só, não comprova o suporte nos navegadores.

Exemplos

const original = "  Ada Lovelace \t\n";
const result = original.trimEnd();

console.log(JSON.stringify(result));
console.log(result.length);
console.log(original.length);

Resultado

"  Ada Lovelace"
14
17

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