String.prototype.trimStart()

La méthode trimStart() permet de retirer les blancs au début de la chaîne de caractères. trimLeft() est un synonyme pour cette méthode.

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

Spécification État Commentaires
Proposition pour String.prototype.{trimStart,trimEnd} Brouillon de niveau 4 Attendu pour ES2019

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
trimStartChrome Support complet 66
Support complet 66
Support complet 4
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : trimLeft
Edge Support complet 12
Autre nom
Support complet 12
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : trimLeft
Firefox Support complet 61
Support complet 61
Support complet 3.5
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : trimLeft
IE Aucun support NonOpera Support complet 53
Support complet 53
Support complet 15
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : trimLeft
Safari Support complet 12WebView Android Support complet 66
Support complet 66
Support complet ≤37
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : trimLeft
Chrome Android Support complet 66
Support complet 66
Support complet 18
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : trimLeft
Firefox Android Support complet 61
Support complet 61
Support complet 4
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : trimLeft
Opera Android Support complet 47
Support complet 47
Support complet 14
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : trimLeft
Safari iOS Support complet 12Samsung Internet Android Support complet 9.0
Support complet 9.0
Support complet 1.0
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : trimLeft
nodejs Support complet 10.0.0
Support complet 10.0.0
Support complet 0.12
Autre nom
Autre nom Cette fonctionnalité utilise le nom non-standard : trimLeft

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Cette fonctionnalité utilise un nom non-standard.
Cette fonctionnalité utilise un nom non-standard.

Voir aussi