CKTIS / JavaScript
String.prototype.charCodeAt — valore dell’unità di codice UTF-16
Il metodo charCodeAt restituisce il valore numerico dell’unità di codice UTF-16 all’indice specificato, oppure NaN se l’indice è fuori dalla stringa. Non restituisce sempre un punto di codice Unicode completo.
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.charCodeAt(index)String.prototype.charCodeAt legge una singola unità di codice UTF-16. Gli indici partono da 0. Se l’indice rientra nell’intervallo valido, il risultato è un Number compreso tra 0 e 65535. Il metodo non modifica la stringa.
L’argomento index viene convertito in un numero e l’eventuale parte frazionaria viene troncata verso zero. Se l’argomento è omesso, oppure è undefined o NaN, l’indice è 0. Il metodo verifica l’intervallo solo dopo che la conversione è riuscita. Se l’indice ottenuto è fuori intervallo, come nel caso di un intero negativo o di un valore infinito, il metodo restituisce NaN. In una stringa vuota, ogni indice ottenuto dopo la conversione è fuori intervallo, ma "".charCodeAt(0n) genera un TypeError durante la conversione. Gli indici negativi non contano a partire dalla fine.
Non confondere un’unità di codice con un punto di codice Unicode. Nell’esempio, A occupa un’unità di codice, mentre l’emoji ne occupa due: 55357 e 56832. charCodeAt le legge separatamente. Usa codePointAt per leggere il punto di codice che inizia a un indice specifico; l’indice continua a essere misurato in unità di codice UTF-16.
È un metodo della libreria standard ECMAScript, non un’API Web del browser. Può operare anche su altri valori dopo la conversione in stringa con String.prototype.charCodeAt.call(value, index), ma se value è null o undefined viene generato un TypeError.
Esempi
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());Risultato
65 55357 56832 NaN 65
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.