CKTIS / JavaScript
String.fromCodePoint — tekst maken van codepunten
String.fromCodePoint maakt een tekenreeks van Unicode-codepunten, ook van waarden boven 0xFFFF. Deze worden automatisch als UTF-16 gecodeerd; ongeldige numerieke waarden veroorzaken RangeError.
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.fromCodePoint(...codePoints)String.fromCodePoint(...codePoints) is een statische methode van String, geen methode van een afzonderlijke tekenreeks. De methode geeft een tekenreeks terug met de opgegeven codepunten in de volgorde van de argumenten. Zonder argumenten geeft ze "" terug.
Elk argument wordt omgezet met ToNumber. Het resultaat moet een geheel getal zijn van 0 tot en met 0x10FFFF. Breuken, NaN, oneindigheden en waarden buiten dit bereik veroorzaken RangeError. Argumenten van het type BigInt of Symbol veroorzaken tijdens de omzetting TypeError.
In tegenstelling tot String.fromCharCode, dat UTF-16-code-eenheden accepteert, accepteert String.fromCodePoint volledige codepunten. Een waarde boven 0xFFFF wordt gecodeerd als een surrogaatpaar, waardoor .length van de tekenreeks met twee toeneemt. .length telt code-eenheden, geen codepunten of zichtbare tekens.
De methode accepteert ook surrogaatwaarden 0xD800–0xDFFF; daarom garandeert ze geen goed gevormde UTF-16. Dit is een ECMAScript-taal-API, geen browser-API. Controleer de beschikbaarheid in de doelomgeving met typeof String.fromCodePoint === "function".
Voorbeelden
const text = String.fromCodePoint(0x41, 0x1F600);
console.log(text);
console.log(text.length);
console.log(text.codePointAt(1) === 0x1F600);
console.log(String.fromCodePoint() === "");Resultaat
A😀 3 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.