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 janeiro de 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.
Aliasing
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 |
Compatibilidade com navegadores
Loading…