Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.
La méthode padStart()
permet de compléter la chaîne courante avec une chaîne de caractères données afin d'obtenir une chaîne de longueur fixée. Pour atteindre cette longueur, la chaîne complémentaire peut être répétée. La chaîne courante est complétée depuis le début.
Syntaxe
str.padStart(longueurCible [, chaîneComplémentaire])
Paramètres
longueurCible
- La longueur de la chaîne qu'on souhaite obtenir. Si la longueur indiquée est inférieure à celle de la chaîne courante, cette dernière est renvoyée telle quelle.
chaîneComplémentaire
Facultatif- La chaîne de caractères avec laquelle on veut compléter la chaîne courante. Si cette chaîne est trop longue, on prendra uniquement le début (la partie la plus à gauche). La valeur par défaut de ce paramètre est l'espace " " (U+0020). Si cette chaîne est trop courte, elle sera répétée.
Valeur de retour
Une chaîne de caractères (String
) dont la longueur est celle indiquée, complétée avec la chaîne fournie au début de la chaîne courante.
Exemples
'abc'.padStart(10); // " abc" 'abc'.padStart(10, "toto"); // "totototabc" 'abc'.padStart(6,"123465"); // "123abc"
Spécifications
Cette méthode ne fait pas encore partie du standard ECMAScript et est actuellement une proposition pour ECMAScript.
Compatibilité des navigateurs
Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Support simple | ? | 48 (48) | ? | ? | ? |
Fonctionnalité | Android | Chrome pour Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Support simple | ? | ? | 48.0 (48) | ? | ? | ? |