CKTIS / JavaScript
String.prototype.codePointAt — leggere un punto di codice
Il metodo codePointAt(pos) restituisce il valore numerico del punto di codice che inizia all’indice UTF-16 specificato. Riconosce le coppie di surrogati, ma l’indice identifica comunque un’unità di codice, non il carattere successivo visibile sullo schermo.
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.codePointAt(pos)String.prototype.codePointAt legge il punto di codice all’indice pos, a partire da zero. Restituisce un Number nell’intervallo 0–0x10FFFF oppure undefined se l’indice è fuori dalla stringa. Non modifica la stringa.
Gli indici e length si riferiscono alle unità di codice UTF-16. Se all’indice inizia una coppia di surrogati valida, il metodo combina le due unità in un unico punto di codice. Altrimenti restituisce il valore di una singola unità, anche se si tratta di un surrogato isolato. Se viene chiamato sul secondo elemento di una coppia, restituisce il valore del surrogato finale; non torna all’inizio della coppia. Al contrario, charCodeAt legge sempre una sola unità e restituisce NaN fuori dalla stringa.
Il metodo converte pos tramite ToIntegerOrInfinity prima di controllare i limiti: se l’argomento è omesso o vale NaN, equivale a 0; le parti frazionarie vengono troncate verso zero. Se l’indice risultante è negativo, infinito o non è minore di length, il risultato è undefined. Per una stringa vuota, ogni indice ottenuto dopo una conversione riuscita è fuori dai limiti. Se la conversione genera un’eccezione, questa si propaga anche per una stringa vuota: per esempio, "".codePointAt(0n) genera un TypeError.
Non considerare l’incremento dell’indice di uno come un avanzamento tra punti di codice: in questo modo si può raggiungere il centro di una coppia. Inoltre, un punto di codice non deve necessariamente corrispondere a un carattere intero visibile sullo schermo. È un metodo ECMAScript, non un’API del browser; il solo standard non attesta il supporto in uno specifico browser.
Esempi
const text = "A\u{1F600}B";
console.log(text.length);
console.log(text.codePointAt(1));
console.log(text.charCodeAt(1));
console.log(text.codePointAt(2));
console.log(text.codePointAt(4));Risultato
4 128512 55357 56832 undefined
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.