Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

String.prototype.padEnd — dopełnianie końca tekstu

String.prototype.padEnd dopełnia koniec tekstu do zadanej długości, powtarzając wskazany ciąg albo domyślne spacje. Nie zmienia oryginału i nie skraca tekstu, który jest już wystarczająco długi.

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

Składnia

str.padEnd(maxLength[, fillString])

String.prototype.padEnd zwraca tekst dopełniony z prawej strony do maxLength. Argument określa docelową długość całego wyniku, a nie liczbę dodawanych znaków. Metoda nie zmienia oryginału. Należy do ECMAScript od edycji 2017; nie jest interfejsem Web API. Sama specyfikacja nie potwierdza obsługi w konkretnej przeglądarce.

Gdy fillString pominięto lub ma wartość undefined, wypełnieniem jest spacja U+0020. W innym przypadku wypełnienie jest konwertowane na tekst, powtarzane i w razie potrzeby ucinane od końca. Pusty fillString nie dodaje niczego. Jeśli maxLength nie przekracza długości wejścia, metoda zwraca tekst bez zmian, bez konwersji fillString.

maxLength podlega operacji ToLength: dodatnia część ułamkowa jest odrzucana, a wartości ujemne i NaN dają zero. Długość jest liczona w jednostkach kodowych UTF-16, nie w widocznych znakach ani kolumnach ekranu. Ucięcie wypełnienia może rozdzielić parę surogatów, więc ta metoda nie zapewnia poprawnego wyrównania dowolnego tekstu Unicode.

Przykład pokazuje powtarzanie i ucinanie wypełnienia, domyślne spacje oraz dwa przypadki bez dopełniania. JSON.stringify uwidacznia granice tekstu, dzięki czemu końcowe spacje można policzyć.

Przykłady

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

Wynik

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

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

Źródła