Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.ignoreBOM

Metoda 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

Izvori