在此页

• 句法
• Polyfill
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

repeat() method constructs and returns a new string which contains the specified number of copies of the string on which it was called, concatenated together.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

句法

str.repeat(count)
					

参数

count

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

返回值

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

异常

• RangeError : repeat count must be non-negative.
• RangeError : repeat count must be less than infinity and not overflow maximum string size.

Polyfill

This method has been added to the ECMAScript 2015 specification and may not be available in all JavaScript implementations yet. However, you can polyfill String.prototype.repeat() with the following snippet:

if (!String.prototype.repeat) {
  String.prototype.repeat = function(count) {
    'use strict';
    if (this == null)
      throw new TypeError('can\'t convert ' + this + ' to object');
    var str = '' + this;
    // To convert string to integer.
    count = +count;
    // Check NaN
    if (count != count)
      count = 0;
    if (count < 0)
      throw new RangeError('repeat count must be non-negative');
    if (count == Infinity)
      throw new RangeError('repeat count must be less than infinity');
    count = Math.floor(count);
    if (str.length == 0 || count == 0)
      return '';
    // Ensuring count is a 31-bit integer allows us to heavily optimize the
    // main part. But anyway, most current (August 2014) browsers can't handle
    // strings 1 << 28 chars or longer, so:
    if (str.length * count >= 1 << 28)
      throw new RangeError('repeat count must not overflow maximum string size');
    var maxCount = str.length * count;
    count = Math.floor(Math.log(count) / Math.log(2));
    while (count) {
       str += str;
       count--;
    }
    str += str.substring(0, maxCount - str.length);
    return str;
  }
}
					

范例

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)
					

规范

规范
ECMAScript (ECMA-262) The definition of 'String.prototype.repeat' in that specification.

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

更新 GitHub 上的兼容性数据

	Desktop						Mobile						Server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet	Node.js
repeat	Chrome 41	Edge 12	Firefox 24	IE No	Opera 28	Safari 9	WebView Android No	Chrome Android 36	Firefox Android 24	Opera Android 28	Safari iOS 9	Samsung Internet Android 3.0	nodejs 4.0.0 4.0.0 0.12 Disabled Disabled From version 0.12: this feature is behind the --harmony runtime flag.

图例

完整支持

完整支持

不支持

不支持

用户必须明确启用此特征。

用户必须明确启用此特征。

另请参阅

• String.prototype.concat()

元数据

• 最后修改： May 20, 2020

相关话题

1. 标准内置对象
2. String
3. 特性
   1. String 长度
4. 方法
   1. String.fromCharCode()
   2. String.fromCodePoint()
   3. String.prototype.anchor()
   4. String.prototype.big()
   5. String.prototype.blink()
   6. String.prototype.bold()
   7. String.prototype.charAt()
   8. String.prototype.charCodeAt()
   9. String.prototype.codePointAt()
   10. String.prototype.concat()
   11. String.prototype.endsWith()
   12. String.prototype.fixed()
   13. String.prototype.fontcolor()
   14. String.prototype.fontsize()
   15. String.prototype.includes()
   16. String.prototype.indexOf()
   17. String.prototype.italics()
   18. String.prototype.lastIndexOf()
   19. String.prototype.link()
   20. String.prototype.localeCompare()
   21. String.prototype.match()
   22. String.prototype.matchAll()
   23. String.prototype.normalize()
   24. String.prototype.padEnd()
   25. String.prototype.padStart()
   26. String.prototype.repeat()
   27. String.prototype.replace()
   28. String.prototype.replaceAll()
   29. String.prototype.search()
   30. String.prototype.slice()
   31. String.prototype.small()
   32. String.prototype.split()
   33. String.prototype.startsWith()
   34. String.prototype.strike()
   35. String.prototype.sub()
   36. String.prototype.substr()
   37. String.prototype.substring()
   38. String.prototype.sup()
   39. String.prototype.toLocaleLowerCase()
   40. String.prototype.toLocaleUpperCase()
   41. String.prototype.toLowerCase()
   42. String.prototype.toSource()
   43. String.prototype.toString()
   44. String.prototype.toUpperCase()
   45. String.prototype.trim()
   46. String.prototype.trimEnd()
   47. String.prototype.trimStart()
   48. String.prototype.valueOf()
   49. String.prototype[@@iterator]()
   50. String.raw()
5. 继承：
6. Function
7. 特性
   1. Function.arguments
   2. Function.caller
   3. Function.displayName
   4. Function.length
   5. Function.name
8. 方法
   1. Function.prototype.apply()
   2. Function.prototype.bind()
   3. Function.prototype.call()
   4. Function.prototype.toSource()
   5. Function.prototype.toString()
9. Object
10. 特性
    1. Object.prototype.__proto__
    2. Object.prototype.constructor
11. 方法
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.valueOf()
    12. Object.setPrototypeOf()