Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti