WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

String.fromCharCode — Text aus UTF-16-Codeeinheiten erstellen

String.fromCharCode erstellt eine Zeichenfolge aus den angegebenen UTF-16-Codeeinheiten. Die Argumente werden nicht als vollständige Unicode-Codepoints interpretiert: Zeichen außerhalb der Basic Multilingual Plane benötigen ein Surrogatpaar.

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.fromCharCode(...codeUnits)

String.fromCharCode(...codeUnits) ist eine statische Methode des Konstruktors String, keine Methode einer einzelnen Zeichenfolge. Sie gibt eine neue Zeichenfolge zurück, die UTF-16-Codeeinheiten in der Reihenfolge der Argumente enthält. Ohne Argumente gibt sie "" zurück. Sie gehört zu ECMAScript und ist keine Browser-API.

Jedes Argument durchläuft ToUint16: Umwandlung in eine Zahl, Abschneiden des Nachkommateils gegen null und Reduktion modulo 65536. NaN, Infinity und -Infinity ergeben eine Codeeinheit mit dem Wert 0. Werte außerhalb des zulässigen Bereichs verursachen nicht von sich aus einen RangeError; 0x10041 ergibt beispielsweise dieselbe Codeeinheit wie 65. Die Umwandlung eines Symbol oder BigInt verursacht einen TypeError.

Eine Codeeinheit entspricht nicht immer einem vollständigen Unicode-Zeichen. Für den Codepoint 0x1F600 musst du das Surrogatpaar 0xD83D, 0xDE00 übergeben; das Ergebnis hat eine length von 2. Wenn deine Eingaben Codepoints sind, verwende String.fromCodePoint. String.fromCharCode prüft die Paarung von Surrogaten nicht und kann ein einzelnes Surrogat erzeugen.

Das Beispiel zeigt Buchstaben, ein Surrogatpaar, die Modulo-Reduktion und einen Aufruf ohne Argumente. Verwende diese Methode nicht als UTF-8-Byte-Decoder.

Beispiele

const text = String.fromCharCode(65, 66, 67);
const emoji = String.fromCharCode(0xD83D, 0xDE00);
console.log(text);
console.log(emoji === String.fromCodePoint(0x1F600));
console.log(emoji.length);
console.log(String.fromCharCode(0x10041) === "A");
console.log(String.fromCharCode() === "");

Ergebnis

ABC
true
2
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.

Quellen