Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

String.prototype.padEnd — compléter la fin d’une chaîne

String.prototype.padEnd complète la fin d’une chaîne jusqu’à une longueur cible en répétant une chaîne fournie ou des espaces par défaut. La chaîne d’origine reste inchangée et une chaîne déjà assez longue n’est jamais raccourcie.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

str.padEnd(maxLength[, fillString])

String.prototype.padEnd renvoie une chaîne complétée à droite jusqu’à la longueur maxLength. Cet argument indique la longueur cible totale du résultat, et non le nombre de caractères à ajouter. La méthode ne modifie pas la chaîne d’origine. Elle fait partie d’ECMAScript depuis l’édition 2017 ; ce n’est pas une API Web. La spécification seule ne permet pas d’établir la prise en charge par un navigateur donné.

Si fillString est omis ou vaut undefined, le remplissage se fait avec une espace U+0020. Sinon, la valeur de remplissage est convertie en chaîne, répétée puis, si nécessaire, tronquée à la fin. Un fillString vide n’ajoute rien. Si maxLength ne dépasse pas la longueur de l’entrée, la méthode renvoie la chaîne inchangée sans convertir fillString.

maxLength subit l’opération ToLength : la partie fractionnaire positive est supprimée, tandis que les valeurs négatives et NaN deviennent zéro. La longueur est mesurée en unités de code UTF-16, et non en caractères visibles ou en colonnes à l’écran. La troncature du remplissage peut séparer une paire de substituts ; cette méthode ne garantit donc pas l’alignement correct de tout texte Unicode.

L’exemple montre la répétition et la troncature du remplissage, les espaces par défaut et deux cas sans remplissage. JSON.stringify rend visibles les limites de la chaîne, ce qui permet de compter les espaces finaux.

Exemples

const label = "ID";
console.log(JSON.stringify(label.padEnd(7, ".-")));
console.log(JSON.stringify(label.padEnd(4)));
console.log(JSON.stringify(label.padEnd(1, "0")));
console.log(JSON.stringify(label.padEnd(7, "")));
console.log(label);

Résultat

"ID.-.-."
"ID  "
"ID"
"ID"
ID

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources