String.fromCharCode()

num1, …, numN

Eine Zahl zwischen 0 und 65535 (0xFFFF), die eine UTF-16-Codeeinheit darstellt. Zahlen größer als 0xFFFF werden auf die letzten 16 Bits gekürzt. Es werden keine Gültigkeitsprüfungen durchgeführt.

Ein String der Länge N, bestehend aus den N angegebenen UTF-16-Codeeinheiten.

Da fromCharCode() eine statische Methode von String ist, wird sie immer als String.fromCharCode() verwendet, anstatt als Methode eines von Ihnen erstellten String-Wertes.

Unicode-Codepunkte reichen von 0 bis 1114111 (0x10FFFF). charCodeAt() gibt immer einen Wert zurück, der kleiner als 65536 ist, da höhere Codepunkte durch ein Paar von 16-Bit-Surrogat-Pseudozeichen dargestellt werden. Daher ist es erforderlich, zwei Codeeinheiten bereitzustellen, um ein vollständiges Zeichen mit einem Wert größer als 65535 zu erzeugen (als ob man eine Zeichenfolge mit zwei Zeichen manipuliert). Weitere Informationen zu Unicode finden Sie unter UTF-16-Zeichen, Unicode-Codepunkte und Graphem-Cluster.

Da fromCharCode() nur mit 16-Bit-Werten arbeitet (wie die \u-Escape-Sequenz), ist ein Surrogatpaar erforderlich, um ein zusätzliches Zeichen zurückzugeben. Zum Beispiel geben sowohl String.fromCharCode(0xd83c, 0xdf03) als auch "\ud83c\udf03" den Codepunkt U+1F303 "Nacht mit Sternen" zurück. Obwohl es eine mathematische Beziehung zwischen dem zusätzlichen Codepunktwert (z.B. 0x1f303) und beiden Surrogatwerten, die ihn repräsentieren (z.B. 0xd83c und 0xdf03), gibt, erfordert es dennoch einen zusätzlichen Schritt, um entweder das Surrogatpaar zu berechnen oder nachzuschlagen, jedes Mal wenn ein zusätzlicher Codepunkt verwendet werden soll. Aus diesem Grund ist es bequemer, String.fromCodePoint() zu verwenden, das das Zurückgeben von zusätzlichen Zeichen basierend auf ihrem tatsächlichen Codepunktwert ermöglicht. Zum Beispiel gibt String.fromCodePoint(0x1f303) den Codepunkt U+1F303 "Nacht mit Sternen" zurück.

BMP-Zeichen verwenden in UTF-16 eine einzelne Codeeinheit:

String.fromCharCode(65, 66, 67); // returns "ABC"
String.fromCharCode(0x2014); // returns "—"
String.fromCharCode(0x12014); // also returns "—"; the digit 1 is truncated and ignored
String.fromCharCode(8212); // also returns "—"; 8212 is the decimal form of 0x2014

Zusätzliche Zeichen erfordern in UTF-16 zwei Codeeinheiten (d.h. ein Surrogatpaar):

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

String.fromCharCode(0xd834, 0xdf06, 0x61, 0xd834, 0xdf07); // "\uD834\uDF06a\uD834\uDF07"

• String.fromCodePoint()
• String.prototype.charAt()
• String.prototype.charCodeAt()
• String.prototype.codePointAt()