CKTIS / JavaScript
String.prototype.repeat — ponavljanje besedila
Metoda repeat(count) vrne zaporedne kopije niza, ne da bi spremenila izvirnik. Argument count tipa Symbol ali BigInt pri številski pretvorbi sproži napako TypeError. Če pretvorba in odrez ulomljenega dela dasta negativno celo število ali pozitivno oziroma negativno neskončnost, metoda sproži napako RangeError.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
str.repeat(count)String.prototype.repeat vrne niz z count kopijami besedila, združenimi brez ločila. Izvirnik ostane nespremenjen. Ponavljajo se kodne enote UTF-16, ne pa posebej obravnavani vidni znaki.
Argument count se številsko pretvori, ulomljeni del pa se odreže proti nič: 2.9 ustvari dve ponovitvi, -0.5 pa prazen niz. Prazen niz ustvarijo tudi 0, NaN in izpuščen argument. Vrednost tipa Symbol ali BigInt pri številski pretvorbi sproži napako TypeError. Če pretvorba in odrez ulomljenega dela dasta negativno celo število, Infinity ali -Infinity, metoda sproži napako RangeError; to velja tudi za prazen vhodni niz.
Metodo si lahko izposodite z String.prototype.repeat.call(value, count): prejemnik se pretvori v besedilo, vendar null in undefined povzročita TypeError. Pri zunanjih podatkih omejite število ponovitev, da ne zahtevate pretirano velikega rezultata.
Primeri
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);
}Rezultat
ababab "" abab ab RangeError
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.