Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

TextDecoder — dekodiranje bajtov v besedilo

TextDecoder pretvarja bajte v besedilo. Spoznajte dekodiranje po delih, obravnavo napak z fatal in pomen možnosti ignoreBOM.

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

Sintaksa

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

TextDecoder je API standarda WHATWG Encoding, ne funkcija določene izdaje ECMAScripta. Privzeto uporablja UTF-8; neveljavna oznaka kodiranja povzroči RangeError.

TextDecoder.decode je metoda primerka: sprejme medpomnilnik ali bajtni pogled in vrne besedilo. { stream: true } ohrani nepopolna zaporedja med deli; končni decode() izprazni stanje.

TextDecoder.fatal in TextDecoder.ignoreBOM označujeta lastnosti primerka, ki sta samo za branje. fatal je privzeto false: napake se nadomestijo z U+FFFD; vrednost true povzroči TypeError. Pri UTF-8 in UTF-16 privzeta vrednost ignoreBOM: false odstrani začetni BOM; vrednost true ohrani U+FEFF v rezultatu.

Primeri

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);

Rezultat

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri