Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri