CKTIS / JavaScript
String.fromCharCode — tekst maken uit UTF-16-code-eenheden
String.fromCharCode maakt een tekenreeks van de opgegeven UTF-16-code-eenheden. De argumenten worden niet geïnterpreteerd als volledige Unicode-codepunten: tekens buiten het Basic Multilingual Plane hebben een surrogaatpaar nodig.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
String.fromCharCode(...codeUnits)String.fromCharCode(...codeUnits) is een statische methode van de constructor String, geen methode van een afzonderlijke tekenreeks. De methode retourneert een nieuwe tekenreeks met UTF-16-code-eenheden in de volgorde van de argumenten. Zonder argumenten retourneert de methode "". De methode hoort bij ECMAScript, niet bij een browser-API.
Elk argument ondergaat ToUint16: omzetting naar een getal, afkappen van het decimale deel richting nul en reductie modulo 65536. NaN, Infinity en -Infinity leveren een code-eenheid met waarde 0 op. Waarden buiten het bereik veroorzaken op zichzelf geen RangeError; 0x10041 levert bijvoorbeeld dezelfde code-eenheid op als 65. Een Symbol of BigInt omzetten veroorzaakt een TypeError.
Een code-eenheid staat niet altijd voor een volledig Unicode-teken. Geef voor codepunt 0x1F600 het surrogaatpaar 0xD83D, 0xDE00 op; het resultaat heeft een length van 2. Gebruik String.fromCodePoint als je invoer codepunten zijn. String.fromCharCode controleert surrogaatparen niet en kan een los surrogaat maken.
Het voorbeeld laat letters, een surrogaatpaar, modulo-reductie en een aanroep zonder argumenten zien. Gebruik deze methode niet als decoder voor UTF-8-bytes.
Voorbeelden
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() === "");Resultaat
ABC true 2 true true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.