CKTIS / JavaScript
String.prototype.padEnd — dopolnjevanje konca niza
String.prototype.padEnd dopolni konec niza do ciljne dolžine s ponavljanjem podanega niza ali privzetih presledkov. Izvirnega niza ne spremeni in ne skrajša niza, ki je že dovolj dolg.
Različica: 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 vrne niz, dopolnjen z desne do dolžine maxLength. Ta argument določa skupno ciljno dolžino rezultata, ne števila znakov, ki jih je treba dodati. Metoda izvirnika ne spremeni. Del ECMAScripta je od izdaje iz leta 2017; ni spletni API. Sama specifikacija ne potrjuje podpore v določenem brskalniku.
Če je fillString izpuščen ali ima vrednost undefined, se dopolnjuje s presledkom U+0020. Sicer se vrednost za dopolnjevanje pretvori v niz, ponavlja in po potrebi odreže na koncu. Prazen fillString ne doda ničesar. Če maxLength ni večji od dolžine vhoda, metoda vrne niz nespremenjen in ne pretvori fillString.
Za maxLength se uporabi operacija ToLength: pozitivni decimalni del se zavrže, negativne vrednosti in NaN pa postanejo nič. Dolžina se meri v kodnih enotah UTF-16, ne v vidnih znakih ali stolpcih zaslona. Pri krajšanju dopolnila se lahko razdeli nadomestniški par, zato ta metoda ne zagotavlja pravilne poravnave poljubnega besedila Unicode.
Primer prikazuje ponavljanje in krajšanje dopolnila, privzete presledke ter dva primera brez dopolnjevanja. JSON.stringify prikaže meje niza, zato je mogoče prešteti končne presledke.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.