Revision 965665 of IDBMutableFile

<p>{{APIRef("File System API")}}{{non-standard_header}}</p>

<h2 id="Summary">Summary</h2>

<p>The <code>FileHandle</code> interface provides access in read or write mode to a file, dealing with all the necessary locks.</p>

<p>As <code>FileHandle</code> objects are bound to a fake file system built on top of IndexedDB, such an object is created using the {{domxref("IDBDatabase.mozCreateFileHandle")}} method.</p>

<h2>Properties</h2>

<dl>
 <dt>{{domxref("FileHandle.name")}} {{readonlyinline}}</dt>
 <dd>The name of the handled file.</dd>
 <dt>{{domxref("FileHandle.type")}} {{readonlyinline}}</dt>
 <dd>The mime type of the handled file.</dd>
</dl>

<h3 id="Events_Handler">Events Handler</h3>

<dl>
 <dt>{{domxref("FileHandle.onabort")}}</dt>
 <dd>The {{event("abort")}} event is triggered each time the handled file is aborted.</dd>
 <dt>{{domxref("FileHandle.onerror")}}</dt>
 <dd>The {{event("error")}} event is triggered each time something goes wrong.</dd>
</dl>

<h2>Methods</h2>

<dl>
 <dt>{{domxref("FileHandle.open()")}}</dt>
 <dd>Returns a {{domxref("LockedFile")}} object to read or write the associated file safely.</dd>
 <dt>{{domxref("FileHandle.getFile()")}}</dt>
 <dd>Returns a {{domxref("DOMRequest")}} object. In case of success, the request's result is a {{domxref("File")}} object representing a snapshot of the handled file.</dd>
</dl>

<h2>Specifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('FileSystem')}}</td>
   <td>{{Spec2('FileSystem')}}</td>
   <td>Draft proposal.</td>
  </tr>
 </tbody>
</table>

<h2 id="See_also" name="See_also">See also</h2>

<ul>
 <li>{{domxref("LockedFile")}}</li>
 <li>{{domxref("File")}}</li>
</ul>