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

CKTIS / JavaScript

String.fromCodePoint — създаване на текст от кодови точки

String.fromCodePoint създава низ от Unicode кодови точки, включително стойности над 0xFFFF. Автоматично ги кодира като UTF-16; невалидните числови стойности причиняват RangeError.

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

Синтаксис

String.fromCodePoint(...codePoints)

String.fromCodePoint(...codePoints) е статичен метод на String, а не метод на отделен низ. Връща низ, съдържащ подадените кодови точки в реда на аргументите. Без аргументи връща "".

Всеки аргумент се преобразува чрез ToNumber. Резултатът трябва да е цяло число от 0 до 0x10FFFF включително. Дроби, NaN, безкрайности и стойности извън този диапазон причиняват RangeError. Аргументи от тип BigInt или Symbol причиняват TypeError при преобразуването.

За разлика от String.fromCharCode, която приема UTF-16 кодови единици, String.fromCodePoint приема цели кодови точки. Стойност над 0xFFFF се кодира като сурогатна двойка, което увеличава .length на низа с две. .length брои кодови единици, а не кодови точки или видими знаци.

Методът приема и сурогатни стойности 0xD800–0xDFFF; следователно не гарантира правилно формиран UTF-16. Това е API на езика ECMAScript, а не API на браузъра. Провери наличността в целевата среда с typeof String.fromCodePoint === "function".

Примери

const text = String.fromCodePoint(0x41, 0x1F600);
console.log(text);
console.log(text.length);
console.log(text.codePointAt(1) === 0x1F600);
console.log(String.fromCodePoint() === "");

Резултат

A😀
3
true
true

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

Източници