Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

String.prototype.codePointAt — čtení kódového bodu

Metoda codePointAt(pos) vrací číselnou hodnotu kódového bodu, který začíná na zadaném indexu UTF-16. Rozpoznává páry náhradních kódových jednotek, ale index stále označuje kódovou jednotku, nikoli další znak viditelný na obrazovce.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

string.codePointAt(pos)

String.prototype.codePointAt čte kódový bod na indexu pos počítaném od nuly. Vrací hodnotu typu Number v rozsahu 0–0x10FFFF, nebo undefined, pokud je index mimo řetězec. Řetězec nemění.

Indexy a length se vztahují ke kódovým jednotkám UTF-16. Pokud na daném indexu začíná platný pár náhradních kódových jednotek, metoda spojí obě jednotky do jednoho kódového bodu. Jinak vrátí hodnotu jediné jednotky, a to i v případě osamocené náhradní jednotky. Při volání na indexu druhé jednotky v páru metoda vrátí hodnotu této koncové náhradní jednotky; nevrátí se na začátek páru. Naproti tomu charCodeAt vždy čte jednu jednotku a mimo řetězec vrací NaN.

Před kontrolou rozsahu metoda převede pos pomocí ToIntegerOrInfinity: vynechaný argument nebo NaN znamená 0 a zlomková část se odřízne směrem k nule. Pokud je výsledný index záporný, nekonečný nebo není menší než length, metoda vrátí undefined. U prázdného řetězce je každý index získaný úspěšným převodem mimo rozsah. Pokud převod vyvolá výjimku, ta se předá dál i u prázdného řetězce: například "".codePointAt(0n) vyvolá výjimku TypeError.

Nepovažujte zvýšení indexu o jedna za postup po kódových bodech: můžete se tak dostat doprostřed páru. Kódový bod navíc nemusí odpovídat celému znaku viditelnému na obrazovce. Jde o metodu ECMAScript, nikoli o API prohlížeče; samotný standard nepotvrzuje podporu v konkrétním prohlížeči.

Příklady

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));

Výsledek

4
128512
55357
56832
undefined

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje