MDN will be in maintenance mode on Friday September 22nd, starting at 10 AM Pacific / 5 PM UTC, for about 1 hour.

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

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 13 No support 7 (7) No support 11.5 10.1
 
Feature Android Edge Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 4.4.4 (Yes) 7.0 (7) No support No support 6.0

See also

Document Tags and Contributors

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