String.prototype.repeat()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

Die repeat()-Methode von String-Werten erstellt und gibt einen neuen String zurück, der die angegebene Anzahl von Kopien dieses Strings enthält, zusammengefügt zu einem String.

Probieren Sie es aus

const mood = "Happy! ";

console.log(`I feel ${mood.repeat(3)}`);
// Expected output: "I feel Happy! Happy! Happy! "

Syntax

js
repeat(count)

Parameter

count

Eine Ganzzahl zwischen 0 und +Infinity, die angibt, wie oft der String wiederholt werden soll.

Rückgabewert

Ein neuer String, der die angegebene Anzahl von Kopien des gegebenen Strings enthält.

Ausnahmen

RangeError

Wird ausgelöst, wenn count negativ ist oder wenn count die maximale Stringlänge überschreitet.

Beispiele

Verwendung von repeat()

js
"abc".repeat(-1); // RangeError
"abc".repeat(0); // ''
"abc".repeat(1); // 'abc'
"abc".repeat(2); // 'abcabc'
"abc".repeat(3.5); // 'abcabcabc' (count will be converted to integer)
"abc".repeat(1 / 0); // RangeError

({ toString: () => "abc", repeat: String.prototype.repeat }).repeat(2);
// 'abcabc' (repeat() is a generic method)

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-string.prototype.repeat

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch