Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri