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

CKTIS / JavaScript

String.prototype.codePointAt — branje kodne točke

Metoda codePointAt(pos) vrne številsko vrednost kodne točke, ki se začne na podanem indeksu UTF-16. Prepozna surogatne pare, vendar indeks še vedno označuje kodno enoto, ne naslednjega znaka, vidnega na zaslonu.

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.codePointAt(pos)

String.prototype.codePointAt prebere kodno točko na indeksu pos, ki se začne z nič. Vrne Number v obsegu 0–0x10FFFF ali undefined, če je indeks zunaj niza. Niza ne spremeni.

Indeksi in length se nanašajo na kodne enote UTF-16. Če se na danem indeksu začne veljaven surogatni par, metoda združi njegovi enoti v eno kodno točko. Sicer vrne vrednost posamezne enote, tudi če gre za osamljen surogat. Klic na drugem elementu para vrne vrednost zaključnega surogata; ne vrne se na začetek para. Nasprotno charCodeAt vedno prebere eno enoto in zunaj niza vrne NaN.

Metoda pretvori pos z ToIntegerOrInfinity, preden preveri meje: izpuščen argument ali NaN pomeni 0, ulomljeni del pa se odreže proti ničli. Če je dobljeni indeks negativen, neskončen ali ni manjši od length, je rezultat undefined. Pri praznem nizu je vsak indeks, dobljen po uspešni pretvorbi, zunaj dovoljenega obsega. Če pretvorba sproži izjemo, se ta prenese naprej tudi pri praznem nizu: na primer "".codePointAt(0n) sproži izjemo TypeError.

Povečanja indeksa za ena ne obravnavaj kot pomikanja po kodnih točkah: tako lahko prideš na sredino para. Kodna točka tudi ne ustreza nujno celotnemu znaku, vidnemu na zaslonu. To je metoda ECMAScript, ne API brskalnika; sam standard ne potrjuje podpore v določenem brskalniku.

Primeri

const text = "A\u{1F600}B";
console.log(text.length);
console.log(text.codePointAt(1));
console.log(text.charCodeAt(1));
console.log(text.codePointAt(2));
console.log(text.codePointAt(4));

Rezultat

4
128512
55357
56832
undefined

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri