Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła