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.