Datei: Konstruktor File()

Baseline Widely available

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

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

Der File()-Konstruktor erstellt eine neue Instanz eines File-Objekts.

Syntax

js
new File(fileBits, fileName)
new File(fileBits, fileName, options)

Parameter

fileBits

Ein iterierbares Objekt wie ein Array, das ArrayBuffers, TypedArrays, DataViews, Blobs, Zeichenfolgen oder eine Mischung solcher Elemente enthält, die in die File eingefügt werden. Beachten Sie, dass Zeichenfolgen hier als UTF-8 kodiert werden, im Gegensatz zu den üblichen JavaScript UTF-16 Zeichenfolgen.

fileName

Eine Zeichenfolge, die den Dateinamen oder den Pfad zur Datei darstellt.

options Optional

Ein Optionsobjekt, das optionale Attribute für die Datei enthält. Verfügbare Optionen sind wie folgt:

type Optional

Eine Zeichenfolge, die den MIME-Typ des Inhalts darstellt, der in die Datei eingefügt wird. Standardmäßig ist der Wert "".

endings Optional

Wie Zeilenumbrüche (\n) innerhalb der Inhalte interpretiert werden, wenn die Daten Text sind. Der Standardwert, transparent, kopiert Zeilenumbrüche in das Blob, ohne sie zu ändern. Um Zeilenumbrüche in das native Konvention des Hostsystems zu konvertieren, geben Sie den Wert native an.

lastModified Optional

Eine Zahl, die die Anzahl der Millisekunden zwischen der Unix-Zeit-Epoche und dem Zeitpunkt darstellt, an dem die Datei zuletzt geändert wurde. Standardmäßig ist der Wert Date.now().

Beispiele

js
const file = new File(["foo"], "foo.txt", {
  type: "text/plain",
});

Spezifikationen

Specification
File API
# file-constructor

Browser-Kompatibilität

Siehe auch