File
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{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](/en-US/docs/Web/API/RequestInit#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
Fileobject. - {{DOMxRef("File.name")}} {{ReadOnlyInline}}
- : Returns the name of the file referenced by the
Fileobject. - {{DOMxRef("File.webkitRelativePath")}} {{ReadOnlyInline}}
- : Returns the path the URL of the
Fileis 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")}}