Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

String.prototype.codePointAt — čitanje kodne točke

Metoda codePointAt(pos) vraća brojčanu vrijednost kodne točke koja počinje na zadanom UTF-16 indeksu. Prepoznaje surogatne parove, ali indeks i dalje označava kodnu jedinicu, a ne sljedeći znak vidljiv na zaslonu.

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

String.prototype.codePointAt čita kodnu točku na indeksu pos, koji počinje od nule. Vraća Number u rasponu 0–0x10FFFF ili undefined ako je indeks izvan niza. Ne mijenja niz.

Indeksi i length odnose se na UTF-16 kodne jedinice. Ako na tom indeksu počinje valjan surogatni par, metoda spaja njegove dvije jedinice u jednu kodnu točku. U suprotnom vraća vrijednost jedne jedinice, uključujući i izdvojeni surogat. Poziv na drugom elementu para vraća vrijednost završnog surogata; ne vraća se na početak para. Nasuprot tome, charCodeAt uvijek čita jednu jedinicu i izvan niza vraća NaN.

Metoda pretvara pos pomoću ToIntegerOrInfinity prije provjere granica: izostavljeni argument ili NaN znači 0, a decimalni se dio odbacuje prema nuli. Rezultirajući indeks koji je negativan, beskonačan ili nije manji od length daje undefined. U praznom nizu svaki je indeks dobiven uspješnom pretvorbom izvan raspona. Ako pretvorba izazove iznimku, ona se prosljeđuje i za prazan niz: primjerice, "".codePointAt(0n) izaziva iznimku TypeError.

Nemoj povećanje indeksa za jedan smatrati prolaskom kroz kodne točke: tako se može doći u sredinu para. Kodna točka ne mora odgovarati cijelom znaku vidljivom na zaslonu. Ovo je metoda ECMAScript, a ne API preglednika; sam standard ne potvrđuje podršku u određenom pregledniku.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori