База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

String.prototype.repeat — повторение на текст

Методът repeat(count) връща последователни копия на низ, без да променя оригинала. Аргумент count от тип Symbol или BigInt води до TypeError при числовото преобразуване. Ако след преобразуването и отрязването на дробната част се получи отрицателно цяло число или положителна или отрицателна безкрайност, методът хвърля RangeError.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

str.repeat(count)

String.prototype.repeat връща низ с count копия на текста, свързани без разделител. Оригиналът остава непроменен. Повтарят се UTF-16 кодови единици, а не видими знаци, разглеждани поотделно.

Аргументът count се преобразува числово, а дробната част се отрязва към нулата: 2.9 дава две повторения, докато -0.5 дава празен низ. Празен низ дават също 0, NaN и пропуснат аргумент. Стойност от тип Symbol или BigInt води до TypeError при числовото преобразуване. Ако след преобразуването и отрязването на дробната част се получи отрицателно цяло число, Infinity или -Infinity, методът хвърля RangeError; това важи и при празен входен текст.

Методът може да се заеме чрез String.prototype.repeat.call(value, count): получателят се преобразува в текст, но null и undefined водят до TypeError. При външни данни ограничете броя повторения, за да не заявите прекалено голям резултат.

Примери

const text = "ab";
console.log(text.repeat(3));
console.log(JSON.stringify(text.repeat(0)));
console.log(text.repeat(2.9));
console.log(text);
try {
  text.repeat(-1);
} catch (error) {
  console.log(error.name);
}

Резултат

ababab
""
abab
ab
RangeError

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници