TextDecoder: метод decode()

Базовая Широко поддерживается

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с января 2020 года.

Примечание: Эта функция доступна в Потоках Web Workers.

Метод TextDecoder.decode() возвращает строку, содержащую текст, декодированный из буфера, переданного в качестве параметра.

Метод декодирования определен в текущем объекте TextDecoder. Он включает ожидаемую кодировку данных и обработку ошибок декодирования.

Синтаксис

decode()
decode(buffer)
decode(buffer, options)

Параметры

buffer Необязательный

Объект ArrayBuffer, TypedArray или DataView, содержащий закодированный текст для декодирования.

options Необязательный

Объект со свойством:

stream: Флаг булевого типа, указывающий, будут ли следовать дополнительные данные в последующих вызовах decode(). Устанавливается в значение true при обработке данных частями и в значение false для последней части или если данные не разбиты на части. По умолчанию имеет значение false.

Исключения

TypeError: Выбрасывается, если при декодировании возникает ошибка, когда свойство TextDecoder.fatal имеет значение true.

Возвращаемое значение

Строка.

Примеры

В этом примере кодируется и декодируется символ евро, €.

HTML

<p>Encoded value: <span id="encoded-value"></span></p>
<p>Decoded value: <span id="decoded-value"></span></p>

JavaScript

const encoder = new TextEncoder();
const array = encoder.encode("€"); // Uint8Array(3) [226, 130, 172]
document.getElementById("encoded-value").textContent = array;

const decoder = new TextDecoder();
const str = decoder.decode(array); // String "€"
document.getElementById("decoded-value").textContent = str;

Результат

Спецификации

Спецификация
Кодировка # ref-for-dom-textdecoder-decode①

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`decode`	38	79	19 18 Реализована немного другая версия спецификации.	25	10.1	38	19 18 Реализована немного другая версия спецификации.	25	10.3	3.0	38

См. также

Интерфейс TextDecoder, к которому он относится.

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/TextDecoder/decode