String. prototype. padEnd()
Dopełnia napis z prawej strony podanym tekstem, aż osiągnie wskazaną długość.
- Zwraca
- Nowy napis o długości co najmniej
targetLength, dopełniony z prawej strony. - Zmienia oryginał
- Nie
Przykład
#const chapters = [
['Zmienne', 3],
['Pętle', 7],
['Funkcje', 12]
]
for (const [title, page] of chapters) {
console.log(title.padEnd(12, '.') + page)
}Definicja i zastosowanie
#Metoda padEnd() działa jak padStart(), ale dokleja znaki na końcu napisu. Domyślnie używa spacji, a jeśli napis ma już co najmniej żądaną długość, wraca bez zmian.
Przydaje się do wyrównywania tekstu w kolumnach, np. w tabeli wyników wypisywanej w konsoli, do tworzenia linii z kropkami w spisie treści albo do uzupełniania pól o stałej szerokości w prostych formatach plików.
Tekst dopełniający jest powtarzany i przycinany tak, żeby wynik miał dokładnie żądaną długość. Oryginalny napis się nie zmienia.
Składnia
#string.padEnd(targetLength)
string.padEnd(targetLength, padString)Parametry
#targetLength
number
Docelowa długość wyniku. Gdy nie przekracza długości napisu, napis wraca bez zmian.padString
string, opcjonalny
Tekst dopisywany na końcu, powtarzany i przycinany do potrzebnej długości. Domyślnie spacja.
Więcej przykładów
#const header = 'Uczeń'.padEnd(8) + 'Punkty'
const rows = ['Ania'.padEnd(8) + 120, 'Kuba'.padEnd(8) + 95]
console.log([header, ...rows].join('\n'))console.log('Ładowanie'.padEnd(14, '.-'))
console.log('OK'.padEnd(1, '*'))Obsługa przeglądarek
#Szeroko dostępne
Działa we wszystkich nowoczesnych przeglądarkach, także na telefonach. Możesz używać bez obaw.
- Chrome
- Edge
- Firefox
- Safari
Dobre praktyki
#- Wyrównanie spacjami wygląda dobrze tylko przy czcionce o stałej szerokości, np. w konsoli. Na stronie do układu kolumn używaj tabel HTML albo CSS Grid.
- Emoji i niektóre symbole liczą się jako dwie jednostki długości, więc kolumny z nimi mogą się rozjechać.
Powiązane hasła
#- String.prototype.padStart()Dopełnia napis z lewej strony podanym tekstem, aż osiągnie wskazaną długość. Idealne do zer wiodących.
- String.prototype.repeat()Zwraca nowy napis złożony z podanej liczby powtórzeń oryginału.
- String.prototype.lengthDługość napisu, czyli liczba jednostek kodu UTF-16. Właściwość jest tylko do odczytu.
- Template literalsSzablony tekstowe w odwróconych apostrofach: wstawiają wartości przez ${} i mogą zajmować wiele linii.
Widzisz błąd albo brakuje przykładu? Napisz do nas.