The File()
constructor creates a new File
object instance.
On this page
File: File() constructor
Syntax
js
new File(bits, name)
new File(bits, name, options)
Parameters
-
bits
-
An iterable object such as an
Array
, havingArrayBuffer
s,TypedArray
s,DataView
s,Blob
s, 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. -
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
Specification |
---|
File API # file-constructor |
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