transformText

Converte um ArrayBuffer em texto: detecta a codificação e decodifica.

API

transformText

Retorna

Argumento	Descrição	Tipo
TransformText | undefined	O objeto com o resultado, ou undefined	TransformText | undefined

TransformText

Propriedade	Descrição	Tipo
encoding	A codificação detectada	string
content	O texto decodificado	string

Parâmetros

Parâmetro	Descrição	Tipo	Padrão
content	Conteúdo que será convertido	string | ArrayBuffer	Obrigatório

Exemplo

Uso básico

import { transformText } from 'ranuts';

const arrayBuffer = new TextEncoder().encode('Hello World').buffer;
const result = transformText(arrayBuffer);
if (result) {
  console.log('Codificação:', result.encoding);
  console.log('Conteúdo:', result.content); // 'Hello World'
}

Processar um arquivo

import { transformText } from 'ranuts';

async function readTextFile(file) {
  const arrayBuffer = await file.arrayBuffer();
  const result = transformText(arrayBuffer);
  if (result) {
    return result.content;
  }
  return null;
}

Detecção automática da codificação

import { transformText } from 'ranuts';

// Detecta a codificação e decodifica
const result = transformText(arrayBuffer);
if (result) {
  console.log(`Decodificado com a codificação ${result.encoding}`);
  console.log(result.content);
}

Notas

1. Detecção automática: usa o jschardet para descobrir a codificação.
2. Só ArrayBuffer: por ora aceita apenas ArrayBuffer; com uma string emite um aviso.
3. Quando devolve algo: só quando detecta a codificação e a decodificação dá certo; fora isso devolve undefined.
4. Quando usar: é comum ao ler arquivos, decodificar texto e converter entre codificações.