WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

String.prototype.charCodeAt — UTF-16-Codeeinheitenwert

Die Methode charCodeAt gibt den Zahlenwert der UTF-16-Codeeinheit an einem Index zurück oder NaN, wenn der Index außerhalb des Strings liegt. Sie gibt nicht immer einen vollständigen Unicode-Codepunkt zurück.

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

String.prototype.charCodeAt liest eine UTF-16-Codeeinheit. Die Indizes beginnen bei 0. Liegt der Index im gültigen Bereich, ist das Ergebnis eine Number von 0 bis 65535. Die Methode verändert den String nicht.

Das Argument index wird in eine Zahl umgewandelt; ein vorhandener Nachkommateil wird gegen null abgeschnitten. Ein ausgelassenes Argument, undefined und NaN bedeuten den Index 0. Die Methode prüft den gültigen Bereich erst nach erfolgreicher Umwandlung. Liegt der resultierende Index außerhalb dieses Bereichs, etwa bei einer negativen ganzen Zahl oder bei Unendlichkeit, gibt die Methode NaN zurück. Bei einem leeren String liegt jeder resultierende Index außerhalb des gültigen Bereichs, aber "".charCodeAt(0n) löst bereits bei der Umwandlung einen TypeError aus. Negative Indizes zählen nicht vom Ende an.

Verwechsle eine Codeeinheit nicht mit einem Unicode-Codepunkt. Im Beispiel belegt A eine Codeeinheit, während das Emoji zwei belegt: 55357 und 56832. charCodeAt liest sie einzeln aus. Verwende codePointAt, um den Codepunkt zu lesen, der an einem bestimmten Index beginnt; der Index wird weiterhin in UTF-16-Codeeinheiten gemessen.

Dies ist eine Methode der ECMAScript-Standardbibliothek und keine browserbasierte Web-API. Sie kann nach einer String-Konvertierung auch auf andere Werte angewendet werden: String.prototype.charCodeAt.call(value, index). Ist value jedoch null oder undefined, wird ein TypeError ausgelöst.

Beispiele

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

Ergebnis

65
55357
56832
NaN
65

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