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.