CKTIS / JavaScript
String.prototype.padStart — riempire il testo a sinistra
String.prototype.padStart riempie l’inizio di una stringa fino a una lunghezza specificata ripetendo il testo di riempimento e, se necessario, troncandolo. Non modifica la stringa originale e non accorcia quelle già abbastanza lunghe. La lunghezza è misurata in unità di codice UTF-16.
Versione: Introduced in ECMAScript 2017 (ES2017) as a standard-library method. Node.js 24 support does not establish browser support.
Sintassi
str.padStart(maxLength[, fillString])String.prototype.padStart restituisce una stringa riempita a sinistra. L’argomento maxLength indica la lunghezza finale dell’intero risultato, non il numero di caratteri da aggiungere. La stringa originale resta invariata. Il metodo è utile, per esempio, per identificatori con zeri iniziali; converti prima i numeri in stringhe.
L’argomento facoltativo fillString viene ripetuto fino a raggiungere la lunghezza di riempimento necessaria. L’eccesso viene rimosso dalla fine del riempimento, non dalla stringa originale. Se fillString viene omesso o si passa undefined, viene usato un singolo spazio U+0020. Un riempimento vuoto "" lascia la stringa invariata. Se maxLength non supera la lunghezza della stringa, il metodo la restituisce senza riempirla né troncarla.
maxLength viene convertito tramite ToLength: le frazioni positive vengono troncate a interi, mentre i valori negativi e NaN diventano zero. La lunghezza indica unità di codice UTF-16, non caratteri visibili né larghezza sullo schermo. Il troncamento del riempimento può dividere una coppia di surrogati, quindi per questi identificatori sono adatti riempimenti ASCII semplici. Chiamare il metodo con null o undefined come this genera un TypeError.
Il metodo fa parte di ECMAScript 2017 (ES2017), non delle Web APIs. La specifica del linguaggio non stabilisce quali versioni dei browser lo supportino; verifica typeof String.prototype.padStart === "function" nell’ambiente di destinazione. La presenza di Node 24 in un repository non dimostra il supporto dei browser.
Esempi
const id = "42";
console.log(id.padStart(5, "0"));
console.log(id.padStart(7, "ab"));
console.log(JSON.stringify(id.padStart(4)));
console.log(id.padStart(1, "0"));
console.log(id.padStart(5, ""));
console.log(id);Risultato
00042 ababa42 " 42" 42 42 42
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.