Вебсправочник
Справочник JavaScript

String.repeat(): повтор строки заданное число раз

Метод repeat создаёт новую строку из повторяющихся копий исходной. Он подходит для небольших текстовых разделителей и учебного вывода, когда число повторений известно и ограничено.

Назначение

Метод repeat создаёт новую строку из повторяющихся копий исходной. Он подходит для небольших текстовых разделителей и учебного вывода, когда число повторений известно и ограничено.

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

Нулевой счётчик возвращает пустую строку. Допустимая дробная величина приводится к целому усечением. Отрицательные значения и Infinity вызывают RangeError; слишком большой результат также нельзя считать безопасным.

Пример

const divider = "─".repeat(4);
console.assert(divider === "────");
console.assert("ab".repeat(0) === "");
console.assert("x".repeat(2.8) === "xx");
let rejected = false;
try { "x".repeat(-1); } catch (error) { rejected = error instanceof RangeError; }
console.assert(rejected);
console.log(divider);

Что должно получиться

В консоли выводится короткий разделитель. Проверки подтверждают нулевой результат, усечение дробной части и ошибку для отрицательного счётчика. Исходная строка не изменяется.

Граница применения и частая ошибка

Не передавайте непроверенное пользовательское число: создание огромной строки расходует память. Repeat не создаёт DOM-элементы и не экранирует разметку. Для интерфейсных повторов часто лучше список данных и отдельное создание узлов.

Самостоятельная проверка

Напишите функцию, принимающую только целое число от 0 до 40. Проверьте границы, отрицательное значение и строку "5". Решите явно, разрешаете ли вы преобразование типов или отклоняете такой ввод.

Пример JavaScript проверяйте в собственном учебном файле или консоли своего проекта. Встроенная песочница справочника JavaScript не выполняет. Успешное выполнение в одной среде не гарантирует поддержку метода во всех браузерах.

Самостоятельный учебный материал. Техническая документация: первоисточник по теме ↗. Если результат отличается, проверьте код и версию браузера.