This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

String.prototype.padEnd()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨апрель 2017 г.⁩.

Метод padEnd() значений String заполняет строку указанной строкой (повторяя её необходимое количество раз) так, чтобы результирующая строка достигла указанной длины. Заполнение происходит с конца исходной строки.

Интерактивный пример

const str1 = "Блины со сметаной";

console.log(str1.padEnd(25, "."));
// Результат: "Блины со сметаной........"

const str2 = "200";

console.log(str2.padEnd(5));
// Результат: "200  "

Синтаксис

js
padEnd(targetLength)
padEnd(targetLength, padString)

Если padString слишком длинный, чтобы уместиться в targetLength, он будет усечен: для языков с письмом слева направо будет применена самая левая часть, а для языков с письмом справа налево — самая правая. Значение по умолчанию для этого параметра — " "

Параметры

targetLength

Длина результирующей строки после заполнения. Если значение меньше или равно str.length, текущая строка будет возвращена юез изменений.

padString Необязательный

Строка, которая будет использована для заполнения исходной строки str. Если padString слишком длинная, чтобы оставаться в пределах targetLength, то она будет обрезана: для языков с письмом слева направо будет применена самая левая часть, а для языков с письмом справа налево — самая правая. Значение по умолчанию для этого параметра — " " (U+0020).

Возвращаемое значение

String указанной длины targetLength с заполнением padString, применённым к концу исходной строки str.

Примеры

Использование padEnd

js
"мир".padEnd(10); // "мир       "
"мир".padEnd(10, "наш"); // "мирнашнашн"
"мир".padEnd(6, "123456"); // "мир123"
"мир".padEnd(1); // "мир"

Спецификации

Specification
ECMAScript® 2026 Language Specification
# sec-string.prototype.padend

Совместимость с браузерами

Смотрите также