CKTIS / JavaScript
String.fromCodePoint — tworzenie tekstu z punktów kodowych
String.fromCodePoint tworzy napis z punktów kodowych Unicode, także większych niż 0xFFFF. Automatycznie zapisuje je w UTF-16; nieprawidłowe wartości liczbowe powodują 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
String.fromCodePoint(...codePoints)String.fromCodePoint(...codePoints) to statyczna metoda String, a nie metoda pojedynczego napisu. Zwraca napis złożony z podanych punktów kodowych w kolejności argumentów. Bez argumentów zwraca "".
Każdy argument jest przekształcany przez ToNumber. Wynik musi być liczbą całkowitą z zakresu 0–0x10FFFF włącznie. Ułamki, NaN, nieskończoności i wartości spoza zakresu powodują RangeError. Argumenty typu BigInt lub Symbol powodują TypeError podczas konwersji.
W odróżnieniu od String.fromCharCode, które przyjmuje jednostki kodowe UTF-16, String.fromCodePoint przyjmuje całe punkty kodowe. Wartość większa niż 0xFFFF jest zapisywana jako para surogatów, więc zwiększa .length napisu o dwa. .length liczy jednostki kodowe, nie punkty kodowe ani widoczne znaki.
Metoda dopuszcza również wartości surogatów 0xD800–0xDFFF; nie gwarantuje zatem poprawnie uformowanego UTF-16. To API języka ECMAScript, nie API przeglądarki. W środowisku docelowym dostępność można sprawdzić przez typeof String.fromCodePoint === "function".
Przykłady
const text = String.fromCodePoint(0x41, 0x1F600);
console.log(text);
console.log(text.length);
console.log(text.codePointAt(1) === 0x1F600);
console.log(String.fromCodePoint() === "");Wynik
A😀 3 true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.