CKTIS / JavaScript
String.prototype.padEnd — riempire la fine di una stringa
String.prototype.padEnd riempie la fine di una stringa fino a una lunghezza obiettivo, ripetendo una stringa fornita oppure usando spazi predefiniti. Non modifica la stringa originale e non accorcia quelle già abbastanza lunghe.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
str.padEnd(maxLength[, fillString])String.prototype.padEnd restituisce una stringa riempita a destra fino alla lunghezza maxLength. Questo argomento specifica la lunghezza totale obiettivo del risultato, non il numero di caratteri da aggiungere. Il metodo non modifica la stringa originale. Fa parte di ECMAScript dall’edizione del 2017; non è una Web API. La specifica, da sola, non stabilisce il supporto in uno specifico browser.
Se fillString viene omesso o vale undefined, il riempimento usa uno spazio U+0020. Altrimenti il valore di riempimento viene convertito in stringa, ripetuto e, se necessario, troncato alla fine. Un fillString vuoto non aggiunge nulla. Se maxLength non supera la lunghezza dell’input, il metodo restituisce la stringa invariata senza convertire fillString.
A maxLength viene applicata l’operazione ToLength: la parte frazionaria positiva viene eliminata, mentre i valori negativi e NaN diventano zero. La lunghezza è misurata in unità di codice UTF-16, non in caratteri visibili o colonne dello schermo. Il troncamento del riempimento può dividere una coppia di surrogati; perciò questo metodo non garantisce il corretto allineamento di testo Unicode arbitrario.
L’esempio mostra la ripetizione e il troncamento del riempimento, gli spazi predefiniti e due casi senza riempimento. JSON.stringify rende visibili i limiti della stringa, così è possibile contare gli spazi finali.
Esempi
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);Risultato
"ID.-.-." "ID " "ID" "ID" ID
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.