CKTIS / JavaScript
TextDecoderStream — průběžné dekódování bajtů
TextDecoderStream převádí proud bajtů na text a zachovává stav dekodéru mezi jednotlivými bloky.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new TextDecoderStream(label = "utf-8", { fatal = false, ignoreBOM = false } = {})TextDecoderStream je Web API ze standardu Encoding, nikoli součást konkrétní edice ECMAScriptu. Dostupnost ověřte pomocí typeof TextDecoderStream !== "undefined"; Node 24 nepotvrzuje podporu v prohlížečích.
writable přijímá buffery a pohledy, například Uint8Array; readable poskytuje řetězce. Používejte pipeThrough(). Neúplné sekvence čekají na další bajty; výstupní bloky nevymezují záznamy. Uzavření vstupu dokončí dekódování.
Výchozí kódování je UTF-8; chyby vedou k U+FFFD. Při fatal: true skončí oba streamy chybou TypeError. Neplatný štítek kódování způsobí při vytvoření konstruktoru chybu RangeError.
ignoreBOM: false odstraní počáteční BOM UTF-8/UTF-16; true jej zachová v textu. Vlastnosti encoding, fatal a ignoreBOM jsou pouze pro čtení.
Příklady
(async () => {
const bytes = new ReadableStream({
start(controller) {
controller.enqueue(new Uint8Array([0x41, 0xE2]));
controller.enqueue(new Uint8Array([0x82, 0xAC, 0x42]));
controller.close();
}
});
const reader = bytes
.pipeThrough(new TextDecoderStream("utf-8", { fatal: true }))
.getReader();
let text = "";
try {
while (true) {
const { value, done } = await reader.read();
if (done) break;
text += value;
}
} finally {
reader.releaseLock();
}
console.log(text);
})().catch(console.error);Výsledek
A€B
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.