Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

String.fromCharCode — crear texto a partir de unidades de código UTF-16

String.fromCharCode crea una cadena a partir de las unidades de código UTF-16 indicadas. No interpreta los argumentos como puntos de código Unicode completos: los caracteres fuera del plano multilingüe básico necesitan un par sustituto.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

String.fromCharCode(...codeUnits)

String.fromCharCode(...codeUnits) es un método estático del constructor String, no un método de una cadena individual. Devuelve una cadena nueva que contiene las unidades de código UTF-16 en el orden de los argumentos. Sin argumentos, devuelve "". Forma parte de ECMAScript, no de una API del navegador.

Cada argumento pasa por ToUint16: se convierte en número, se trunca la parte fraccionaria hacia cero y se reduce módulo 65536. NaN, Infinity y -Infinity producen una unidad de código con valor 0. Los valores fuera de rango no provocan por sí solos un RangeError; por ejemplo, 0x10041 produce la misma unidad de código que 65. Convertir un Symbol o un BigInt provoca un TypeError.

Una unidad de código no siempre representa un carácter Unicode completo. Para el punto de código 0x1F600, proporciona el par sustituto 0xD83D, 0xDE00; el resultado tiene una length de 2. Si tus entradas son puntos de código, usa String.fromCodePoint. String.fromCharCode no valida los pares sustitutos y puede crear un sustituto aislado.

El ejemplo muestra letras, un par sustituto, la reducción módulo y una llamada sin argumentos. No uses este método como decodificador de bytes UTF-8.

Ejemplos

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() === "");

Resultado

ABC
true
2
true
true

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes