Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri