Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

String.prototype.padEnd — doplnění konce řetězce

String.prototype.padEnd doplní konec řetězce na cílovou délku opakováním zadaného řetězce nebo výchozích mezer. Původní řetězec nemění a řetězec, který už je dostatečně dlouhý, nezkracuje.

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

Syntaxe

str.padEnd(maxLength[, fillString])

String.prototype.padEnd vrací řetězec doplněný zprava na délku maxLength. Tento argument určuje celkovou cílovou délku výsledku, nikoli počet přidávaných znaků. Metoda původní řetězec nemění. Je součástí ECMAScript od vydání z roku 2017; nejde o Web API. Samotná specifikace nepotvrzuje podporu v konkrétním prohlížeči.

Pokud je fillString vynechán nebo má hodnotu undefined, doplňuje se mezerou U+0020. Jinak se doplňovací hodnota převede na řetězec, opakuje se a podle potřeby se zkrátí na konci. Prázdný fillString nic nepřidá. Pokud maxLength není větší než délka vstupu, metoda vrátí řetězec beze změny a fillString nepřevede.

Na maxLength se použije operace ToLength: kladná desetinná část se zahodí, zatímco záporné hodnoty a NaN se změní na nulu. Délka se měří v UTF-16 kódových jednotkách, nikoli ve viditelných znacích nebo sloupcích obrazovky. Zkrácení doplnění může rozdělit dvojici náhradních znaků, takže tato metoda nezaručuje správné zarovnání libovolného textu Unicode.

Příklad ukazuje opakování a zkrácení doplnění, výchozí mezery a dva případy bez doplnění. JSON.stringify zviditelní hranice řetězce, takže lze spočítat koncové mezery.

Pří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ýsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje