File

File 介面提供了檔案的資訊並且允許網頁中的 JavaScript 存取檔案的內容。

File 物件通常是從使用者於 <input> 元素選擇之檔案所回傳的 FileList 物件當中取得，也可以來自拖放操作所產生的 DataTransfer 物件之中，或是由 HTMLCanvasElement 物件（元素物件）執行 mozGetAsFile() 方法後回傳。在 Gecko 引擎中，有專屬的程式碼能不需使用者操作即建立 File 物件來表示本地端的任一檔案（請參考 Implementation notes 以閱讀更多資訊）。

File 物件是一種特殊的 Blob，且可被用在任何接受 Blob 物件的地方。特別是 FileReader、URL.createObjectURL()、createImageBitmap() 和 XMLHttpRequest.send() 都能夠同樣接受 Blob 以及 File。

請參考在網頁應用程式中使用本地檔案的更多細節與範例。

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/zh-TW/docs/Web/API/Blob" target="_top"><rect x="1" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="38.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Blob</text></a><polyline points="76,25  86,20  86,30  76,25" stroke="#D4DDE4" fill="none"/><line x1="86" y1="25" x2="116" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/zh-TW/docs/Web/API/File" target="_top"><rect x="116" y="1" width="75" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="153.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">File</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

建構式

File()

回傳一個新建構的 File 物件。

屬性

File.lastModified Read only

回值檔案的最後修改時間，為 UNIX epoch 毫秒（自西元 1970 年一月 1 日零時至今）。

File.lastModifiedDate Read only

File 物件所代表之檔案的最後修改日期（Date）。

File.name Read only

File 物件所代表之檔案的名稱。

File.size Read only

回傳檔案大小。

File.webkitRelativePath Read only

回傳相對於 File 的網址位置。

File.type Read only

回傳檔案的 MIME 類型。

File 實作了 Blob，因此它也有以下可用屬性：

File.size Read only

回傳檔案大小（單位為位元組）。

File.type Read only

回傳檔案的 MIME 類型。

方法

File 介面沒有定義任何方法，但繼承了 Blob 介面的方法：

Blob.slice([start[, end[, contentType]]])

回傳新的 Blob 物件，包含 Blob 來源之指定位元組範圍的資料。

規範

瀏覽器相容性

實作備註

• In Gecko, you can use this API from within chrome code. See Using the DOM File API in chrome code for details. To use it from chrome code, JSM and Bootstrap scope, you have to import it using Cu.importGlobalProperties(['File']);
• Starting from Gecko 6.0 (Firefox 6.0 / Thunderbird 6.0 / SeaMonkey 2.3), privileged code (such as extensions) can pass an nsIFile object to the DOM File constructor to specify the file to reference.
• Starting from Gecko 8.0 (Firefox 8.0 / Thunderbird 8.0 / SeaMonkey 2.5), you can use new File to create File objects from XPCOM component code instead of having to instantiate the nsIDOMFile object directly. The constructor takes, in contrast to Blob, as second argument the filename. The filename can be any String.

  new File(
    Array parts,
    String filename, 
    BlobPropertyBag properties
  );

• The following non-standard properties and methods were removed in Gecko 7 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4): File.fileName, File.fileSize, File.getAsBinary(), File.getAsDataURL(), File.getAsText(string encoding) (bug 661876). Standard properties File.name, Blob.size, and methods on FileReader should be used instead.

參見

• 在網頁應用程式中使用本地檔案
• FileReader
• Using the DOM File API in chrome code (for privileged code running in Gecko, such as Firefox add-ons)