CKTIS / JavaScript
String.fromCodePoint — stvaranje teksta iz kodnih točaka
String.fromCodePoint stvara niz iz Unicode kodnih točaka, uključujući vrijednosti veće od 0xFFFF. Automatski ih kodira kao UTF-16; nevaljane numeričke vrijednosti uzrokuju RangeError.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
String.fromCodePoint(...codePoints)String.fromCodePoint(...codePoints) statička je metoda objekta String, a ne metoda pojedinačnog niza. Vraća niz koji sadrži navedene kodne točke redoslijedom argumenata. Bez argumenata vraća "".
Svaki se argument pretvara pomoću ToNumber. Rezultat mora biti cijeli broj od 0 do uključivo 0x10FFFF. Razlomci, NaN, beskonačnosti i vrijednosti izvan raspona uzrokuju RangeError. Argumenti tipa BigInt ili Symbol tijekom pretvorbe uzrokuju TypeError.
Za razliku od String.fromCharCode, koja prihvaća UTF-16 kodne jedinice, String.fromCodePoint prihvaća cijele kodne točke. Vrijednost veća od 0xFFFF kodira se kao surogatni par, pa se .length niza povećava za dva. .length broji kodne jedinice, a ne kodne točke ni vidljive znakove.
Metoda prihvaća i surogatne vrijednosti 0xD800–0xDFFF; stoga ne jamči ispravno oblikovan UTF-16. Ovo je API jezika ECMAScript, a ne API preglednika. Dostupnost u ciljnom okruženju provjeri pomoću typeof String.fromCodePoint === "function".
Primjeri
const text = String.fromCodePoint(0x41, 0x1F600);
console.log(text);
console.log(text.length);
console.log(text.codePointAt(1) === 0x1F600);
console.log(String.fromCodePoint() === "");Rezultat
A😀 3 true true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.