KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

String.prototype.charAt — UTF-16-code-unit op een index

De methode charAt() geeft een string met één UTF-16-code-unit op de nulgebaseerde index terug, of een lege string als de index buiten het geldige bereik valt. De methode garandeert niet dat er een volledig Unicode-teken wordt teruggegeven.

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

String.prototype.charAt leest de UTF-16-code-unit op de nulgebaseerde index. De methode geeft een primitieve waarde van het type string terug: een string van één code-unit, of "" wanneer de index buiten het geldige bereik valt. De oorspronkelijke string wordt niet aangepast.

Het argument index wordt omgezet met ToIntegerOrInfinity: breuken worden naar nul afgekapt. Een weggelaten argument, undefined en NaN betekenen index 0. Een negatieve index telt na omzetting niet terug vanaf het einde, maar levert "" op. Ook beide oneindigheden leveren "" op.

Een code-unit is niet noodzakelijk een volledig Unicode-codepunt of een teken zoals de gebruiker dat ervaart. De emoji in het voorbeeld beslaat twee code-units; text.charAt(1) geeft alleen de eerste surrogate terug. Gebruik deze methode niet om volledige zichtbare tekens uit te halen.

De methode wijst eerst null en undefined als this af en gooit daarbij een TypeError; daarna zet ze de ontvanger om naar een string. Je kunt de methode daarom lenen, bijvoorbeeld met String.prototype.charAt.call(123, 1), dat "2" teruggeeft.

Voorbeelden

const text = "A\uD83D\uDE00B";
console.log(text.charAt(0));
console.log(text.charAt());
console.log(text.charAt(3.9));
console.log(JSON.stringify(text.charAt(-1)));
console.log(JSON.stringify(text.charAt(4)));
console.log(text.charAt(1) === "\uD83D");

Resultaat

A
A
B
""
""
true

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