W3cubDocs

/DOM

File.constructor

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

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/File/File