KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

String.prototype.codePointAt — een codepoint uitlezen

De methode codePointAt(pos) geeft de numerieke waarde terug van het codepoint dat op een opgegeven UTF-16-index begint. De methode herkent surrogateparen, maar de index verwijst nog steeds naar een code-eenheid en niet naar het volgende teken dat op het scherm zichtbaar is.

Versie: 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 leest het codepoint op de nulgebaseerde index pos. De methode geeft een Number in het bereik 0–0x10FFFF terug, of undefined als de index buiten de string valt. De string wordt niet gewijzigd.

Indices en length verwijzen naar UTF-16-code-eenheden. Begint op de index een geldig surrogaatpaar, dan combineert de methode de twee eenheden tot één codepoint. Anders geeft de methode de waarde van één eenheid terug, ook bij een los surrogaat. Een aanroep op het tweede element van een paar geeft de waarde van het afsluitende surrogaat terug; de methode gaat niet terug naar het begin van het paar. charCodeAt leest daarentegen altijd één eenheid en geeft buiten de string NaN terug.

De methode zet pos met ToIntegerOrInfinity om voordat ze controleert of de index binnen het bereik valt: een weggelaten argument of NaN betekent 0, en het fractionele deel wordt naar nul afgekapt. Een resulterende index die negatief of oneindig is, of niet kleiner is dan length, levert undefined op. Bij een lege string valt elke succesvol omgezette index buiten het bereik. Als de omzetting een uitzondering opwerpt, wordt die ook bij een lege string doorgegeven: "".codePointAt(0n) werpt bijvoorbeeld een TypeError op.

Beschouw het met één verhogen van de index niet als een stap door codepoints: zo kun je midden in een paar terechtkomen. Een codepoint hoeft bovendien niet overeen te komen met een volledig teken dat op het scherm zichtbaar is. Dit is een ECMAScript-methode, geen browser-API; de standaard alleen bevestigt niet dat een bepaalde browser de methode ondersteunt.

Voorbeelden

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

Resultaat

4
128512
55357
56832
undefined

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen