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

Syntax

var myFile = new File(bits, name[, options]);

Parameters

bits
An Array of ArrayBuffer, ArrayBufferView, Blob, or DOMString objects — or a mix of any such objects. This is the file content encoded as UTF-8.
name
A USVString 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 DOMString 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().

Example

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

Specifications

Specification Status Comment
File API Working Draft Initial definition

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support13 No7 No11.510.1
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support Yes Yes Yes7 No6 Yes

See also

Document Tags and Contributors

Contributors to this page: fscholz, chrisdavidmills, galvakojis, TrevorBurnham, runarberg
Last updated by: fscholz,