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

CKTIS / JavaScript

TextDecoder: dekodiranje bajtov, napake in oznaka BOM

Dekodirajte bajte v besedilo JavaScript in izberite, kako obravnavati neveljavna zaporedja ter začetno oznako vrstnega reda bajtov, tudi pri branju po kosih.

Različica: 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 primerka decoder.decode() vrne niz JavaScript. Neobvezni vhod z bajti je lahko na primer ArrayBuffer, tipizirano polje ali DataView. Konstruktor new TextDecoder(label, options) izbere kodiranje, privzeto "utf-8". Neznana oznaka ali oznaka, ki se preslika v kodiranje replacement, že v konstruktorju sproži RangeError.

decoder.fatal in decoder.ignoreBOM sta logični lastnosti samo za branje. Obe sta privzeto false in ju nastavite v konstruktorju, ne v decode(). Pri fatal: false napake pri dekodiranju povzročijo vstavljanje nadomestnega znaka U+FFFD; pri fatal: true metoda decode() sproži TypeError. Strogo dekodiranje ne zagotovi, da je dobljeno besedilo varno uporabiti kot HTML.

Pri UTF-8, UTF-16LE in UTF-16BE nastavitev ignoreBOM: false izpusti začetno oznako vrstnega reda bajtov (BOM), ignoreBOM: true pa jo v rezultatu ohrani kot U+FEFF. Vrednost true torej izklopi posebno obravnavo, ne odstrani oznake. Nastavitev ne spremeni kodiranja in ne odstrani znakov U+FEFF pozneje v besedilu.

Pri vhodu po kosih uporabljajte isti dekodirnik z { stream: true }, dokler pričakujete dodatne bajte. Ohrani stanje in lahko vrne prazen niz, medtem ko čaka na preostanek znaka. Zadnji kos podajte brez stream: true ali zaključite s klicem decode() brez argumentov. Šele takrat nepopolno končno zaporedje povzroči napako pri dekodiranju. Naslednji neodvisni vhod se začne z novim stanjem.

TextDecoder je del spletnega vmesnika Encoding API in ni vgrajen v ECMAScript 2024. Preverite razpoložljivost v ciljnem izvajalnem okolju.

Primeri

{
  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

Prve tri vrstice prikažejo desetiške kodne točke znaka `A`, ohranjene oznake BOM in nadomestnega znaka. Vrstica `split` pokaže prazen prvi rezultat in kodno točko znaka `€`; v strogem načinu okrnjeno zaporedje sproži `TypeError` šele ob končnem klicu `decode()`.

Povezane lekcije

  • JavaScript · Lekcija 3 · Napredna · Različica: 4

Viri