CKTIS / JavaScript
TextDecoder: dekodiranje bajtova, pogreške i oznaka BOM
Dekodirajte bajtove u JavaScript tekst i odaberite kako obraditi neispravne nizove i početnu oznaku redoslijeda bajtova, čak i pri čitanju po blokovima.
Verzija: Current web platform; runtime support varies
Sintaksa
new TextDecoder()
new TextDecoder(label)
new TextDecoder(label, { fatal, ignoreBOM })
decoder.decode()
decoder.decode(input)
decoder.decode(input, { stream })
decoder.fatal
decoder.ignoreBOMMetoda instance decoder.decode() vraća znakovni niz u JavaScriptu. Neobavezan ulaz s bajtovima može biti, primjerice, ArrayBuffer, tipizirano polje ili DataView. Konstruktor new TextDecoder(label, options) odabire kodiranje, zadano "utf-8". Nepoznata oznaka ili oznaka koja upućuje na kodiranje replacement uzrokuje RangeError već u konstruktoru.
decoder.fatal i decoder.ignoreBOM Booleova su svojstva samo za čitanje. Oba su zadano false i postavljaju se u konstruktoru, ne u decode(). Uz fatal: false pogreške pri dekodiranju daju zamjenski znak U+FFFD; uz fatal: true metoda decode() baca TypeError. Strogo dekodiranje ne čini dobiveni tekst sigurnim za upotrebu kao HTML.
Za UTF-8, UTF-16LE i UTF-16BE, ignoreBOM: false izostavlja početnu oznaku redoslijeda bajtova (BOM), dok je ignoreBOM: true zadržava u rezultatu kao U+FEFF. Dakle, true isključuje posebnu obradu, a ne uklanja samu oznaku. Ova postavka ne mijenja kodiranje niti uklanja U+FEFF dalje u tekstu.
Pri čitanju po blokovima upotrebljavajte isti dekoder s { stream: true } dok očekujete još bajtova. Dekoder zadržava stanje i može vratiti prazan znakovni niz dok čeka ostatak znaka. Predajte posljednji blok bez stream: true ili završite pozivom decode() bez argumenata. Tek tada nepotpun slijed na kraju uzrokuje pogrešku pri dekodiranju. Sljedeći neovisan ulaz počinje s novim stanjem.
TextDecoder je dio web API-ja Encoding i nije ugrađen u ECMAScript 2024. Provjerite dostupnost u ciljnom izvršnom okruženju.
Primjeri
{
const bytes = Uint8Array.of(0xEF, 0xBB, 0xBF, 0x41);
const standard = new TextDecoder();
const keep = new TextDecoder("utf-8", { ignoreBOM: true });
const strict = new TextDecoder("utf-8", { fatal: true });
console.log(`default BOM: ${standard.decode(bytes).codePointAt(0)}`);
console.log(`keep BOM: ${keep.decode(bytes).codePointAt(0)}`);
console.log(`replacement: ${standard.decode(Uint8Array.of(0xFF)).codePointAt(0)}`);
const before = strict.decode(Uint8Array.of(0xE2, 0x82), { stream: true });
const after = strict.decode(Uint8Array.of(0xAC));
console.log(`split: ${before.length}, ${after.codePointAt(0)}`);
strict.decode(Uint8Array.of(0xE2), { stream: true });
try {
strict.decode();
} catch (error) {
console.log(`truncated: ${error.name}`);
}
}Rezultat
default BOM: 65 keep BOM: 65279 replacement: 65533 split: 0, 8364 truncated: TypeError
Prva tri retka prikazuju decimalne kodne točke znaka `A`, zadržane oznake BOM i zamjenskog znaka. Redak `split` prikazuje prazan prvi rezultat i kodnu točku znaka `€`; u strogom načinu nepotpun slijed baca `TypeError` tek pri završnom pozivu `decode()`.
Povezane lekcije
- JavaScript · Lekcija 3 · Napredno · Verzija: 4