String.prototype.repeat()

Baseline Widely available

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

Learn more
See full compatibility

The repeat() method of String values constructs and returns a new string which contains the specified number of copies of this string, concatenated together.

Try it

const mood = "Happy! ";

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

Syntax

repeat(count)

Parameters

count: An integer between 0 and Infinity, indicating the number of times to repeat the string.

Return value

A new string containing the specified number of copies of the given string.

Exceptions

RangeError: Thrown if count is negative or if count overflows maximum string length.

Examples

Using repeat()

"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)