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.