База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

String.fromCharCode — създаване на текст от UTF-16 кодови единици

String.fromCharCode създава низ от подадените UTF-16 кодови единици. Не тълкува аргументите като цели Unicode кодови точки: знаците извън основната многоезична равнина изискват сурогатна двойка.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

String.fromCharCode(...codeUnits)

String.fromCharCode(...codeUnits) е статичен метод на конструктора String, а не метод на отделен низ. Връща нов низ, съдържащ UTF-16 кодови единици в реда на аргументите. Без аргументи връща "". Методът е част от ECMAScript, а не от API на браузър.

Всеки аргумент преминава през ToUint16: преобразуване в число, отрязване на дробната част към нулата и редуциране по модул 65536. NaN, Infinity и -Infinity създават кодова единица със стойност 0. Стойностите извън диапазона сами по себе си не причиняват RangeError; например 0x10041 създава същата кодова единица като 65. Преобразуването на Symbol или BigInt причинява TypeError.

Една кодова единица не винаги представлява цял Unicode знак. За кодовата точка 0x1F600 подайте сурогатната двойка 0xD83D, 0xDE00; резултатът има length 2. Ако входните ви стойности са кодови точки, използвайте String.fromCodePoint. String.fromCharCode не проверява сдвояването на сурогатите и може да създаде самостоятелен сурогат.

Примерът показва букви, сурогатна двойка, редуциране по модул и извикване без аргументи. Не използвайте този метод като декодер на UTF-8 байтове.

Примери

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() === "");

Резултат

ABC
true
2
true
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници