Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

String.prototype.repeat — opakování textu

Metoda repeat(count) vrací po sobě jdoucí kopie řetězce, aniž by změnila originál. Argument count typu Symbol nebo BigInt při číselném převodu vyvolá chybu TypeError. Pokud je výsledkem převodu a oříznutí záporné celé číslo nebo kladné či záporné nekonečno, metoda vyvolá chybu RangeError.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

str.repeat(count)

String.prototype.repeat vrací řetězec obsahující count kopií textu spojených bez oddělovače. Originál zůstává nezměněný. Opakují se jednotky kódu UTF-16, nikoli samostatně interpretované viditelné znaky.

Argument count se číselně převede a desetinná část se odřízne směrem k nule: 2.9 vytvoří dvě opakování, zatímco -0.5 vytvoří prázdný řetězec. Prázdný řetězec vytvoří také 0, NaN a vynechaný argument. Hodnota typu Symbol nebo BigInt při číselném převodu vyvolá chybu TypeError. Pokud je výsledkem převodu a oříznutí záporné celé číslo, Infinity nebo -Infinity, metoda vyvolá chybu RangeError; platí to i pro prázdný vstupní text.

Metodu lze použít zapůjčením přes String.prototype.repeat.call(value, count): příjemce se převede na text, ale null a undefined způsobí chybu TypeError. U externích vstupů omezte počet opakování, abyste nepožadovali příliš velký výsledek.

Příklady

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);
}

Výsledek

ababab
""
abab
ab
RangeError

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje