FileReader: readAsText()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die readAsText()-Methode der FileReader-Schnittstelle wird verwendet, um den Inhalt des angegebenen Blob oder File zu lesen. Wenn der Lesevorgang abgeschlossen ist, wird die readyState-Eigenschaft auf DONE geändert, das loadend-Ereignis wird ausgelöst und die result-Eigenschaft enthält den Inhalt der Datei als Textstring.

Hinweis: Die Blob.text()-Methode ist eine neuere, auf Versprechen basierende API, um eine Datei als Text zu lesen.

Hinweis: Diese Methode lädt den gesamten Inhalt der Datei in den Speicher und ist für große Dateien nicht geeignet. Verwenden Sie für große Dateien besser readAsArrayBuffer().

Syntax

js
readAsText(blob)
readAsText(blob, encoding)

Parameter

blob

Der Blob oder File, aus dem gelesen werden soll.

encoding Optional

Ein String, der die zu verwendende Kodierung für die zurückgegebenen Daten angibt. Standardmäßig wird UTF-8 angenommen, wenn dieser Parameter nicht angegeben wird.

Rückgabewert

Keiner (undefined).

Beispiele

HTML

html
<input type="file" /><br />
<p class="content"></p>

JavaScript

js
const content = document.querySelector(".content");
const fileInput = document.querySelector("input[type=file]");

fileInput.addEventListener("change", previewFile);

function previewFile() {
  const file = fileInput.files[0];
  const reader = new FileReader();

  reader.addEventListener(
    "load",
    () => {
      // this will then display a text file
      content.innerText = reader.result;
    },
    false,
  );

  if (file) {
    reader.readAsText(file);
  }
}

Ergebnis

Spezifikationen

Specification
File API
# readAsDataText

Browser-Kompatibilität

Siehe auch