Learn JavaScript

padEnd() - метод для добавления символов в конец строки в JavaScript

padEnd() дополняет строку в конце, пока она не достигнет нужной длины.

Этот метод часто используют для выравнивания текста и форматирования вывода в столбик.

Синтаксис

str.padEnd(targetLength)
str.padEnd(targetLength, padString)

Где:

  • targetLength - итоговая длина строки
  • padString - строка, которой нужно дополнять конец

Метод возвращает новую строку.

Как работает padEnd()

console.log("5".padEnd(3, "0")); // "500"

Если исходная строка короче, чем targetLength, в конец добавляются символы.

Если второй аргумент не передать

Если padString не указан, строка будет дополняться пробелами.

console.log("5".padEnd(3)); // "5  "

Если строка уже достаточно длинная

Если длина строки уже равна targetLength или больше, метод вернёт исходную строку без изменений.

console.log("abc".padEnd(2, "0")); // "abc"
console.log("abc".padEnd(3, "0")); // "abc"

Как работает padString

Во втором аргументе можно передать любую строку.

console.log("5".padEnd(4, "ab")); // "5aba"

Если padString длиннее, чем нужно, JavaScript возьмёт только нужную часть.

console.log("5".padEnd(6, "ab")); // "5ababa"

Если padString - пустая строка, дополнения не будет.

console.log("5".padEnd(3, "")); // "5"

Исходная строка не меняется

Строки в JavaScript неизменяемы, поэтому padEnd() не меняет исходное значение.

const text = "5";
const result = text.padEnd(3, "0");

console.log(text);   // "5"
console.log(result); // "500"

Когда это полезно

padEnd() удобно использовать, когда:

  • нужно выровнять текст по ширине
  • надо дополнить строку справа
  • хочется сделать более ровный вывод в консоли или таблице

Пример:

const name = "JS";

console.log(name.padEnd(6, ".")); // "JS...."
const column = "Item";

console.log(column.padEnd(10, " ") + "Price");

padEnd() и padStart()

padEnd() дополняет строку справа, а padStart() - слева.

console.log("5".padEnd(3, "0"));   // "500"
console.log("5".padStart(3, "0")); // "005"

Если важно именно дополнение в конце строки, используют padEnd().

Частые ошибки

Ожидать, что padEnd() меняет строку на месте

let text = "5";

text.padEnd(3, "0");
console.log(text); // "5"

Нужно сохранить результат:

let text = "5";

text = text.padEnd(3, "0");
console.log(text); // "500"

Путать итоговую длину и количество добавляемых символов

console.log("5".padEnd(3, "0")); // "500"

Число 3 здесь означает не “добавить три нуля”, а “сделать итоговую длину строки равной 3”.

Забывать, что по умолчанию добавляются пробелы

console.log("5".padEnd(3)); // "5  "

Если нужны нули или другие символы, их нужно передать явно.

Быстрая памятка

  • padEnd(targetLength, padString) дополняет строку справа
  • метод возвращает новую строку
  • если padString не передан, используются пробелы
  • если строка уже длинная, результат не изменится
  • padEnd() часто используют для выравнивания текста

Коротко

padEnd() - это метод строки в JavaScript, который дополняет строку справа до нужной длины. Он особенно удобен для выравнивания текста, форматирования вывода и построения ровных текстовых колонок.