string.repeat
string.repeat
repeat()
构造并返回一个新字符串,该字符串包含被连接在一起的指定数量的字符串的副本。
语法
/**
* str: String
* count: Number
*/
let resultString = str.repeat(count
参数
count
介于0和正无穷大之间的整数 : [0, +∞) 。表示在新构造的字符串中重复了多少遍原字符串。
返回值
包含指定字符串的指定数量副本的新字符串。
异常
RangeError
: 重复次数不能为负数。
RangeError
: 重复次数必须小于 infinity,且长度不会大于最长的字符串。
示例
'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)
Polyfill
此方法已添加到ECMAScript 2015规范中,并且可能尚未在所有JavaScript实现中可用。然而,你可以使用以下代码段对 String.prototype.repeat() 进行填充:
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;
count = +count;
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 rpt = '';
for (var i = 0; i < count; i++) {
rpt += str;
}
return rpt;
}
}
规范
Specification | Status | Comment |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262)The definition of 'String.prototype.repeat' in that specification. | Standard | Initial definition. |
ECMAScript Latest Draft (ECMA-262)The definition of 'String.prototype.repeat' in that specification. | Living Standard | |
浏览器兼容性
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic Support | 41 | (Yes) | 24 | No | (Yes) | 9 |
Feature | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic Support | No | 36 | (Yes) | 24 | No | (Yes) | 9 |