Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

String.prototype.padStart — dopełnianie tekstu z lewej strony

String.prototype.padStart dopełnia początek tekstu do wskazanej długości, powtarzając i w razie potrzeby skracając wypełnienie. Nie zmienia oryginału i nie skraca tekstu, który jest już dostatecznie długi. Długość jest liczona w jednostkach kodowych UTF-16.

Wersja: Introduced in ECMAScript 2017 (ES2017) as a standard-library method. Node.js 24 support does not establish browser support.

Składnia

str.padStart(maxLength[, fillString])

String.prototype.padStart zwraca tekst dopełniony z lewej strony. Argument maxLength określa docelową długość całego wyniku, a nie liczbę dodawanych znaków. Oryginalny tekst pozostaje niezmieniony. Metoda przydaje się na przykład do zapisu identyfikatorów z zerami na początku; liczby najpierw zamień na tekst.

Opcjonalny fillString jest powtarzany do uzyskania potrzebnej długości. Nadmiar jest odcinany z końca wypełnienia, nie z oryginalnego tekstu. Pominięcie fillString lub przekazanie undefined oznacza pojedynczą spację U+0020. Puste wypełnienie "" pozostawia tekst bez zmian. Jeśli maxLength nie przekracza długości tekstu, metoda zwraca tekst bez dopełnienia i bez skracania.

maxLength podlega konwersji ToLength: dodatnie ułamki są obcinane do liczby całkowitej, a wartości ujemne i NaN dają zero. Długość oznacza jednostki kodowe UTF-16, nie widoczne znaki ani szerokość na ekranie. Skrócenie wypełnienia może rozdzielić parę surogatów, dlatego proste wypełnienia ASCII są odpowiednie do takich identyfikatorów. Wywołanie metody z null lub undefined jako this powoduje TypeError.

Metoda należy do ECMAScript 2017 (ES2017), a nie do Web APIs. Specyfikacja języka nie określa wersji przeglądarek obsługujących tę metodę; dla środowiska docelowego sprawdź typeof String.prototype.padStart === "function". Obecność Node 24 w repozytorium nie dowodzi obsługi w przeglądarce.

Przykłady

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

Wynik

00042
ababa42
"  42"
42
42
42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła