File - Web APIs | MDN (original) (raw)
Baseline
Widely available
Note: This feature is available in Web Workers.
The File interface provides information about files and allows JavaScript in a web page to access their content.
File objects are generally retrieved from a FileList object returned as a result of a user selecting files using the element, or from a drag and drop operation's DataTransfer object.
A File object is a specific kind of Blob, and can be used in any context that a Blob can. In particular, the following APIs accept both Blobs and File objects:
- FileReader
- URL.createObjectURL()
- Window.createImageBitmap() and WorkerGlobalScope.createImageBitmap()
- the body option to fetch()
- XMLHttpRequest.send()
See Using files from web applications for more information and examples.
Constructor
Returns a newly constructed File.
Instance properties
The File interface also inherits properties from the Blob interface.
File.lastModified Read only
Returns the last modified time of the file, in millisecond since the UNIX epoch (January 1st, 1970 at Midnight).
File.lastModifiedDate Deprecated Read only Non-standard
Returns the last modified Date of the file referenced by the File object.
File.name Read only
Returns the name of the file referenced by the File object.
File.webkitRelativePath Read only
Returns the path the URL of the File is relative to.
Instance methods
The File interface also inherits methods from the Blob interface.
Specifications
| Specification |
|---|
| File API # file-section |