String.fromCodePoint()

num1, …, numN

Eine Ganzzahl zwischen 0 und 0x10FFFF (einschließlich), die einen Unicode-Codepunkt darstellt.

Ein String, der mit der angegebenen Sequenz von Codepunkten erstellt wurde.

RangeError

Wird ausgelöst, wenn numN keine Ganzzahl ist, kleiner als 0 ist oder größer als 0x10FFFF ist, nachdem sie in eine Zahl umgewandelt wurde.

Da fromCodePoint() eine statische Methode von String ist, wird sie immer als String.fromCodePoint() verwendet und nicht als Methode eines von Ihnen erstellten String-Werts.

Unicode-Codepunkte reichen von 0 bis 1114111 (0x10FFFF). In UTF-16 ist jeder String-Index eine Codeeinheit mit dem Wert 0 – 65535. Höhere Codepunkte werden durch ein Paar 16-Bit-Surrogat-Pseudoelemente dargestellt. Daher kann fromCodePoint() einen String zurückgeben, dessen length (in UTF-16-Codieinheiten) größer ist als die Anzahl der übergebenen Argumente. Für Informationen zu Unicode siehe UTF-16-Zeichen, Unicode-Codepunkte und Graphem-Cluster.

Gültige Eingabe:

String.fromCodePoint(42); // "*"
String.fromCodePoint(65, 90); // "AZ"
String.fromCodePoint(0x404); // "\u0404" === "Є"
String.fromCodePoint(0x2f804); // "\uD87E\uDC04"
String.fromCodePoint(194564); // "\uD87E\uDC04"
String.fromCodePoint(0x1d306, 0x61, 0x1d307); // "\uD834\uDF06a\uD834\uDF07"

Ungültige Eingabe:

String.fromCodePoint("_"); // RangeError
String.fromCodePoint(Infinity); // RangeError
String.fromCodePoint(-1); // RangeError
String.fromCodePoint(3.14); // RangeError
String.fromCodePoint(3e-2); // RangeError
String.fromCodePoint(NaN); // RangeError

String.fromCharCode() kann keine zusätzlichen Zeichen (d.h. Codepunkte 0x010000 – 0x10FFFF) durch Angabe ihres Codepunkts zurückgeben. Stattdessen erfordert es das UTF-16-Surrogatpaar, um ein zusätzliches Zeichen zurückzugeben:

String.fromCharCode(0xd83c, 0xdf03); // Code Point U+1F303 "Night with
String.fromCharCode(55356, 57091); // Stars" === "\uD83C\uDF03"

String.fromCodePoint() hingegen kann 4-Byte-Zusatzzeichen sowie die häufiger vorkommenden 2-Byte-BMP-Zeichen zurückgeben, indem ihr Codepunkt angegeben wird (was einer UTF-32-Codieinheit entspricht):

String.fromCodePoint(0x1f303); // or 127747 in decimal

• Polyfill von String.fromCodePoint in core-js
• es-shims polyfill von String.fromCodePoint
• String.fromCharCode()
• String.prototype.charAt()
• String.prototype.codePointAt()
• String.prototype.charCodeAt()