File: File() constructor
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
Note: This feature is available in Web Workers.
The File() constructor creates a new File
object instance.
Syntax
new File(fileBits, fileName)
new File(fileBits, fileName, options)
Parameters
fileBits-
An iterable object such as an
Array, havingArrayBuffers,TypedArrays,DataViews,Blobs, strings, or a mix of any of such elements, that will be put inside theFile. Note that strings here are encoded as UTF-8, unlike the usual JavaScript UTF-16 strings. fileName-
A string representing the file name or the path to the file.
optionsOptional-
An options object containing optional attributes for the file. Available options are as follows:
typeOptional-
A string representing the MIME type of the content that will be put into the file. Defaults to a value of
"". endingsOptional-
How to interpret newline characters (
\n) within the contents, if the data is text. The default value,transparent, copies newline characters into the blob without changing them. To convert newlines to the host system's native convention, specify the valuenative. lastModifiedOptional-
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
const file = new File(["foo"], "foo.txt", {
type: "text/plain",
});
Specifications
| Specification |
|---|
| File API # file-constructor |
Browser compatibility
Loading…