CKTIS / JavaScript
String.fromCodePoint — Text aus Codepoints erstellen
String.fromCodePoint erstellt eine Zeichenkette aus Unicode-Codepoints, auch aus Werten über 0xFFFF. Diese werden automatisch als UTF-16 codiert; ungültige Zahlenwerte lösen RangeError aus.
Version: 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) ist eine statische Methode von String, keine Methode einer einzelnen Zeichenkette. Sie gibt eine Zeichenkette mit den angegebenen Codepoints in der Reihenfolge der Argumente zurück. Ohne Argumente gibt sie "" zurück.
Jedes Argument wird mit ToNumber konvertiert. Das Ergebnis muss eine ganze Zahl von 0 bis einschließlich 0x10FFFF sein. Brüche, NaN, Unendlichkeiten und Werte außerhalb dieses Bereichs lösen RangeError aus. Argumente vom Typ BigInt oder Symbol lösen während der Konvertierung TypeError aus.
Anders als String.fromCharCode, das UTF-16-Codeeinheiten akzeptiert, nimmt String.fromCodePoint vollständige Codepoints entgegen. Ein Wert über 0xFFFF wird als Surrogatpaar codiert und erhöht dadurch .length der Zeichenkette um zwei. .length zählt Codeeinheiten, nicht Codepoints oder sichtbare Zeichen.
Die Methode akzeptiert auch Surrogatwerte 0xD800–0xDFFF; sie garantiert daher kein wohlgeformtes UTF-16. Dies ist eine ECMAScript-Sprach-API, keine Browser-API. Ob sie in der Zielumgebung verfügbar ist, lässt sich mit typeof String.fromCodePoint === "function" prüfen.
Beispiele
const text = String.fromCodePoint(0x41, 0x1F600);
console.log(text);
console.log(text.length);
console.log(text.codePointAt(1) === 0x1F600);
console.log(String.fromCodePoint() === "");Ergebnis
A😀 3 true true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.