String.
Supprime les espaces blancs uniquement au début de la chaîne. La fin du texte reste inchangée.
- Renvoie
- Une nouvelle chaîne sans espaces blancs au début.
- Modifie l’original
- Non
Exemple
#const command = ' /aide '
console.log(`[${command.trimStart()}]`)
console.log(`[${command.trim()}]`)Définition et utilisation
#La méthode trimStart() renvoie une nouvelle chaîne sans espaces, tabulations, retours à la ligne ni autres espaces blancs au début. Les espaces à la fin et au milieu du texte restent intacts, et la chaîne d’origine n’est pas modifiée.
Elle est utile quand seul le côté gauche du texte compte : pour lire une commande saisie dans un chat avec un espace resté par erreur au début, pour retirer l’indentation d’une ligne de code, ou pour mesurer la profondeur d’indentation d’une ligne donnée.
Dans du code plus ancien, vous rencontrerez le nom trimLeft(). C’est la même fonction sous son ancien nom, conservée pour la compatibilité. Dans du code neuf, utilisez trimStart() : « début » reste le terme correct même pour les langues écrites de droite à gauche, où le texte commence du côté droit.
Syntaxe
#string.trimStart()Plus d’exemples
#const lines = ['function start() {', ' const level = 1', ' return level', '}']
for (const line of lines) {
const indent = line.length - line.trimStart().length
console.log(indent, line.trimStart())
}const input = '\n\t Réponse : 42'
console.log(input.trimStart())
console.log(input.length, input.trimStart().length)console.log(String.prototype.trimLeft === String.prototype.trimStart)
console.log(' code'.trimLeft())Compatibilité des navigateurs
#Largement disponible
Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.
- Chrome
- Edge
- Firefox
- Safari
Bonnes pratiques
#- Pour nettoyer des données de formulaire,
trim()est en général préférable. ChoisisseztrimStart()quand les espaces finaux comptent, ou quand vous les conservez volontairement. - La différence
line.length - line.trimStart().lengthdonne le nombre de caractères d’indentation. Elle est utile pour analyser du code, des listes à puces et des fichiers de configuration.
Entrées associées
#- String.prototype.trim()Supprime les espaces blancs aux deux extrémités de la chaîne : espaces, tabulations et retours à la ligne.
- String.prototype.trimEnd()Supprime les espaces blancs uniquement à la fin de la chaîne, y compris les retours à la ligne finaux.
- String.prototype.padStart()Complète une chaîne à gauche avec le texte donné jusqu’à ce qu’elle atteigne la longueur indiquée. Idéal pour les zéros initiaux.
- String.prototype.startsWith()Vérifie si une chaîne commence par le texte donné. Renvoie true ou false.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.