CKTIS / JavaScript
String.fromCodePoint — vytváření textu z kódových bodů
String.fromCodePoint vytváří řetězec z kódových bodů Unicode, včetně hodnot větších než 0xFFFF. Automaticky je kóduje jako UTF-16; neplatné číselné hodnoty způsobí RangeError.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
String.fromCodePoint(...codePoints)String.fromCodePoint(...codePoints) je statická metoda objektu String, nikoli metoda jednotlivého řetězce. Vrací řetězec obsahující zadané kódové body v pořadí argumentů. Bez argumentů vrací "".
Každý argument se převede pomocí ToNumber. Výsledkem musí být celé číslo od 0 do 0x10FFFF včetně. Zlomky, NaN, nekonečna a hodnoty mimo rozsah způsobí RangeError. Argumenty typu BigInt nebo Symbol způsobí při převodu TypeError.
Na rozdíl od String.fromCharCode, která přijímá jednotky kódu UTF-16, přijímá String.fromCodePoint celé kódové body. Hodnota větší než 0xFFFF se zakóduje jako náhradní pár, takže se .length řetězce zvýší o dvě. .length počítá jednotky kódu, nikoli kódové body nebo viditelné znaky.
Metoda přijímá také náhradní hodnoty 0xD800–0xDFFF; nezaručuje proto správně utvořené UTF-16. Jde o API jazyka ECMAScript, nikoli o API prohlížeče. Dostupnost v cílovém prostředí lze ověřit pomocí typeof String.fromCodePoint === "function".
Pří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ýsledek
A😀 3 true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.