CKTIS / JavaScript
String.prototype.padEnd — dopunjavanje završetka niza
String.prototype.padEnd dopunjava kraj niza do ciljne duljine ponavljanjem zadanog niza ili zadanih razmaka. Izvorni niz ostaje nepromijenjen, a niz koji je već dovoljno dug ne skraćuje se.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
str.padEnd(maxLength[, fillString])String.prototype.padEnd vraća niz dopunjen s desne strane do duljine maxLength. Taj argument određuje ukupnu ciljnu duljinu rezultata, a ne broj znakova koje treba dodati. Metoda ne mijenja izvorni niz. Dio je ECMAScripta od izdanja iz 2017.; nije Web API. Sama specifikacija ne potvrđuje podršku u određenom pregledniku.
Ako je fillString izostavljen ili ima vrijednost undefined, dopunjava se razmakom U+0020. Inače se vrijednost za dopunjavanje pretvara u niz, ponavlja i po potrebi skraćuje na kraju. Prazan fillString ne dodaje ništa. Ako maxLength nije veći od duljine ulaza, metoda vraća niz nepromijenjen i ne pretvara fillString.
Na maxLength se primjenjuje operacija ToLength: odbacuje se pozitivan decimalni dio, dok negativne vrijednosti i NaN postaju nula. Duljina se mjeri u UTF-16 kodnim jedinicama, a ne u vidljivim znakovima ili stupcima zaslona. Skraćivanje dopune može razdvojiti surogatni par, pa ova metoda ne jamči ispravno poravnanje proizvoljnog Unicode teksta.
Primjer prikazuje ponavljanje i skraćivanje dopune, zadane razmake i dva slučaja bez dopunjavanja. JSON.stringify čini granice niza vidljivima pa se mogu prebrojiti završni razmaci.
Primjeri
const label = "ID";
console.log(JSON.stringify(label.padEnd(7, ".-")));
console.log(JSON.stringify(label.padEnd(4)));
console.log(JSON.stringify(label.padEnd(1, "0")));
console.log(JSON.stringify(label.padEnd(7, "")));
console.log(label);Rezultat
"ID.-.-." "ID " "ID" "ID" ID
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.