Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

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

Metóda codePointAt(pos) vracia číselnú hodnotu kódového bodu, ktorý sa začína na zadanom indexe UTF-16. Rozpoznáva páry náhradných kódových jednotiek, ale index stále označuje kódovú jednotku, nie ďalší znak viditeľný na obrazovke.

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

Syntax

string.codePointAt(pos)

String.prototype.codePointAt číta kódový bod na indexe pos počítanom od nuly. Vráti hodnotu typu Number v rozsahu 0–0x10FFFF alebo undefined, ak je index mimo reťazca. Reťazec nemení.

Indexy a length sa vzťahujú na kódové jednotky UTF-16. Ak sa na danom indexe začína platný pár náhradných kódových jednotiek, metóda spojí obe jednotky do jedného kódového bodu. Inak vráti hodnotu jednej jednotky, a to aj pri osamotenej náhradnej jednotke. Pri volaní na indexe druhej jednotky v páre metóda vráti hodnotu tejto koncovej náhradnej jednotky; nevráti sa na začiatok páru. Naproti tomu charCodeAt vždy číta jednu jednotku a mimo reťazca vracia NaN.

Pred kontrolou rozsahu metóda prevedie pos pomocou ToIntegerOrInfinity: vynechaný argument alebo NaN znamená 0 a zlomková časť sa odsekne smerom k nule. Ak je výsledný index záporný, nekonečný alebo nie je menší ako length, metóda vráti undefined. Pri prázdnom reťazci je každý index získaný úspešným prevodom mimo rozsahu. Ak prevod vyvolá výnimku, tá sa šíri ďalej aj pri prázdnom reťazci: napríklad "".codePointAt(0n) vyvolá výnimku TypeError.

Nepovažuj zvýšenie indexu o jeden za postup po kódových bodoch: môžeš sa tak dostať do stredu páru. Kódový bod navyše nemusí zodpovedať celému znaku viditeľnému na obrazovke. Ide o metódu ECMAScript, nie o API prehliadača; samotný štandard nepotvrdzuje podporu v konkrétnom prehliadači.

Prí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ýsledok

4
128512
55357
56832
undefined

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje