O método trimStart()
remove espaços do começo de uma string. trimLeft()
é um apelido para este método.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
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
Especificação |
---|
ECMAScript (ECMA-262) The definition of ' String.prototype.trimStart' in that specification. |
Navegadores compatíveis
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.