FileSystemFileHandle: getFile() 方法

Baseline 已廣泛支援

此功能已成熟，並可在許多裝置和瀏覽器版本上執行。自 2023 年 3 月以來，它已在各種瀏覽器中可用。

安全上下文： 此功能僅在安全上下文（HTTPS）中可用，且支援此功能的瀏覽器數量有限。

注意：此功能在 Web Workers 中可用。

getFile() 方法是 FileSystemFileHandle 介面的一部分，它返回一個 Promise，該 Promise 會解析為一個 File 物件，該物件代表了由該控制代碼表示的磁碟上的狀態。

如果在此方法呼叫後，磁碟上的檔案發生更改或被刪除，則返回的 File 物件可能將不再可讀。

語法

getFile()

引數

無。

返回值

一個 Promise，解析為一個 File 物件。

異常

NotAllowedError DOMException: 如果 read 模式下的 PermissionStatus.state 不是 granted，則會丟擲此異常。
NotFoundError DOMException: 如果當前條目未找到，則丟擲此異常。

示例

以下非同步函式顯示一個檔案選擇器，一旦選擇了一個檔案，就會使用 getFile() 方法檢索內容。

async function getTheFile() {
  // open file picker
  const [fileHandle] = await window.showOpenFilePicker(pickerOpts);

  // get file contents
  const fileData = await fileHandle.getFile();
}

規範

規範
檔案系統 # api-filesystemfilehandle-getfile

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 2024年10月6日，由 MDN 貢獻者。

在 GitHub 上檢視此頁面 • 報告此內容的問題