CKTIS / JavaScript
TextDecoder — dekodowanie bajtów do tekstu
TextDecoder zamienia bajty na tekst. Poznaj dekodowanie fragmentów, obsługę błędów przez fatal oraz znaczenie ignoreBOM.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
new TextDecoder()
new TextDecoder("utf-8", { fatal: false, ignoreBOM: false })
decoder.decode(input, { stream: true })
decoder.decode()
decoder.fatal
decoder.ignoreBOMTextDecoder to API standardu WHATWG Encoding, nie funkcja z konkretnej edycji ECMAScript. Domyślnie używa UTF-8; nieprawidłowa etykieta kodowania powoduje RangeError.
TextDecoder.decode jest metodą instancji: przyjmuje bufor lub widok bajtów i zwraca tekst. { stream: true } zachowuje niepełną sekwencję między fragmentami; końcowe decode() opróżnia stan.
TextDecoder.fatal i TextDecoder.ignoreBOM oznaczają właściwości instancji tylko do odczytu. fatal domyślnie wynosi false: błędy zastępuje U+FFFD; true powoduje TypeError. Dla UTF-8 i UTF-16 domyślne ignoreBOM: false usuwa początkowy BOM; true zachowuje U+FEFF w wyniku.
Przykłady
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);Wynik
["","€",""] true false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.