File.File()

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

Syntax

new File(bits, name[, options]);

Parameters

bits
An Array of ArrayBuffer, ArrayBufferView, Blob, USVString objects, or a mix of any of such objects, that will be put inside the File. USVString objects are 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

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
File() constructorChrome Full support 13Edge Full support 79Firefox Full support 7IE No support NoOpera Full support 11.5Safari Full support 10.1WebView Android Full support ≤37Chrome Android Full support 18Firefox Android Full support 7Opera Android Full support 11.5Safari iOS Full support 6Samsung Internet Android Full support 1.0

Legend

Full support
Full support
No support
No support

See also