WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

String.prototype.codePointAt — einen Codepoint auslesen

Die Methode codePointAt(pos) gibt den Zahlenwert des Codepoints zurück, der an einem angegebenen UTF-16-Index beginnt. Sie erkennt Surrogatpaare, doch der Index bezeichnet weiterhin eine Codeeinheit und nicht das nächste auf dem Bildschirm sichtbare Zeichen.

Version: 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 liest den Codepoint am nullbasierten Index pos aus. Die Methode gibt eine Number im Bereich 0–0x10FFFF zurück oder undefined, wenn der Index außerhalb des Strings liegt. Der String wird nicht verändert.

Indizes und length beziehen sich auf UTF-16-Codeeinheiten. Beginnt an dem Index ein gültiges Surrogatpaar, verbindet die Methode dessen zwei Einheiten zu einem Codepoint. Andernfalls gibt sie den Wert einer einzelnen Einheit zurück, auch bei einem isolierten Surrogat. Ein Aufruf am zweiten Element eines Paars gibt den Wert des nachgestellten Surrogats zurück; die Methode springt nicht zum Anfang des Paars zurück. charCodeAt dagegen liest immer eine Einheit und gibt außerhalb des Strings NaN zurück.

Vor der Bereichsprüfung wandelt die Methode pos mit ToIntegerOrInfinity um: Ein ausgelassenes Argument oder NaN bedeutet 0, und Nachkommastellen werden in Richtung null abgeschnitten. Ein resultierender Index, der negativ oder unendlich ist oder nicht kleiner als length ist, ergibt undefined. Bei einem leeren String liegt jeder erfolgreich umgewandelte Index außerhalb des gültigen Bereichs. Löst die Umwandlung eine Ausnahme aus, wird sie auch bei einem leeren String weitergegeben: "".codePointAt(0n) löst beispielsweise einen TypeError aus.

Behandle das Erhöhen des Indexes um eins nicht als Schritt durch Codepoints: So kann man in die Mitte eines Paars gelangen. Ein Codepoint muss außerdem nicht einem vollständigen, auf dem Bildschirm sichtbaren Zeichen entsprechen. Dies ist eine ECMAScript-Methode, keine Browser-API; der Standard allein belegt nicht, dass sie in einem bestimmten Browser unterstützt wird.

Beispiele

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

Ergebnis

4
128512
55357
56832
undefined

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen