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

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
File
38
79
28
No
25
10
38
38
28
25
10
3.0

See also

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/File/File