Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

String.prototype.padEnd — doplnenie konca reťazca

String.prototype.padEnd dopĺňa koniec reťazca na cieľovú dĺžku opakovaním zadaného reťazca alebo predvolených medzier. Pôvodný reťazec nemení a reťazec, ktorý je už dosť dlhý, neskracuje.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

str.padEnd(maxLength[, fillString])

String.prototype.padEnd vracia reťazec doplnený sprava na dĺžku maxLength. Tento argument určuje celkovú cieľovú dĺžku výsledku, nie počet pridávaných znakov. Metóda pôvodný reťazec nemení. Je súčasťou ECMAScript od vydania z roku 2017; nejde o Web API. Samotná špecifikácia nepotvrdzuje podporu v konkrétnom prehliadači.

Ak sa fillString vynechá alebo má hodnotu undefined, dopĺňa sa medzerou U+0020. Inak sa dopĺňacia hodnota prevedie na reťazec, opakuje sa a podľa potreby sa skráti na konci. Prázdny fillString nič nepridá. Ak maxLength nie je väčšie ako dĺžka vstupu, metóda vráti reťazec bez zmeny a fillString neprevedie.

Na maxLength sa použije operácia ToLength: kladná desatinná časť sa zahodí, zatiaľ čo záporné hodnoty a NaN sa zmenia na nulu. Dĺžka sa meria v UTF-16 kódových jednotkách, nie vo viditeľných znakoch ani v stĺpcoch obrazovky. Skrátenie doplnenia môže rozdeliť dvojicu náhradných znakov, preto táto metóda nezaručuje správne zarovnanie ľubovoľného textu Unicode.

Príklad ukazuje opakovanie a skracovanie doplnenia, predvolené medzery a dva prípady bez doplnenia. JSON.stringify zviditeľní hranice reťazca, takže možno spočítať koncové medzery.

Príklady

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);

Výsledok

"ID.-.-."
"ID  "
"ID"
"ID"
ID

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje