CKTIS / JavaScript
TextDecoderStream — dekodiranje bajtova u toku
TextDecoderStream pretvara tok bajtova u tekst i čuva stanje dekodera između blokova.
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 TextDecoderStream(label = "utf-8", { fatal = false, ignoreBOM = false } = {})TextDecoderStream je Web API iz standarda Encoding, a ne dio određenog izdanja ECMAScripta. Dostupnost provjerite pomoću typeof TextDecoderStream !== "undefined"; Node 24 ne potvrđuje podršku u preglednicima.
writable prihvaća međuspremnike i poglede kao što je Uint8Array; readable daje nizove znakova. Upotrijebite pipeThrough(). Nepotpuni nizovi čekaju dodatne bajtove; izlazni blokovi ne omeđuju zapise. Zatvaranje ulaza dovršava dekodiranje.
UTF-8 je zadano kodiranje; pogreške daju U+FFFD. Uz fatal: true oba toka završavaju pogreškom TypeError. Nevaljana oznaka kodiranja uzrokuje RangeError pri pozivu konstruktora.
ignoreBOM: false uklanja početni BOM UTF-8/UTF-16; true ga zadržava u tekstu. Svojstva encoding, fatal i ignoreBOM samo su za čitanje.
Primjeri
(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);Rezultat
A€B
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.