WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

String.prototype.repeat — Text wiederholen

Die Methode repeat(count) gibt aufeinanderfolgende Kopien eines Strings zurück, ohne das Original zu ändern. Ein Wert vom Typ Symbol oder BigInt löst bei der numerischen Konvertierung einen TypeError aus. Ergibt die Konvertierung mit Abschneiden des Nachkommateils eine negative Ganzzahl oder einen der beiden Unendlichkeitswerte, löst die Methode einen RangeError aus.

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

Syntax

str.repeat(count)

String.prototype.repeat gibt einen String mit count Kopien des Textes zurück, die ohne Trennzeichen aneinandergehängt werden. Das Original bleibt unverändert. Wiederholt werden UTF-16-Codeeinheiten und nicht separat interpretierte sichtbare Zeichen.

Das Argument count wird numerisch konvertiert und in Richtung null abgeschnitten: 2.9 ergibt zwei Wiederholungen, -0.5 dagegen einen leeren String. Auch 0, NaN und ein ausgelassenes Argument ergeben einen leeren String. Ein Wert vom Typ Symbol oder BigInt löst bei der numerischen Konvertierung einen TypeError aus. Ergibt die Konvertierung mit Abschneiden des Nachkommateils eine negative Ganzzahl, Infinity oder -Infinity, löst die Methode einen RangeError aus; das gilt auch für einen leeren Eingabetext.

Die Methode kann über String.prototype.repeat.call(value, count) ausgeliehen werden: Der Empfänger wird in Text umgewandelt, bei null und undefined tritt jedoch ein TypeError auf. Begrenze bei externen Eingaben die Wiederholungszahl, damit kein übermäßig großes Ergebnis angefordert wird.

Beispiele

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

Ergebnis

ababab
""
abab
ab
RangeError

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen