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

CKTIS / JavaScript

String.fromCharCode — vytváření textu z kódových jednotek UTF-16

String.fromCharCode vytváří řetězec z dodaných kódových jednotek UTF-16. Argumenty neinterpretuje jako úplné kódové body Unicode: znaky mimo základní vícejazyčnou rovinu vyžadují pár náhradních znaků.

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.fromCharCode(...codeUnits)

String.fromCharCode(...codeUnits) je statická metoda konstruktoru String, nikoli metoda jednotlivého řetězce. Vrací nový řetězec obsahující kódové jednotky UTF-16 v pořadí argumentů. Bez argumentů vrací "". Patří do ECMAScriptu, nikoli do rozhraní API prohlížeče.

Každý argument prochází ToUint16: převede se na číslo, jeho desetinná část se zkrátí směrem k nule a výsledek se zredukuje modulo 65536. Hodnoty NaN, Infinity a -Infinity vytvoří kódovou jednotku s hodnotou 0. Hodnoty mimo rozsah samy o sobě nezpůsobí RangeError; například 0x10041 vytvoří stejnou kódovou jednotku jako 65. Převod hodnoty Symbol nebo BigInt způsobí TypeError.

Kódová jednotka ne vždy představuje celý znak Unicode. Pro kódový bod 0x1F600 zadejte pár náhradních znaků 0xD83D, 0xDE00; výsledek má length rovné 2. Pokud jsou vstupy kódové body, použijte String.fromCodePoint. String.fromCharCode párování náhradních znaků nekontroluje a může vytvořit osamocený náhradní znak.

Příklad ukazuje písmena, pár náhradních znaků, redukci modulo a volání bez argumentů. Nepoužívejte tuto metodu jako dekodér bajtů UTF-8.

Příklady

const text = String.fromCharCode(65, 66, 67);
const emoji = String.fromCharCode(0xD83D, 0xDE00);
console.log(text);
console.log(emoji === String.fromCodePoint(0x1F600));
console.log(emoji.length);
console.log(String.fromCharCode(0x10041) === "A");
console.log(String.fromCharCode() === "");

Výsledek

ABC
true
2
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