Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

String.prototype.repeat — powtarzanie tekstu

Metoda repeat(count) zwraca tekst złożony z kolejnych kopii napisu, bez zmiany oryginału. Argument count typu Symbol lub BigInt powoduje TypeError podczas konwersji numerycznej. Jeśli wynikiem konwersji i obcięcia części ułamkowej jest ujemna liczba całkowita albo dodatnia lub ujemna nieskończoność, metoda zgłasza RangeError.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

str.repeat(count)

String.prototype.repeat zwraca napis złożony z count kopii tekstu, połączonych bez separatora. Oryginał pozostaje bez zmian. Powtarzane są jednostki kodowe UTF-16, a nie oddzielnie interpretowane znaki widoczne na ekranie.

Argument count podlega konwersji numerycznej i obcięciu części ułamkowej w kierunku zera: 2.9 daje dwa powtórzenia, a -0.5 daje pusty napis. 0, NaN oraz pominięty argument również dają pusty napis. Wartość typu Symbol lub BigInt powoduje TypeError podczas konwersji numerycznej. Jeśli wynikiem konwersji i obcięcia jest ujemna liczba całkowita, Infinity lub -Infinity, metoda zgłasza RangeError; dotyczy to także pustego tekstu wejściowego.

Metodę można pożyczyć przez String.prototype.repeat.call(value, count): odbiorca jest konwertowany na tekst, ale null i undefined powodują TypeError. Dla danych zewnętrznych ograniczaj liczbę powtórzeń, aby nie żądać nadmiernie dużego wyniku.

Przykłady

const text = "ab";
console.log(text.repeat(3));
console.log(JSON.stringify(text.repeat(0)));
console.log(text.repeat(2.9));
console.log(text);
try {
  text.repeat(-1);
} catch (error) {
  console.log(error.name);
}

Wynik

ababab
""
abab
ab
RangeError

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła