File

{{APIRef("File API")}} {{AvailableInWorkers}} 

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 {{DOMxRef("FileList")}}  object returned as a result of a user selecting files using the {{HTMLElement("input")}}  element, or from a drag and drop operation’s {{DOMxRef("DataTransfer")}}  object.

A File object is a specific kind of {{DOMxRef("Blob")}} , and can be used in any context that a Blob can. In particular, the following APIs accept both Blobs and File objects:

• {{DOMxRef("FileReader")}} 
• {{DOMxRef("URL.createObjectURL_static", "URL.createObjectURL()")}} 
• {{DOMxRef("Window.createImageBitmap()")}}  and {{DOMxRef("WorkerGlobalScope.createImageBitmap()")}} 
• the body option to {{domxref("Window/fetch", "fetch()")}} 
• {{DOMxRef("XMLHttpRequest.send()")}} 

See Using files from web applications for more information and examples.

{{InheritanceDiagram}} 

Constructor

• {{DOMxRef("File.File", "File()")}} 
  • : Returns a newly constructed File.

Instance properties

The File interface also inherits properties from the {{DOMxRef("Blob")}}  interface.

• {{DOMxRef("File.lastModified")}}  {{ReadOnlyInline}} 
  • : Returns the last modified time of the file, in millisecond since the UNIX epoch (January 1st, 1970 at Midnight).
• {{DOMxRef("File.lastModifiedDate")}}  {{Deprecated_Inline}}  {{ReadOnlyInline}}  {{Non-standard_Inline}} 
  • : Returns the last modified {{JSxRef("Date")}}  of the file referenced by the File object.
• {{DOMxRef("File.name")}}  {{ReadOnlyInline}} 
  • : Returns the name of the file referenced by the File object.
• {{DOMxRef("File.webkitRelativePath")}}  {{ReadOnlyInline}} 
  • : Returns the path the URL of the File is relative to.

Instance methods

The File interface also inherits methods from the {{DOMxRef("Blob")}}  interface.

Specifications

{{Specifications}} 

Browser compatibility

{{Compat}} 

See also

• Using files from web applications
• {{DOMxRef("FileReader")}}