CKTIS / JavaScript
String.prototype.at — UTF-16-Codeeinheit per Index lesen
String.prototype.at(index) gibt eine Zeichenfolge mit einer UTF-16-Codeeinheit zurück. Negative Indizes zählen vom Ende; bei einer Position außerhalb des gültigen Bereichs wird undefined zurückgegeben.
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.at(index)String.prototype.at(index) liest eine UTF-16-Codeeinheit, ohne die Zeichenfolge zu ändern. Indizes beginnen bei 0; -1 steht für die letzte Einheit und -2 für die vorletzte. Das Ergebnis ist eine Zeichenfolge der Länge 1 oder undefined, wenn die berechnete Position außerhalb des gültigen Bereichs liegt. Bei einer leeren Zeichenfolge gibt die Methode undefined zurück, wenn die Umwandlung des Index gelingt. Der Index wird vor der Bereichsprüfung umgewandelt, daher löst "".at(0n) einen TypeError aus.
Das Argument wird in eine ganze Zahl umgewandelt, indem der Nachkommateil gegen null abgeschnitten wird. Ein ausgelassenes Argument, undefined und NaN bedeuten Index 0; bei Unendlichkeiten wird undefined zurückgegeben. Bei einem negativen Index lautet die Position nach der Umwandlung string.length + index.
Anders als at() zählt charAt() bei negativen Indizes nicht vom Ende aus und gibt außerhalb des gültigen Bereichs "" zurück. Der Ausdruck text[-1] liest eine Eigenschaft namens "-1", nicht die letzte Einheit der Zeichenfolge.
Eine UTF-16-Codeeinheit ist nicht unbedingt ein vollständiges Unicode-Zeichen oder ein vom Nutzer wahrgenommenes Zeichen: "😀".at(0) gibt nur die erste Hälfte eines Surrogatpaars zurück. Die Methode gehört zu ECMAScript 2022, nicht zu einer Browser-API. Die Spezifikation legt keine unterstützenden Browserversionen fest; prüfe vor der Bereitstellung die Zielumgebungen, zum Beispiel mit typeof String.prototype.at === "function".
Beispiele
const text = "JavaScript";
console.log(text.at(0));
console.log(text.at(-1));
console.log(text.at(-2));
console.log(text.at(10));
console.log(text.charAt(10) === "");
console.log("😀".at(0).length);Ergebnis
J t p undefined true 1
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.