CKTIS / JavaScript
String.prototype.padStart — doplnění textu zleva
String.prototype.padStart doplní začátek řetězce na zadanou délku opakováním výplně a v případě potřeby jejím zkrácením. Původní řetězec nemění a nezkracuje řetězec, který už je dostatečně dlouhý. Délka se měří v jednotkách kódu UTF-16.
Verze: Introduced in ECMAScript 2017 (ES2017) as a standard-library method. Node.js 24 support does not establish browser support.
Syntaxe
str.padStart(maxLength[, fillString])String.prototype.padStart vrací řetězec doplněný zleva. Argument maxLength určuje cílovou délku celého výsledku, nikoli počet přidaných znaků. Původní řetězec zůstává nezměněn. Metoda se hodí například pro identifikátory s úvodními nulami; čísla nejprve převeďte na řetězce.
Volitelný argument fillString se opakuje, dokud není dosaženo potřebné délky výplně. Přebytek se odstraní z konce výplně, nikoli z původního řetězce. Pokud fillString vynecháte nebo předáte undefined, použije se jedna mezera U+0020. Prázdná výplň "" ponechá řetězec beze změny. Pokud maxLength nepřesahuje délku řetězce, metoda jej vrátí bez doplnění i zkrácení.
maxLength se převádí pomocí ToLength: kladné zlomky se zkrátí na celá čísla, zatímco záporné hodnoty a NaN se změní na nulu. Délka znamená jednotky kódu UTF-16, nikoli viditelné znaky ani šířku zobrazení. Zkrácení výplně může rozdělit pár náhradních znaků, proto se pro tyto identifikátory hodí jednoduché ASCII výplně. Volání metody s null nebo undefined jako this vyvolá TypeError.
Metoda patří do ECMAScript 2017 (ES2017), nikoli mezi Web APIs. Jazyková specifikace neurčuje, které verze prohlížečů ji podporují; v cílovém prostředí ověřte typeof String.prototype.padStart === "function". Přítomnost Node 24 v repozitáři nedokazuje podporu v prohlížečích.
Příklady
const id = "42";
console.log(id.padStart(5, "0"));
console.log(id.padStart(7, "ab"));
console.log(JSON.stringify(id.padStart(4)));
console.log(id.padStart(1, "0"));
console.log(id.padStart(5, ""));
console.log(id);Výsledek
00042 ababa42 " 42" 42 42 42
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.