CKTIS / JavaScript
TextDecoder — dekodiranje bajtova u tekst
TextDecoder pretvara bajtove u tekst. Saznajte više o dekodiranju u dijelovima, obradi pogrešaka pomoću fatal i značenju opcije ignoreBOM.
Verzija: 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.ignoreBOMTextDecoder je API standarda WHATWG Encoding, a ne značajka određenog izdanja ECMAScripta. Prema zadanim postavkama koristi UTF-8; nevaljana oznaka kodiranja uzrokuje RangeError.
TextDecoder.decode metoda je instance: prihvaća međuspremnik ili bajtni prikaz i vraća tekst. { stream: true } zadržava nepotpune nizove između dijelova; završni decode() prazni stanje.
TextDecoder.fatal i TextDecoder.ignoreBOM označavaju svojstva instance samo za čitanje. fatal je prema zadanim postavkama false: pogreške se zamjenjuju znakom U+FFFD; vrijednost true uzrokuje TypeError. Za UTF-8 i UTF-16 zadana vrijednost ignoreBOM: false uklanja početni BOM; vrijednost true čuva U+FEFF u rezultatu.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.