Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

String : méthode padEnd()

Baseline
Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis avril 2017.

La méthode padEnd() des valeurs String remplit cette chaîne de caractères avec une chaîne de caractères donnée (répétée et/ou tronquée, si nécessaire) afin que la chaîne de caractères résultante ait une longueur donnée. Le remplissage est appliqué à partir de la fin de cette chaîne de caractères.

Exemple interactif

const str1 = "Champignons panés";

console.log(str1.padEnd(25, "."));
// Résultat attendu : "Champignons panés........"

const str2 = "200";

console.log(str2.padEnd(5));
// Résultat attendu : "200  "

Syntaxe

js
padEnd(targetLength)
padEnd(targetLength, padString)

Paramètres

targetLength

La longueur de la chaîne de caractères résultante une fois que la chaîne de caractères courante str a été complétée. Si la valeur est inférieure ou égale à str.length, alors str est retournée telle quelle.

padString Facultatif

La chaîne de caractères avec laquelle on veut compléter la chaîne de caractères courante str. Si cette chaîne de caractères est trop longue pour rester dans la limite de targetLength, elle est tronquée à partir de la fin. La valeur par défaut est le caractère espace (U+0020).

Valeur de retour

Une chaîne de caractères (String) de la longueur définie par targetLength avec padString appliquée à la fin.

Exemples

Utiliser la méthode padEnd()

js
"abc".padEnd(10); // "abc       "
"abc".padEnd(10, "toto"); // "abctototot"
"abc".padEnd(6, "123456"); // "abc123"
"abc".padEnd(1); // "abc"

Spécifications

Spécification
ECMAScript® 2027 Language Specification
# sec-string.prototype.padend

Compatibilité des navigateurs

Voir aussi