Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti