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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.