跳到主要内容

JavaScript字符串repeat()方法

repeat() 方法通过重复给定字符串指定次数来创建一个新字符串,并返回它。

示例

const holiday = "Happy holiday!";

// 将给定字符串重复 3 次
const result = holiday.repeat(3);

console.log(result);

// 输出:
// Happy holiday!Happy holiday!Happy holiday!

repeat() 语法

repeat() 方法的语法是:

str.repeat(count);

这里,str 是一个字符串。

repeat() 参数

repeat() 方法接受:

  • count - 一个介于 0+Infinity 之间的整数,表示重复字符串的次数。

repeat() 返回值

  • 返回一个新字符串,包含指定数量的给定字符串副本。

注意:如果重复次数为负数、无穷大或超出最大字符串大小,repeat() 会引发 RangeError

示例 1:使用 repeat() 方法

// 字符串声明
const holiday = "Happy holiday!";

// 将给定字符串重复 2 次
const result = holiday.repeat(2);

console.log(result);

// 使用 0 作为计数值
// 返回一个空字符串
let result2 = holiday.repeat(0);

console.log(result2);

输出

Happy holiday!Happy holiday!

在上述程序中,holiday.repeat(2) 将存储在 holiday 中的字符串重复 2 次。

当我们传递 0 作为参数时,该方法将 holiday 重复 0 次。这就是为什么 holiday.repeat(0) 不打印任何内容(打印空字符串)。

示例 2:在 repeat() 中使用非整数作为计数值

let sentence = "Happy Birthday to you!";

// 使用非整数计数值
let result1 = sentence.repeat(3.2);

console.log(result1);

// 使用非整数计数值
let result2 = sentence.repeat(3.7);

console.log(result2);

输出

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

这里,非整数索引值 3.23.7 被转换为最接近的整数索引 3。因此,sentence.repeat(3.2)sentence.repeat(3.7) 都将字符串重复 3 次。

示例 3:使用负数作为计数值

repeat() 方法中的计数值必须是非负数。否则,它会抛出错误。例如:

let sentence = "Happy Birthday to you!";

// 使用负数作为计数值
let result3 = sentence.repeat(-1);

console.log(result3);

输出

RangeError: Invalid count value

推荐阅读: JavaScript String concat()