String.prototype.repeat()

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年9月以降、すべてのブラウザーで利用可能です。

repeat() は String 値のメソッドで、呼び出し元の文字列を指定した数だけコピーして結合した新しい文字列を構築して返します。

試してみましょう

const mood = "Happy! ";

console.log(`I feel ${mood.repeat(3)}`);
// 予想される結果: "I feel Happy! Happy! Happy! "

構文

repeat(count)

引数

count

0 から Infinity までの間の整数で、文字列を繰り返す数を示します。

返値

与えられた文字列の指定した回数分のコピーを含む新しい文字列です。

例外

RangeError

count が負の数であるか、 count が文字列の最大長を超えた場合に発生します。

例

repeat() の使用

js
"abc".repeat(-1); // RangeError
"abc".repeat(0); // ''
"abc".repeat(1); // 'abc'
"abc".repeat(2); // 'abcabc'
"abc".repeat(3.5); // 'abcabcabc' （小数点以下は切り捨てられます）
"abc".repeat(1 / 0); // RangeError

({ toString: () => "abc", repeat: String.prototype.repeat }).repeat(2);
// 'abcabc' （repeat() は汎用メソッドです）