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.