CKTIS / JavaScript
String.prototype.trimStart() — supprimer les espaces en début de chaîne
trimStart() renvoie un texte dont les espaces et les terminateurs de ligne initiaux définis par ECMAScript ont été supprimés. La chaîne d’origine reste inchangée, tout comme les caractères à l’intérieur du texte et à la fin.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
string.trimStart()String.prototype.trimStart() supprime la plus longue séquence initiale de caractères appartenant aux ensembles WhiteSpace ou LineTerminator d’ECMAScript. Cela inclut notamment les espaces, les tabulations, les retours à la ligne et l’espace insécable U+00A0. Cela ne signifie pas que tous les caractères Unicode invisibles sont supprimés : U+200B ne l’est pas.
L’appel string.trimStart() ne prend aucun paramètre et renvoie une valeur de type chaîne. Les chaînes étant immuables, l’original reste inchangé ; pour utiliser le résultat, il faut le conserver ou le transmettre. Les caractères internes et finaux ne sont pas modifiés. Un texte vide, ou composé uniquement de caractères supprimables, donne "".
Contrairement à trimStart(), trimEnd() ne supprime ces caractères qu’à la fin, tandis que trim() les supprime aux deux extrémités. Il est impossible de fournir un ensemble personnalisé de caractères à supprimer. La méthode est générique : utilisée avec String.prototype.trimStart.call(value), elle convertit un récepteur acceptable en texte ; les récepteurs null et undefined provoquent un TypeError.
La méthode a été introduite dans ECMAScript 2019. trimLeft est un ancien alias de compatibilité ; privilégiez trimStart dans le nouveau code. La spécification du langage n’est pas un tableau de compatibilité des navigateurs : vérifiez la disponibilité dans l’environnement cible avec typeof String.prototype.trimStart === "function". La présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs.
Exemples
const text = "\t\n\u00A0Hello world ";
const result = text.trimStart();
console.log(JSON.stringify(result));
console.log(result.endsWith(" "));
console.log(text.startsWith("\t"));Résultat
"Hello world " true true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.