String.
Complète une chaîne à droite avec le texte donné jusqu’à ce qu’elle atteigne la longueur indiquée.
- Renvoie
- Une nouvelle chaîne d’au moins
targetLengthcaractères, complétée à droite. - Modifie l’original
- Non
Exemple
#const chapters = [
['Variables', 3],
['Boucles', 7],
['Fonctions', 12]
]
for (const [title, page] of chapters) {
console.log(title.padEnd(12, '.') + page)
}Définition et utilisation
#La méthode padEnd() fonctionne comme padStart(), mais ajoute des caractères à la fin de la chaîne. Elle utilise des espaces par défaut, et si la chaîne a déjà au moins la longueur voulue, elle revient inchangée.
Elle est utile pour aligner du texte en colonnes, par exemple dans un tableau de résultats affiché dans la console, pour créer des lignes de points dans une table des matières, ou pour compléter des champs de largeur fixe dans des formats de fichiers simples.
Le texte de complément est répété et tronqué pour que le résultat ait exactement la longueur voulue. La chaîne d’origine ne change pas.
Syntaxe
#string.padEnd(targetLength)
string.padEnd(targetLength, padString)Paramètres
#targetLength
number
Longueur visée du résultat. Si elle ne dépasse pas la longueur de la chaîne, celle-ci revient inchangée.padString
string, optionnel
Texte ajouté à la fin, répété et tronqué à la longueur nécessaire. Par défaut, une espace.
Plus d’exemples
#const header = 'Élève'.padEnd(8) + 'Points'
const rows = ['Léa'.padEnd(8) + 120, 'Lucas'.padEnd(8) + 95]
console.log([header, ...rows].join('\n'))console.log('Chargement'.padEnd(14, '.-'))
console.log('OK'.padEnd(1, '*'))Compatibilité des navigateurs
#Largement disponible
Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.
- Chrome
- Edge
- Firefox
- Safari
Bonnes pratiques
#- L’alignement par espaces ne fonctionne bien qu’avec une police à chasse fixe, comme dans une console. Sur une page web, utilisez des tableaux HTML ou CSS Grid pour organiser des colonnes.
- Les emoji et certains symboles comptent pour deux unités de longueur, donc les colonnes qui en contiennent peuvent se décaler.
Entrées associées
#- String.prototype.padStart()Complète une chaîne à gauche avec le texte donné jusqu’à ce qu’elle atteigne la longueur indiquée. Idéal pour les zéros initiaux.
- String.prototype.repeat()Renvoie une nouvelle chaîne composée du nombre indiqué de répétitions de l’original.
- String.prototype.lengthLa longueur d’une chaîne, c’est-à-dire le nombre d’unités de code UTF-16. La propriété est en lecture seule.
- Template literalsDes templates de texte entre guillemets inversés : ils insèrent des valeurs via ${} et peuvent s’étendre sur plusieurs lignes.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.