KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

String.prototype.charCodeAt — waarde van UTF-16-code-eenheid

De methode charCodeAt geeft de numerieke waarde van de UTF-16-code-eenheid op een index terug, of NaN als de index buiten de string valt. De methode geeft niet altijd een volledig Unicode-codepunt terug.

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.charCodeAt(index)

String.prototype.charCodeAt leest één UTF-16-code-eenheid. Indexen beginnen bij 0. Valt de index binnen het bereik van de string, dan is het resultaat een Number van 0 tot en met 65535. De methode wijzigt de string niet.

Het argument index wordt naar een getal omgezet; een eventueel fractioneel deel wordt naar nul afgekapt. Een weggelaten argument, undefined en NaN betekenen index 0. De methode controleert het bereik pas als de omzetting is geslaagd. Valt de resulterende index buiten het bereik, zoals bij een negatief geheel getal of oneindigheid, dan geeft de methode NaN terug. Bij een lege string valt elke index die na omzetting ontstaat buiten het bereik, maar "".charCodeAt(0n) veroorzaakt tijdens de omzetting een TypeError. Negatieve indexen tellen niet vanaf het einde.

Verwar een code-eenheid niet met een Unicode-codepunt. In het voorbeeld neemt A één code-eenheid in, terwijl de emoji er twee inneemt: 55357 en 56832. charCodeAt leest ze afzonderlijk. Gebruik codePointAt om het codepunt te lezen dat op een bepaalde index begint; de index wordt nog steeds gemeten in UTF-16-code-eenheden.

Dit is een methode uit de ECMAScript-standaardbibliotheek, geen browser-Web-API. De methode kan ook op andere waarden werken na omzetting naar een string via String.prototype.charCodeAt.call(value, index), maar als value null of undefined is, ontstaat een TypeError.

Voorbeelden

const text = "A\uD83D\uDE00";
console.log(text.charCodeAt(0));
console.log(text.charCodeAt(1));
console.log(text.charCodeAt(2));
console.log(text.charCodeAt(3));
console.log(text.charCodeAt());

Resultaat

65
55357
56832
NaN
65

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