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

CKTIS / JavaScript

String.prototype.trim() — remover espaços das duas extremidades

trim() devolve um texto sem espaços nem terminadores de linha no início e no fim. A cadeia original e os espaços internos permanecem inalterados. O método não aceita um argumento para indicar que caracteres deve remover.

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

text.trim()

String.prototype.trim() remove das duas extremidades de uma cadeia os caracteres pertencentes aos conjuntos WhiteSpace e LineTerminator definidos pelo ECMAScript. Devolve uma cadeia sem alterar a original. Se toda a entrada for composta por esses caracteres, o resultado é a cadeia vazia "".

Entre os caracteres removidos estão os espaços normais, as tabulações, os terminadores de linha e o espaço não separável U+00A0. Isto não significa que todos os caracteres invisíveis sejam removidos: o espaço de largura zero U+200B permanece. Os caracteres no interior do texto também não são alterados.

Chama o método assim: text.trim(). Não existe um parâmetro para selecionar caracteres, pelo que trim("x") não remove a letra x. Atribui o resultado a uma variável se precisares de o guardar. O método é genérico: String.prototype.trim.call(123) devolve "123", mas passar null ou undefined como this provoca um TypeError.

Este é um método da biblioteca padrão do ECMAScript, não uma Web API. A especificação da linguagem não é uma tabela de compatibilidade dos browsers; a presença de Node.js num projeto não comprova o suporte no browser de destino.

Exemplos

const text = "\t  Ada  Lovelace \n";
const trimmed = text.trim();
console.log(JSON.stringify(trimmed));
console.log(text === "\t  Ada  Lovelace \n");
console.log(JSON.stringify(" \t\n".trim()));

Resultado

"Ada  Lovelace"
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