Repository navigation
Expand file tree
/
Copy pathindex.md
More file actions
67 lines (45 loc) · 2.19 KB
/
Copy pathindex.md
File metadata and controls
67 lines (45 loc) · 2.19 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
---
title: "TextDecoder: TextDecoder() Konstruktor"
short-title: TextDecoder()
slug: Web/API/TextDecoder/TextDecoder
l10n:
sourceCommit: ccd1540ad8c51242b318bf437dfabe2e5315b3fa
---
{{APIRef("Encoding API")}}{{AvailableInWorkers}}
Der **`TextDecoder()`** Konstruktor gibt ein neues [`TextDecoder`](/de/docs/Web/API/TextDecoder)-Objekt zurück.
## Syntax
```js-nolint
new TextDecoder()
new TextDecoder(label)
new TextDecoder(label, options)
```
### Parameter
- `label` {{optional_inline}}
- : Ein String, der die Zeichenkodierung identifiziert, die dieser Decoder verwenden wird. Dies kann [jedes gültige Label](/de/docs/Web/API/Encoding_API/Encodings) sein.
Standardmäßig `"utf-8"`.
- `options` {{optional_inline}}
- : Ein Objekt mit den folgenden Eigenschaften:
- `fatal` {{optional_inline}}
- : Ein boolescher Wert, der angibt, ob die Methode [`TextDecoder.decode()`](/de/docs/Web/API/TextDecoder/decode) einen {{jsxref("TypeError")}} werfen muss, wenn ungültige Daten dekodiert werden.
Standardmäßig `false`, was bedeutet, dass der Decoder fehlerhafte Daten durch ein Ersatzzeichen ersetzt.
- `ignoreBOM` {{optional_inline}}
- : Ein boolescher Wert, der angibt, ob das [byte order mark](https://www.w3.org/International/questions/qa-byte-order-mark) in die Ausgabe einbezogen oder übersprungen wird.
Standardmäßig `false`, was bedeutet, dass das byte order mark beim Dekodieren übersprungen und nicht in den dekodierten Text einbezogen wird.
### Ausnahmen
- {{jsxref("RangeError")}}
- : Wird ausgelöst, wenn der Wert von `label` unbekannt ist oder einer der Werte ist, die zu einem `'replacement'` Dekodierungsalgorithmus führen (`"iso-2022-cn"` oder `"iso-2022-cn-ext"`).
## Beispiele
```js
const textDecoder1 = new TextDecoder("iso-8859-2");
const textDecoder2 = new TextDecoder();
const textDecoder3 = new TextDecoder("csiso2022kr", { fatal: true });
// Allows TypeError exception to be thrown.
const textDecoder4 = new TextDecoder("iso-2022-cn");
// Throws a RangeError exception.
```
## Spezifikationen
{{Specifications}}
## Browser-Kompatibilität
{{Compat}}
## Siehe auch
- Das [`TextDecoder`](/de/docs/Web/API/TextDecoder)-Interface, dem es angehört.