Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【JavaScript ECMAScript】String::String.prototype.repeatインスタンスメソッドの使い方

String.prototype.repeat()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

String.prototype.repeat()メソッドは、指定された回数だけ文字列を繰り返して新しい文字列を生成するメソッドです。このメソッドは、JavaScriptの組み込みオブジェクトであるStringのインスタンスに対して使用できます。

具体的には、このメソッドを呼び出す文字列の内容を、引数で与えられた繰り返し回数だけ連結した新しい文字列を返します。引数として指定する繰り返し回数は、0以上の整数である必要があります。例えば、「Hello」という文字列に対してrepeat(3)を実行すると、「HelloHelloHello」という結果が得られます。もし繰り返し回数に0を指定した場合、空の文字列("")が返されます。繰り返し回数に負の数やInfinityなど、無効な値を指定した場合は、RangeErrorというエラーが発生しますので注意が必要です。

このメソッドの重要な特性として、元の文字列自体は一切変更されない「非破壊的」な操作であることが挙げられます。常に、繰り返し処理によって生成された新しい文字列が結果として返されます。そのため、文字列を特定のパターンで繰り返し表示したり、整形したりする際に非常に便利です。システム開発において、動的に文字列を生成する場面などで、簡潔かつ効率的に文字列を操作するために活用されます。

公式リファレンス: String.prototype.repeat()

構文(syntax)

1"use strict";
2
3const originalString = "JavaScript ";
4const repeatedString = originalString.repeat(3);
5console.log(repeatedString); // "JavaScript JavaScript JavaScript "

引数(parameters)

count

  • count: number: 繰り返し回数を指定する非負整数。0以上の数値を指定してください。

戻り値(return)

String

指定された文字列を指定された回数だけ繰り返した新しい文字列を返します。

関連コンテンツ

関連プログラミング言語