CKTIS / JavaScript
String.prototype.at — leggere un’unità di codice UTF-16 tramite indice
String.prototype.at(index) restituisce una stringa contenente un’unità di codice UTF-16. Gli indici negativi contano dalla fine; una posizione fuori intervallo restituisce undefined.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
string.at(index)String.prototype.at(index) legge un’unità di codice UTF-16 senza modificare la stringa. Gli indici iniziano da 0; -1 indica l’ultima unità e -2 la penultima. Il risultato è una stringa di lunghezza 1 oppure undefined se la posizione calcolata è fuori intervallo. Per una stringa vuota, il metodo restituisce undefined se la conversione dell’indice va a buon fine. L’indice viene convertito prima di controllare che la posizione rientri nell’intervallo, quindi "".at(0n) genera un TypeError.
L’argomento viene convertito in un numero intero troncando la parte frazionaria verso zero. Un argomento omesso, undefined e NaN corrispondono all’indice 0; gli infiniti restituiscono undefined. Per un indice negativo, dopo la conversione la posizione è string.length + index.
A differenza di at(), charAt() non conta all’indietro per gli indici negativi e restituisce "" fuori intervallo. L’espressione text[-1] legge una proprietà chiamata "-1", non l’ultima unità della stringa.
Un’unità di codice UTF-16 non è necessariamente un carattere Unicode completo né un carattere percepito dall’utente: "😀".at(0) restituisce solo la prima metà di una coppia di surrogati. Il metodo fa parte di ECMAScript 2022, non di un’API del browser. La specifica non stabilisce quali versioni dei browser lo supportino; verifica gli ambienti di destinazione prima della distribuzione, per esempio con typeof String.prototype.at === "function".
Esempi
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);Risultato
J t p undefined true 1
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.