String.prototype.trimStart()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

O método trimStart() remove espaços do começo de uma string. trimLeft() é um apelido para este método.

Experimente

const greeting = " Hello world! "; console.log(greeting); // Expected output: " Hello world! "; console.log(greeting.trimStart()); // Expected output: "Hello world! ";

Sintaxe

str.trimStart(); str.trimLeft();

Valor retornado

Uma nova string representando a string original sem os espaços no começo (fim à esquerda).

Descrição

Os métodos trimStart() / trimLeft() retornam a string sem os espaços no fim à esquerda. trimLeft() ou trimStart() não altera o valor da string original.

Para consistência com funções como String.prototype.padStart o nome padrão do método é trimStart. Entretanto, por razões de compatibilidade na web, trimLeft permanece como um apelido para trimStart. Em alguns motores isso significa:

String.prototype.trimLeft.name === "trimStart";

Polyfill

//https://github.com/FabioVergani/js-Polyfill_String-trimStart (function (w) { var String = w.String, Proto = String.prototype; (function (o, p) { if (p in o ? (o[p] ? false : true) : true) { var r = /^\s+/; o[p] = o.trimLeft || function () { return this.replace(r, ""); }; } })(Proto, "trimStart"); })(window); /* ES6: (w=>{ const String=w.String, Proto=String.prototype; ((o,p)=>{ if(p in o?o[p]?false:true:true){ const r=/^\s+/; o[p]=o.trimLeft||function(){ return this.replace(r,'') } } })(Proto,'trimStart'); })(window); */

Exemplos

Usando `trimStart()`

O seguinte exemplo mostra uma string em caixa baixa 'foo ':

var str = " foo "; console.log(str.length); // retorna 8 str = str.trimStart(); console.log(str.length); // retorna 5 console.log(str); // retorna 'foo '

Especificações

Specification
ECMAScript® 2026 Language Specification # sec-string.prototype.trimstart