W3cubDocs

/Web APIs

File: File() constructor

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

Syntax

js

new File(bits, name)
new File(bits, name, options)

Parameters

bits

An iterable object such as an Array, having ArrayBuffers, TypedArrays, DataViews, Blobs, strings, or a mix of any of such elements, that will be put inside the File. Note that strings here are encoded as UTF-8, unlike the usual JavaScript UTF-16 strings.

name

A string 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 string 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().

Examples

js

const 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.1 38 38 28 25 10.3 3.0

See also

© 2005–2023 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