File: File() constructor

The File() constructor creates a new File object instance.

Syntax

new File(bits, name)
new File(bits, name, options)

Parameters

bits

An iterable object such as an Array, having ArrayBuffers, TypedArrays, DataViews, Blobs, strings, or a mix of any of such elements, that will be put inside the File. Note that strings here are encoded as UTF-8, unlike the usual JavaScript UTF-16 strings.

name

A string representing the file name or the path to the file.

options Optional

An options object containing optional attributes for the file. Available options are as follows:

type

A string representing the MIME type of the content that will be put into the file. Defaults to a value of "".

lastModified

A number representing the number of milliseconds between the Unix time epoch and when the file was last modified. Defaults to a value of Date.now().

Examples

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

Specifications

Specification
File API
# file-constructor

Browser compatibility

BCD tables only load in the browser

See also