База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

TextDecoder — декодиране на байтове в текст

TextDecoder преобразува байтове в текст. Научете за декодирането на части, обработката на грешки с fatal и значението на ignoreBOM.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

new TextDecoder()
new TextDecoder("utf-8", { fatal: false, ignoreBOM: false })
decoder.decode(input, { stream: true })
decoder.decode()
decoder.fatal
decoder.ignoreBOM

TextDecoder е API от стандарта WHATWG Encoding, а не функция на конкретно издание на ECMAScript. По подразбиране използва UTF-8; невалиден етикет за кодиране води до RangeError.

TextDecoder.decode е метод на инстанция: приема буфер или изглед на байтове и връща текст. { stream: true } запазва непълните последователности между частите; последващо decode() изчиства състоянието.

TextDecoder.fatal и TextDecoder.ignoreBOM обозначават свойства на инстанцията само за четене. fatal по подразбиране е false: грешките се заменят с U+FFFD; стойност true води до TypeError. За UTF-8 и UTF-16 стойността по подразбиране ignoreBOM: false премахва началния BOM; true запазва U+FEFF в резултата.

Примери

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);

Резултат

["","€",""]
true false

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници