class js.html.File extends Blob

Available on js

The File object provides information about -- and access to the contents of -- files. These 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.

Gecko 2.0 note
(Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

Starting in Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1) , the File object inherits from the Blob  interface, which provides methods and properties providing further information about the file.

The file reference can be saved when the form is submitted while the user is offline, so that the data can be retrieved and uploaded when the Internet connection is restored.

Note: The File object as implemented by Gecko offers several non-standard methods for reading the contents of the file. These should not be used, as they will prevent your web application from being used in other browsers, as well as in future versions of Gecko, which will likely remove these methods.


Documentation for this class was provided by MDN.

Instance Fields

var name:String

The name of the file referenced by the File object. Read only. <span title="(Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0) ">Requires Gecko 1.9.2