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

CKTIS / JavaScript

String.prototype.trimStart() — remover espaços em branco iniciais

trimStart() devolve um texto sem os espaços em branco iniciais e os terminadores de linha definidos pelo ECMAScript. Não altera a cadeia original e preserva os caracteres no interior do texto e no final.

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

string.trimStart()

String.prototype.trimStart() remove a sequência inicial mais longa de caracteres pertencentes aos conjuntos WhiteSpace ou LineTerminator do ECMAScript. Inclui, entre outros, espaços, tabulações, mudanças de linha e o espaço não separável U+00A0. Isto não significa que todos os caracteres Unicode invisíveis sejam removidos: U+200B não é removido.

A chamada string.trimStart() não recebe parâmetros e devolve um valor do tipo cadeia de caracteres. As cadeias são imutáveis, pelo que a original permanece inalterada; para utilizar o resultado, é necessário guardá-lo ou passá-lo adiante. Os caracteres interiores e finais permanecem intactos. Um texto vazio, ou composto apenas por caracteres removíveis, produz "".

Ao contrário de trimStart(), trimEnd() remove estes caracteres apenas do final, enquanto trim() os remove de ambos os lados. Não é possível indicar um conjunto personalizado de caracteres a remover. O método é genérico: quando utilizado através de String.prototype.trimStart.call(value), converte um recetor válido em texto; os recetores null e undefined causam um TypeError.

O método foi introduzido no ECMAScript 2019. trimLeft é um alias antigo de compatibilidade; em código novo, prefira trimStart. A especificação da linguagem não é uma tabela de compatibilidade dos navegadores: verifique a disponibilidade no ambiente de destino com typeof String.prototype.trimStart === "function". A presença do Node 24 num repositório não comprova o suporte nos navegadores.

Exemplos

const text = "\t\n\u00A0Hello  world  ";
const result = text.trimStart();
console.log(JSON.stringify(result));
console.log(result.endsWith("  "));
console.log(text.startsWith("\t"));

Resultado

"Hello  world  "
true
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