CKTIS / JavaScript
String.fromCodePoint — creare testo dai punti di codice
String.fromCodePoint crea una stringa a partire da punti di codice Unicode, compresi i valori superiori a 0xFFFF. Li codifica automaticamente in UTF-16; i valori numerici non validi causano RangeError.
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.fromCodePoint(...codePoints)String.fromCodePoint(...codePoints) è un metodo statico di String, non un metodo di una singola stringa. Restituisce una stringa contenente i punti di codice forniti nell’ordine degli argomenti. Se non riceve argomenti, restituisce "".
Ogni argomento viene convertito tramite ToNumber. Il risultato deve essere un numero intero compreso tra 0 e 0x10FFFF, estremi inclusi. Frazioni, NaN, infiniti e valori fuori intervallo causano RangeError. Gli argomenti di tipo BigInt o Symbol causano TypeError durante la conversione.
A differenza di String.fromCharCode, che accetta unità di codice UTF-16, String.fromCodePoint accetta punti di codice interi. Un valore superiore a 0xFFFF viene codificato come coppia surrogata e contribuisce quindi per due unità di codice al valore di .length della stringa. .length conta le unità di codice, non i punti di codice né i caratteri visibili.
Il metodo accetta anche valori surrogati 0xD800–0xDFFF; non garantisce quindi un UTF-16 ben formato. Questa è un’API del linguaggio ECMAScript, non un’API del browser. Per verificare la disponibilità nell’ambiente di destinazione, usa typeof String.fromCodePoint === "function".
Esempi
const text = String.fromCodePoint(0x41, 0x1F600);
console.log(text);
console.log(text.length);
console.log(text.codePointAt(1) === 0x1F600);
console.log(String.fromCodePoint() === "");Risultato
A😀 3 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.