CKTIS / JavaScript
String.prototype.padStart — doplnenie textu zľava
String.prototype.padStart doplní začiatok reťazca na zadanú dĺžku opakovaním výplne a v prípade potreby jej skrátením. Pôvodný reťazec nemení a neskracuje reťazec, ktorý je už dostatočne dlhý. Dĺžka sa meria v jednotkách kódu UTF-16.
Verzia: Introduced in ECMAScript 2017 (ES2017) as a standard-library method. Node.js 24 support does not establish browser support.
Syntax
str.padStart(maxLength[, fillString])String.prototype.padStart vracia reťazec doplnený zľava. Argument maxLength určuje cieľovú dĺžku celého výsledku, nie počet pridávaných znakov. Pôvodný reťazec zostáva nezmenený. Metóda sa hodí napríklad na identifikátory s úvodnými nulami; čísla najprv preveďte na reťazce.
Voliteľný argument fillString sa opakuje, kým sa nedosiahne potrebná dĺžka výplne. Prebytok sa odstráni z konca výplne, nie z pôvodného reťazca. Ak fillString vynecháte alebo odovzdáte undefined, použije sa jedna medzera U+0020. Prázdna výplň "" ponechá reťazec nezmenený. Ak maxLength nepresahuje dĺžku reťazca, metóda ho vráti bez doplnenia aj skrátenia.
maxLength sa konvertuje pomocou ToLength: kladné zlomky sa skrátia na celé čísla, zatiaľ čo záporné hodnoty a NaN sa zmenia na nulu. Dĺžka znamená jednotky kódu UTF-16, nie viditeľné znaky ani šírku zobrazenia. Skrátenie výplne môže rozdeliť pár náhradných znakov, preto sú pre tieto identifikátory vhodné jednoduché ASCII výplne. Volanie metódy s null alebo undefined ako this vyvolá TypeError.
Metóda patrí do ECMAScript 2017 (ES2017), nie medzi Web APIs. Jazyková špecifikácia neurčuje, ktoré verzie prehliadačov ju podporujú; v cieľovom prostredí overte typeof String.prototype.padStart === "function". Prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadačoch.
Príklady
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);Výsledok
00042 ababa42 " 42" 42 42 42
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.