Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

String.fromCharCode — creare testo da unità di codice UTF-16

String.fromCharCode crea una stringa dalle unità di codice UTF-16 fornite. Non interpreta gli argomenti come punti di codice Unicode completi: i caratteri fuori dal piano multilingue di base richiedono una coppia di surrogati.

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.fromCharCode(...codeUnits)

String.fromCharCode(...codeUnits) è un metodo statico del costruttore String, non un metodo di una singola stringa. Restituisce una nuova stringa contenente le unità di codice UTF-16 nell’ordine degli argomenti. Senza argomenti, restituisce "". Fa parte di ECMAScript, non di un’API del browser.

Ogni argomento subisce ToUint16: viene convertito in numero, la parte frazionaria viene troncata verso zero e il risultato viene ridotto modulo 65536. NaN, Infinity e -Infinity producono un’unità di codice con valore 0. I valori fuori intervallo non causano da soli un RangeError; per esempio, 0x10041 produce la stessa unità di codice di 65. La conversione di un Symbol o di un BigInt causa un TypeError.

Un’unità di codice non rappresenta sempre un carattere Unicode completo. Per il punto di codice 0x1F600, fornisci la coppia di surrogati 0xD83D, 0xDE00; il risultato ha una length pari a 2. Se gli input sono punti di codice, usa String.fromCodePoint. String.fromCharCode non convalida le coppie di surrogati e può creare un surrogato isolato.

L’esempio mostra lettere, una coppia di surrogati, la riduzione modulo e una chiamata senza argomenti. Non usare questo metodo come decodificatore di byte UTF-8.

Esempi

const text = String.fromCharCode(65, 66, 67);
const emoji = String.fromCharCode(0xD83D, 0xDE00);
console.log(text);
console.log(emoji === String.fromCodePoint(0x1F600));
console.log(emoji.length);
console.log(String.fromCharCode(0x10041) === "A");
console.log(String.fromCharCode() === "");

Risultato

ABC
true
2
true
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.

Fonti