Get to know MDN better
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.
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.
fileNameA string representing the file name or the path to the file.
options OptionalAn options object containing optional attributes for the file. Available options are as follows:
type OptionalA string representing the MIME type of the content that will be put into the file. Defaults to a value of "".
endings OptionalHow 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 value native.
lastModified OptionalA 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().
| File API # file-constructor |
Enable JavaScript to view this browser compatibility table.
This page was last modified on Jun 24, 2025 by MDN contributors.
Your blueprint for a better internet.
Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.