Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

String.prototype.padStart — dopunjavanje teksta slijeva

String.prototype.padStart dopunjava početak niza do zadane duljine ponavljanjem ispune i, po potrebi, njezinim skraćivanjem. Ne mijenja izvorni niz niti skraćuje niz koji je već dovoljno dug. Duljina se mjeri u UTF-16 kodnim jedinicama.

Verzija: 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 vraća niz dopunjen slijeva. Argument maxLength određuje ciljnu duljinu cijelog rezultata, a ne broj znakova koji se dodaju. Izvorni niz ostaje nepromijenjen. Metoda je korisna, primjerice, za identifikatore s početnim nulama; najprije pretvorite brojeve u nizove.

Neobavezni argument fillString ponavlja se dok se ne postigne potrebna duljina ispune. Višak se uklanja s kraja ispune, a ne iz izvornog niza. Ako izostavite fillString ili proslijedite undefined, koristi se jedan razmak U+0020. Prazna ispuna "" ostavlja niz nepromijenjenim. Ako maxLength nije veći od duljine niza, metoda vraća niz bez dopunjavanja ili skraćivanja.

maxLength se pretvara pomoću ToLength: pozitivni razlomci skraćuju se na cijele brojeve, dok negativne vrijednosti i NaN postaju nula. Duljina znači UTF-16 kodne jedinice, a ne vidljive znakove ili širinu prikaza. Skraćivanje ispune može razdvojiti par surogata, pa su jednostavne ASCII ispune prikladne za takve identifikatore. Pozivanje metode s null ili undefined kao this izaziva TypeError.

Metoda pripada ECMAScriptu 2017 (ES2017), a ne Web APIs. Jezična specifikacija ne određuje koje je verzije preglednika podržavaju; u ciljnom okruženju provjerite typeof String.prototype.padStart === "function". Prisutnost Nodea 24 u repozitoriju ne dokazuje podršku u preglednicima.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori