String.prototype.trimStart()

Exemple interactif

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

Syntaxe

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

Valeur de retour

Une nouvelle chaîne de caractères dérivant de la chaîne appelante pour laquelle les blancs en début de chaîne ont été retirés.

Description

La méthode trimStart() renvoie la chaîne de caractères dont les blancs à gauche ont été retirés. trimStart ne modifie pas la chaîne elle-même.

Synonyme

Pour des raisons de cohérences avec les méthodes préexistantes (telles que String.prototype.padStart), le nom standard de cette méthode est trimStart. Toutefois, à des fins de compatibilité web, le nom trimLeft sera gardé comme un synonyme. Pour certains moteurs JavaScript, on pourra donc avoir :

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

Exemple

L'exemple qui suit illustre comment afficher la chaîne de caractères "toto " en minuscules :

var str = "   toto  ";
console.log(str.length); // 8
str = str.trimStart();
console.log(str.length); // 5
console.log(str); // "toto  "

Spécifications

Compatibilité des navigateurs

Voir aussi

• String.prototype.trim()
• String.prototype.trimEnd()