CKTIS / JavaScript
String.prototype.charAt — UTF-16-Codeeinheit an einem Index
Die Methode charAt() gibt einen String mit einer UTF-16-Codeeinheit am nullbasierten Index zurück oder außerhalb des gültigen Bereichs einen leeren String. Sie garantiert nicht, dass ein vollständiges Unicode-Zeichen zurückgegeben wird.
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.charAt(index)String.prototype.charAt liest die UTF-16-Codeeinheit am nullbasierten Index aus. Die Methode gibt einen primitiven Wert vom Typ string zurück: einen String mit einer Codeeinheit oder "", wenn der Index außerhalb des gültigen Bereichs liegt. Der ursprüngliche String wird nicht verändert.
Das Argument index wird mit ToIntegerOrInfinity konvertiert: Nachkommastellen werden in Richtung null abgeschnitten. Ein ausgelassenes Argument, undefined und NaN entsprechen dem Index 0. Ein negativer Index zählt nach der Konvertierung nicht vom Ende aus rückwärts, sondern ergibt "". Auch beide Unendlichkeiten ergeben "".
Eine Codeeinheit ist nicht unbedingt ein vollständiger Unicode-Codepunkt oder ein vom Benutzer wahrgenommenes Zeichen. Das Emoji im Beispiel belegt zwei Codeeinheiten; text.charAt(1) gibt nur sein erstes Surrogat zurück. Verwende diese Methode nicht, um vollständige sichtbare Zeichen herauszulösen.
Die Methode weist zuerst null und undefined als this zurück und löst dabei einen TypeError aus. Anschließend konvertiert sie den Empfänger in einen String. Sie kann daher ausgeliehen werden, etwa mit String.prototype.charAt.call(123, 1), was "2" zurückgibt.
Beispiele
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");Ergebnis
A A B "" "" true
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.