Compartilhar via


TextDecoder class

Uma implementação da API de Padrão de Codificação do WHATWG.

const decoder = new TextDecoder();
const u8arr = new Uint8Array([72, 101, 108, 108, 111]);
console.log(decoder.decode(u8arr)); // Hello

Construtores

TextDecoder(string, { fatal?: boolean, ignoreBOM?: boolean })

Propriedades

encoding

A codificação compatível com a instância de TextDecoder.

fatal

O valor será true se erros de decodificação resultarem em uma TypeError sendo gerada.

ignoreBOM

O valor será true se o resultado da decodificação incluir a marca de ordem de byte.

Métodos

decode(null | ArrayBuffer | ArrayBufferView, { stream?: boolean })

Decodifica o input e retorna uma cadeia de caracteres. Se options.stream for true, todas as sequências de bytes incompletas que ocorrerem no final do input serão armazenadas em buffer internamente e emitidas após a próxima chamada para textDecoder.decode().

Se textDecoder.fatal for true, a decodificação de erros que ocorrerem resultará em uma TypeError sendo gerada.

Detalhes do construtor

TextDecoder(string, { fatal?: boolean, ignoreBOM?: boolean })

new TextDecoder(encoding?: string, options?: { fatal?: boolean, ignoreBOM?: boolean })

Parâmetros

encoding

string

options

{ fatal?: boolean, ignoreBOM?: boolean }

Detalhes da propriedade

encoding

A codificação compatível com a instância de TextDecoder.

encoding: string

Valor da propriedade

string

fatal

O valor será true se erros de decodificação resultarem em uma TypeError sendo gerada.

fatal: boolean

Valor da propriedade

boolean

ignoreBOM

O valor será true se o resultado da decodificação incluir a marca de ordem de byte.

ignoreBOM: boolean

Valor da propriedade

boolean

Detalhes do método

decode(null | ArrayBuffer | ArrayBufferView, { stream?: boolean })

Decodifica o input e retorna uma cadeia de caracteres. Se options.stream for true, todas as sequências de bytes incompletas que ocorrerem no final do input serão armazenadas em buffer internamente e emitidas após a próxima chamada para textDecoder.decode().

Se textDecoder.fatal for true, a decodificação de erros que ocorrerem resultará em uma TypeError sendo gerada.

function decode(input?: null | ArrayBuffer | ArrayBufferView, options?: { stream?: boolean }): string

Parâmetros

input

null | ArrayBuffer | ArrayBufferView

Uma instância ArrayBuffer, DataViewou TypedArray que contém os dados codificados.

options

{ stream?: boolean }

Retornos

string