String.fromCodePoint()

num1, …, numN

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

Eine Zeichenfolge, die durch die Verwendung der angegebenen Sequenz von Codepunkten erstellt wurde.

RangeError

Wird ausgelöst, wenn numN keine ganze Zahl ist, kleiner als 0 ist oder nach der Umwandlung in eine Zahl größer als 0x10FFFF ist.

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

Unicode-Codepunkte reichen von 0 bis 1114111 (0x10FFFF). In UTF-16 ist jeder Zeichenfolgenindex eine Codeeinheit mit dem Wert 0 – 65535. Höhere Codepunkte werden durch ein Paar 16-Bit-Surrogat-Pseudozahlen dargestellt. Daher kann fromCodePoint() eine Zeichenfolge zurückgeben, deren length (in UTF-16-Codeeinheiten) größer ist als die Anzahl der übergebenen Argumente. Weitere Informationen zu Unicode finden Sie unter UTF-16-Zeichen, Unicode-Codepunkte und Graphemcluster.

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 ergänzenden Zeichen (d.h. Codepunkte 0x010000 – 0x10FFFF) zurückgeben, indem deren Codepunkt angegeben wird. Stattdessen benötigt es das UTF-16-Surrogatpaar, um ein ergänzendes 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 ergänzende Zeichen sowie die häufigeren 2-Byte BMP-Zeichen zurückgeben, indem deren Codepunkt angegeben wird (was der UTF-32-Codeeinheit entspricht):

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

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