Метод repeat() создает новую строку, повторяя заданную строку указанное количество раз, и возвращает ее.

const holiday = "С праздником!";

// повторение заданной строки 3 раза
const result = holiday.repeat(3);

console.log(result);

// Вывод в консоль:
// С праздником!С праздником!С праздником!

Синтаксис repeat()

Синтаксис метода repeat() следующий:

str.repeat(count);

Где str - это строка.

Параметры repeat()

Метод repeat() принимает:

• count
  • Целое число от 0 до +Infinity, указывающее количество повторений строки.

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

Возвращает новую строку, содержащую указанное количество копий заданной строки.

Примечание: repeat() выдает ошибку RangeError, если количество повторений отрицательно, бесконечно или превышает максимальный размер строки.

Примеры

Пример 1: Использование метода repeat()

// объявление строки
const holiday = "С праздником!";

// повторение заданной строки 2 раза
const result = holiday.repeat(2);

console.log(result);

// использование 0 в качестве значения счета
// возвращает пустую строку
let result2 = holiday.repeat(0);

console.log(result2);

Вывод в консоль:

С праздником!С праздником!

В приведенной выше программе holiday.repeat(2) повторяет строку, хранящуюся в holiday, 2 раза.

Когда мы передаем 0 в качестве параметра, метод повторяет holiday 0 раз. Поэтому holiday.repeat(0) ничего не печатает (печатает пустую строку).

Пример 2: Использование нецелого числа в качестве значения счетчика в repeat()

let sentence = "Happy Birthday to you!";

// использование нецелочисленного значения счетчика
let result1 = sentence.repeat(3.2);

console.log(result1);

// использование нецелочисленного значения счетчика
let result2 = sentence.repeat(3.7);

console.log(result2);

Вывод в консоль:

Happy Birthday to you!Happy Birthday to you!Happy Birthday to you!
Happy Birthday to you!Happy Birthday to you!Happy Birthday to you!

Здесь нецелые индексные значения 3.2 и 3.7 преобразуются в ближайший целочисленный индекс 3. Таким образом, и sentence.repeat(3.2), и sentence.repeat(3.7) повторяют строку 3 раза.

Пример 3: Использование отрицательного числа в качестве значения счетчика

Значение count в методе repeat() должно быть неотрицательным числом. В противном случае выдается ошибка. Например:

let sentence = "Happy Birthday to you!";

// использование отрицательного числа в качестве значения счетчика
let result3 = sentence.repeat(-1);

console.log(result3);

Вывод в консоль:

RangeError: Invalid count value

Здесь нецелые индексные значения 3.2 и 3.7 преобразуются в ближайший целочисленный индекс 3. Таким образом, и sentence.repeat(3.2), и sentence.repeat(3.7) повторяют строку 3 раза.