Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

TextDecoder — dekódovanie bajtov na text

TextDecoder prevádza bajty na text. Zoznámte sa s dekódovaním po častiach, spracovaním chýb pomocou fatal a významom ignoreBOM.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

new TextDecoder()
new TextDecoder("utf-8", { fatal: false, ignoreBOM: false })
decoder.decode(input, { stream: true })
decoder.decode()
decoder.fatal
decoder.ignoreBOM

TextDecoder je API štandardu WHATWG Encoding, nie funkcia konkrétnej edície ECMAScriptu. Predvolene používa UTF-8; neplatný štítok kódovania spôsobí RangeError.

TextDecoder.decode je metóda inštancie: prijíma buffer alebo bajtový pohľad a vracia text. { stream: true } zachováva neúplné sekvencie medzi časťami; záverečné decode() vyprázdni stav.

TextDecoder.fatal a TextDecoder.ignoreBOM označujú vlastnosti inštancie iba na čítanie. fatal má predvolene hodnotu false: chyby sa nahradia znakom U+FFFD; hodnota true spôsobí TypeError. Pri UTF-8 a UTF-16 predvolená hodnota ignoreBOM: false odstráni úvodný BOM; hodnota true zachová U+FEFF vo výsledku.

Prí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ýsledok

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

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje