La méthode padStart()
permet de compléter la chaîne courante avec une chaîne de caractères donnée 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.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
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 quand la langue s'écrit de gauche à droite). 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"
'abc'.padStart(8, "0"); // "00000abc"
'abc'.padStart(1); // "abc"
Spécifications
Spécification | État | Commentaires |
---|---|---|
ECMAScript (ECMA-262) La définition de 'String.prototype.padStart' dans cette spécification. |
Standard évolutif | |
ECMAScript 2017 (ECMA-262) La définition de 'String.prototype.padStart' dans cette spécification. |
Standard | Définition initiale. |
Compatibilité des navigateurs
BCD tables only load in the browser