CKTIS / JavaScript
String.prototype.padStart — dopolnjevanje besedila z leve
String.prototype.padStart dopolni začetek niza do določene dolžine s ponavljanjem polnila in po potrebi njegovim krajšanjem. Izvirnega niza ne spremeni in ne skrajša niza, ki je že dovolj dolg. Dolžina se meri v kodnih enotah UTF-16.
Različica: Introduced in ECMAScript 2017 (ES2017) as a standard-library method. Node.js 24 support does not establish browser support.
Sintaksa
str.padStart(maxLength[, fillString])String.prototype.padStart vrne niz, dopolnjen z leve. Argument maxLength določa ciljno dolžino celotnega rezultata, ne števila znakov, ki jih je treba dodati. Izvirni niz ostane nespremenjen. Metoda je uporabna na primer za identifikatorje z začetnimi ničlami; števila najprej pretvorite v nize.
Izbirni argument fillString se ponavlja, dokler ni dosežena potrebna dolžina polnila. Presežek se odstrani s konca polnila, ne iz izvirnega niza. Če fillString izpustite ali podate undefined, se uporabi en presledek U+0020. Prazno polnilo "" pusti niz nespremenjen. Če maxLength ne presega dolžine niza, ga metoda vrne brez dopolnjevanja ali krajšanja.
maxLength se pretvori z ToLength: pozitivni ulomki se odrežejo na cela števila, negativne vrednosti in NaN pa postanejo nič. Dolžina pomeni kodne enote UTF-16, ne vidnih znakov ali širine prikaza. Krajšanje polnila lahko razdeli nadomestniški par, zato so za take identifikatorje primerna preprosta polnila ASCII. Klic metode z null ali undefined kot this sproži TypeError.
Metoda je del ECMAScript 2017 (ES2017), ne Web APIs. Jezikovna specifikacija ne določa, katere različice brskalnikov jo podpirajo; v ciljnem okolju preverite typeof String.prototype.padStart === "function". Prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalnikih.
Primeri
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);Rezultat
00042 ababa42 " 42" 42 42 42
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.