TextDecoder: encoding-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die schreibgeschützte TextDecoder.encoding-Eigenschaft gibt einen String zurück, der den Namen der Zeichencodierung enthält, die dieser Decoder verwenden wird.
Die Codierung wird durch den label-Parameter festgelegt, der an den Konstruktor übergeben wird, und standardmäßig auf utf-8 gesetzt.
Wert
Ein in Kleinbuchstaben geschriebener ASCII-String, der einer der folgenden Werte sein kann:
- Die empfohlene Codierung für das Web:
'utf-8'. - Die veralteten Einzelbyte-Codierungen: 'ibm866', 'iso-8859-2', 'iso-8859-3', 'iso-8859-4', 'iso-8859-5', 'iso-8859-6', 'iso-8859-7', 'iso-8859-8', 'iso-8859-8i', 'iso-8859-10', 'iso-8859-13', 'iso-8859-14', 'iso-8859-15', 'iso-8859-16', 'koi8-r', 'koi8-u', 'macintosh', 'windows-874', 'windows-1250', 'windows-1251', 'windows-1252', 'windows-1253', 'windows-1254', 'windows-1255', 'windows-1256', 'windows-1257', 'windows-1258', oder 'x-mac-cyrillic'.
- Die veralteten Mehrbyte-Codierungen für vereinfachtes Chinesisch: 'gbk', 'gb18030'.
- Die veraltete Mehrbyte-Codierung für traditionelles Chinesisch: 'big5'.
- Die veralteten Mehrbyte-Codierungen für Japanisch: 'euc-jp', 'iso-2022-jp', 'shift-jis'.
- Die veralteten Mehrbyte-Codierungen für Koreanisch: 'euc-kr'.
- Die veralteten sonstigen Codierungen:
'utf-16be',
'utf-16le',
'x-user-defined'. - Eine spezielle Codierung,
'replacement'. Diese dekodiert leere Eingabe in leere Ausgabe und jede andere Eingabe mit beliebiger Länge in ein einzelnes Ersatzzeichen. Sie wird verwendet, um Angriffe zu verhindern, die Codierungsfehler zwischen Client und Server missbrauchen. Die folgenden Codierungen werden ebenfalls der Ersatzcodierung zugeordnet:ISO-2022-CN,ISO-2022-CN-ext, 'iso-2022-kr', und 'hz-gb-2312'.
Spezifikationen
| Spezifikation |
|---|
| Encoding # ref-for-dom-textdecoder-encoding① |
Browser-Kompatibilität
Siehe auch
- Das
TextDecoder-Interface, zu dem es gehört.