Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

String.fromCodePoint — vytváranie textu z kódových bodov

String.fromCodePoint vytvára reťazec z kódových bodov Unicode vrátane hodnôt väčších ako 0xFFFF. Automaticky ich kóduje ako UTF-16; neplatné číselné hodnoty spôsobia RangeError.

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

Syntax

String.fromCodePoint(...codePoints)

String.fromCodePoint(...codePoints) je statická metóda objektu String, nie metóda jednotlivého reťazca. Vráti reťazec obsahujúci zadané kódové body v poradí argumentov. Bez argumentov vráti "".

Každý argument sa prevedie pomocou ToNumber. Výsledkom musí byť celé číslo od 0 do 0x10FFFF vrátane. Zlomky, NaN, nekonečná a hodnoty mimo rozsahu spôsobia RangeError. Argumenty typu BigInt alebo Symbol spôsobia počas prevodu TypeError.

Na rozdiel od String.fromCharCode, ktorá prijíma jednotky kódu UTF-16, prijíma String.fromCodePoint celé kódové body. Hodnota väčšia ako 0xFFFF sa zakóduje ako náhradný pár, čím sa .length reťazca zvýši o dva. .length počíta jednotky kódu, nie kódové body ani viditeľné znaky.

Metóda prijíma aj náhradné hodnoty 0xD800–0xDFFF; nezaručuje teda správne vytvorené UTF-16. Ide o API jazyka ECMAScript, nie o API prehliadača. Dostupnosť v cieľovom prostredí možno overiť pomocou typeof String.fromCodePoint === "function".

Príklady

const text = String.fromCodePoint(0x41, 0x1F600);
console.log(text);
console.log(text.length);
console.log(text.codePointAt(1) === 0x1F600);
console.log(String.fromCodePoint() === "");

Výsledok

A😀
3
true
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje