String.fromCodePoint()

Probieren Sie es aus

console.log(String.fromCodePoint(9731, 9733, 9842, 0x2f804));
// Expected output: ""

Syntax

String.fromCodePoint()
String.fromCodePoint(num1)
String.fromCodePoint(num1, num2)
String.fromCodePoint(num1, num2, /* , */ numN)

Parameter

num1, , numN

Eine ganze Zahl zwischen 0 und 0x10FFFF (einschlielich) reprsentiert einen Unicode-Codepunkt.

Rckgabewert

Ein String, der unter Verwendung der angegebenen Sequenz von Codepunkten erstellt wurde.

Ausnahmen

RangeError

Wird ausgelst, wenn numN keine ganze Zahl ist, kleiner als 0 oder grer als 0x10FFFF nach der Konvertierung in eine Zahl ist.

Beschreibung

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

Unicode-Codepunkte reichen von 0 bis 1114111 (0x10FFFF). In UTF-16 ist jeder String-Index eine Codeeinheit mit dem Wert 0 65535. Hhere Codepunkte werden durch ein Paar von 16-Bit-Surrogat-Pseudo-Zeichen dargestellt. Daher kann fromCodePoint() einen String zurckgeben, dessen Lnge (in UTF-16-Codeeinheiten) grer ist als die Anzahl der bergebenen Argumente. Weitere Informationen zu Unicode finden Sie unter UTF-16-Zeichen, Unicode-Codepunkte und Graphem-Cluster.

Beispiele

Verwendung von fromCodePoint()

Gltige 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"

Ungltige 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

Im Vergleich zu fromCharCode()

String.fromCharCode() kann keine ergnzenden Zeichen (d.h. Codepunkte 0x010000 0x10FFFF) zurckgeben, indem deren Codepunkt angegeben wird. Stattdessen erfordert es das UTF-16-Surrogatpaar, um ein ergnzendes Zeichen zurckzugeben:

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

String.fromCodePoint() hingegen kann 4-Byte-Ergnzungszeichen sowie die hufigeren 2-Byte-BMP-Zeichen zurckgeben, indem ihr Codepunkt angegeben wird (was der UTF-32-Codeeinheit entspricht):

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

Spezifikationen

Browser-Kompatibilitt

Siehe auch

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