CKTIS / JavaScript
String.prototype.charAt — unità di codice UTF-16 a un indice
Il metodo charAt() restituisce una stringa contenente un’unità di codice UTF-16 all’indice a base zero, oppure una stringa vuota se l’indice è fuori dall’intervallo valido. Non garantisce di restituire un carattere 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.charAt(index)String.prototype.charAt legge l’unità di codice UTF-16 all’indice a base zero. Restituisce un valore primitivo di tipo string: una stringa lunga un’unità di codice oppure "" se l’indice è fuori dall’intervallo valido. Non modifica la stringa originale.
L’argomento index viene convertito con ToIntegerOrInfinity: le frazioni vengono troncate verso zero, mentre un argomento omesso, undefined e NaN corrispondono all’indice 0. Dopo la conversione, un indice negativo non conta all’indietro dalla fine: produce "". Anche entrambi gli infiniti producono "".
Un’unità di codice non è necessariamente un punto di codice Unicode completo né un carattere percepito dall’utente. L’emoji nell’esempio occupa due unità di codice; text.charAt(1) restituisce solo il suo primo surrogato. Non usare questo metodo per estrarre caratteri visivi completi.
Il metodo rifiuta prima null e undefined come valore di this, generando un TypeError, e poi converte il ricevente in una stringa. Si può quindi prendere in prestito, per esempio con String.prototype.charAt.call(123, 1), che restituisce "2".
Esempi
const text = "A\uD83D\uDE00B";
console.log(text.charAt(0));
console.log(text.charAt());
console.log(text.charAt(3.9));
console.log(JSON.stringify(text.charAt(-1)));
console.log(JSON.stringify(text.charAt(4)));
console.log(text.charAt(1) === "\uD83D");Risultato
A A B "" "" true
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.