CKTIS / JavaScript
String.prototype.at — een UTF-16-code-eenheid op index lezen
String.prototype.at(index) retourneert een tekenreeks met één UTF-16-code-eenheid. Negatieve indices tellen vanaf het einde; een positie buiten het bereik retourneert undefined.
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.at(index)String.prototype.at(index) leest één UTF-16-code-eenheid zonder de tekenreeks te wijzigen. Indices beginnen bij 0; -1 betekent de laatste eenheid en -2 de op een na laatste. Het resultaat is een tekenreeks met lengte 1, of undefined als de berekende positie buiten het bereik valt. Bij een lege tekenreeks retourneert de methode undefined als de omzetting van de index slaagt. De index wordt omgezet voordat wordt gecontroleerd of de positie binnen het bereik valt, dus "".at(0n) gooit een TypeError.
Het argument wordt naar een geheel getal omgezet door het fractionele deel richting nul af te kappen. Een weggelaten argument, undefined en NaN betekenen index 0; oneindigheden leveren undefined op. Bij een negatieve index is de positie na conversie string.length + index.
Anders dan at() telt charAt() bij negatieve indices niet terug vanaf het einde en retourneert het buiten het bereik "". De expressie text[-1] leest een eigenschap met de naam "-1", niet de laatste eenheid van de tekenreeks.
Een UTF-16-code-eenheid is niet noodzakelijk een volledig Unicode-teken of een teken dat een gebruiker als één geheel ervaart: "😀".at(0) retourneert alleen de eerste helft van een surrogaatpaar. De methode hoort bij ECMAScript 2022, niet bij een browser-API. De specificatie legt niet vast welke browserversies ondersteuning bieden; controleer vóór implementatie de doelomgevingen, bijvoorbeeld met typeof String.prototype.at === "function".
Voorbeelden
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);Resultaat
J t p undefined true 1
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.