MDN self-hosted library · e01.org

File

File API

no runnable cells web-api-interface upstream source

File API

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 input 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

  • File()
  • : Returns a newly constructed File.

Instance properties

The File interface also inherits properties from the Blob interface.

  • File.lastModified
  • : Returns the last modified time of the file, in millisecond since the UNIX epoch (January 1st, 1970 at Midnight).
  • File.lastModifiedDate
  • : Returns the last modified Date of the file referenced by the File object.
  • File.name
  • : Returns the name of the file referenced by the File object.
  • File.webkitRelativePath
  • : Returns the path the URL of the File is relative to.

Instance methods

The File interface also inherits methods from the Blob interface.

Specifications

Browser compatibility

See also