Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

TextDecoder — dekódování bajtů na text

TextDecoder převádí bajty na text. Seznamte se s dekódováním po částech, zpracováním chyb pomocí fatal a významem ignoreBOM.

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 TextDecoder()
new TextDecoder("utf-8", { fatal: false, ignoreBOM: false })
decoder.decode(input, { stream: true })
decoder.decode()
decoder.fatal
decoder.ignoreBOM

TextDecoder je API standardu WHATWG Encoding, nikoli funkce konkrétní edice ECMAScriptu. Ve výchozím nastavení používá UTF-8; neplatný štítek kódování způsobí RangeError.

TextDecoder.decode je metoda instance: přijímá buffer nebo bajtový pohled a vrací text. { stream: true } zachovává neúplné sekvence mezi částmi; závěrečné decode() vyprázdní stav.

TextDecoder.fatal a TextDecoder.ignoreBOM označují vlastnosti instance pouze pro čtení. fatal má ve výchozím nastavení hodnotu false: chyby se nahradí znakem U+FFFD; hodnota true způsobí TypeError. U UTF-8 a UTF-16 výchozí ignoreBOM: false odstraní počáteční BOM; hodnota true zachová U+FEFF ve výsledku.

Příklady

const decoder = new TextDecoder("utf-8", { fatal: true });
const first = decoder.decode(new Uint8Array([0xE2, 0x82]), { stream: true });
const last = decoder.decode(new Uint8Array([0xAC]));
console.log(JSON.stringify([first, last, decoder.decode()]));
console.log(decoder.fatal, decoder.ignoreBOM);

Výsledek

["","€",""]
true false

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.

Zdroje