JavaScript String repeat()

const holiday = "Happy holiday!";

// repeating the given string 3 times
const result = holiday.repeat(3);

console.log(result);

// Output:
// Happy holiday!Happy holiday!Happy holiday!

repeat() Syntax

The syntax of the repeat() method is:

str.repeat(count)

Here, str is a string.

repeat() Parameters

The repeat() method takes in :

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

repeat() Return Value

• Returns a new string containing the specified number of copies of the given string.

Note: repeat() raises RangeError if repeat count is negative, infinity, or overflows maximum string size.

Example 1: Using repeat() Method

// string declaration
const holiday = "Happy holiday!";

// repeating the given string 2 times
const result = holiday.repeat(2);

console.log(result);

// using 0 as a count value
// returns an empty string
let result2 = holiday.repeat(0);

console.log(result2);

Output

Happy holiday!Happy holiday!

In the above program, holiday.repeat(2) repeats the string stored in holiday 2 times.

When we pass 0 as a parameter, the method repeats holiday 0 times. That's why holiday.repeat(0) doesn't print anything (prints empty string).

Example 2: Using Non-integer as a Count Value in repeat()

let sentence = "Happy Birthday to you!";

// using non-integer count value
let result1 = sentence.repeat(3.2);

console.log(result1);

// using non-integer count value
let result2 = sentence.repeat(3.7);

console.log(result2);

Output

Happy Birthday to you!Happy Birthday to you!Happy Birthday to you!
Happy Birthday to you!Happy Birthday to you!Happy Birthday to you!
 

Here, the non-integer index values 3.2 and 3.7 are converted to the nearest integer index 3. So, both sentence.repeat(3.2) and sentence.repeat(3.7) repeats the string 3 times.

Example 3: Using Negative Number as a Count Value

The count value in the repeat() method must be a non-negative number. Otherwise, it throws an error. For example:

let sentence = "Happy Birthday to you!";

// using negative number as count value
let result3 = sentence.repeat(-1);

console.log(result3);

Output

RangeError: Invalid count value

Recommended Reading: JavaScript String concat()