Start · Sprachen · JavaScript · Referenz · String.prototype.repeat()

String.prototype.repeat()

Methode

Die Methode <code>repeat()</code> gibt einen neuen String zurück, der die angegebene Anzahl an aneinandergehängten Kopien des Strings enthält.

Kategorie: method-property

Signatur

repeat(count)

Beschreibung

Die Methode repeat() von String-Werten erzeugt einen neuen String und gibt diesen zurück, der die angegebene Anzahl an Kopien des ursprünglichen Strings enthält, aneinandergehängt.

Parameter

Name Typ Default Beschreibung
$count Pflicht number Eine ganze Zahl zwischen 0 und Infinity, die angibt, wie oft der String wiederholt werden soll.

Rückgabewert

Typ
string
Beschreibung
Ein neuer String, der die angegebene Anzahl an Kopien des gegebenen Strings enthält.

Beispiele

Verwendung von repeat()

"abc".repeat(-1); // RangeError
"abc".repeat(0); // ''
"abc".repeat(1); // 'abc'
"abc".repeat(2); // 'abcabc'
"abc".repeat(3.5); // 'abcabcabc' (count wird in eine ganze Zahl umgewandelt)
"abc".repeat(1 / 0); // RangeError

({ toString: () => "abc", repeat: String.prototype.repeat }).repeat(2);
// 'abcabc' (repeat() ist eine generische Methode)

// Wichtig · Fallstricke

Wirft einen RangeError, wenn count negativ ist oder die maximale String-Länge überschreitet.