JavaScriptNapisy

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
Na tej stronie

Przykład

#
JavaScript
const chapters = [
  ['Zmienne', 3],
  ['Pętle', 7],
  ['Funkcje', 12]
]

for (const [title, page] of chapters) {
  console.log(title.padEnd(12, '.') + page)
}
Konsola
Zmienne.....3
Pętle.......7
Funkcje.....12

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

#
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

#
Tabela w konsoli
JavaScript
const header = 'Uczeń'.padEnd(8) + 'Punkty'
const rows = ['Ania'.padEnd(8) + 120, 'Kuba'.padEnd(8) + 95]

console.log([header, ...rows].join('\n'))
Konsola
Uczeń Punkty
Ania 120
Kuba 95
Dłuższy tekst dopełniający
JavaScript
console.log('Ładowanie'.padEnd(14, '.-'))
console.log('OK'.padEnd(1, '*'))
Konsola
Ładowanie.-.-.
OK

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

#

Widzisz błąd albo brakuje przykładu? Napisz do nas.