ran
Deutsch

transformText

Wandelt einen ArrayBuffer in Text um: erkennt die Kodierung und dekodiert.

API

transformText

Rückgabe

Argument Beschreibung Typ
TransformText | undefined Das Ergebnisobjekt oder undefined TransformText | undefined

TransformText

Eigenschaft Beschreibung Typ
encoding Die erkannte Kodierung string
content Der dekodierte Text string

Parameter

Parameter Beschreibung Typ Standard
content Umzuwandelnder Inhalt string | ArrayBuffer Erforderlich

Beispiel

Grundlegende Verwendung

import { transformText } from 'ranuts';

const arrayBuffer = new TextEncoder().encode('Hello World').buffer;
const result = transformText(arrayBuffer);
if (result) {
  console.log('Kodierung:', result.encoding);
  console.log('Inhalt:', result.content); // 'Hello World'
}

Eine Datei verarbeiten

import { transformText } from 'ranuts';

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

Kodierung automatisch erkennen

import { transformText } from 'ranuts';

// Erkennt die Kodierung und dekodiert
const result = transformText(arrayBuffer);
if (result) {
  console.log(`Mit der Kodierung ${result.encoding} dekodiert`);
  console.log(result.content);
}

Hinweise

  1. Erkennt selbst: nutzt jschardet, um die Kodierung zu bestimmen.
  2. Nur ArrayBuffer: bisher wird nur ArrayBuffer unterstützt; bei einer Zeichenkette kommt eine Warnung.
  3. Wann etwas zurückkommt: nur, wenn die Kodierung erkannt wurde und das Dekodieren gelingt, sonst undefined.
  4. Einsatz: üblich beim Lesen von Dateien, beim Dekodieren von Text und beim Umwandeln von Kodierungen.