CKTIS / JavaScript
String.fromCodePoint — ustvarjanje besedila iz kodnih točk
String.fromCodePoint ustvari niz iz kodnih točk Unicode, tudi iz vrednosti nad 0xFFFF. Samodejno jih kodira kot UTF-16; neveljavne številske vrednosti povzročijo RangeError.
Različica: 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) je statična metoda objekta String, ne metoda posameznega niza. Vrne niz z navedenimi kodnimi točkami v vrstnem redu argumentov. Brez argumentov vrne "".
Vsak argument se pretvori z ToNumber. Rezultat mora biti celo število od 0 do vključno 0x10FFFF. Ulomki, NaN, neskončnosti in vrednosti zunaj obsega povzročijo RangeError. Argumenti tipa BigInt ali Symbol med pretvorbo povzročijo TypeError.
Za razliko od String.fromCharCode, ki sprejema kodne enote UTF-16, String.fromCodePoint sprejema cele kodne točke. Vrednost nad 0xFFFF se kodira kot nadomestniški par, zato se .length niza poveča za dve. .length šteje kodne enote, ne kodnih točk ali vidnih znakov.
Metoda sprejema tudi nadomestniške vrednosti 0xD800–0xDFFF; zato ne zagotavlja pravilno oblikovanega UTF-16. To je API jezika ECMAScript, ne API brskalnika. Razpoložljivost v ciljnem okolju preveri z typeof String.fromCodePoint === "function".
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.