Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje