在线文档教程

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; } }

规范

SpecificationStatusComment
ECMAScript 2015 (6th Edition, ECMA-262)The definition of 'String.prototype.repeat' in that specification.StandardInitial definition.
ECMAScript Latest Draft (ECMA-262)The definition of 'String.prototype.repeat' in that specification.Living Standard

浏览器兼容性

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic Support41(Yes)24No(Yes)9

FeatureAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic SupportNo36(Yes)24No(Yes)9