Window: requestFileSystem() 方法

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

非標準:此特性未標準化。我們不建議在生產環境中使用非標準特性,因為它們瀏覽器支援有限,並且可能會更改或被移除。但是,在沒有標準選項的特定情況下,它們可以是合適的替代方案。

非標準 Window 方法 requestFileSystem() 是一個 Google Chrome 特有的方法,允許網站或應用程式訪問一個沙盒檔案系統供其自身使用。返回的 FileSystem 物件隨後可用於其他 檔案系統 API

注意:在所有實現此方法的瀏覽器中,此方法都帶有 webkit 字首。

語法

js
requestFileSystem(type, size, successCallback)
requestFileSystem(type, size, successCallback, errorCallback)

引數

type

要請求的儲存型別。如果瀏覽器可以酌情刪除檔案(例如儲存空間不足時),請指定 Window.TEMPORARY;如果您需要檔案保持不變,除非使用者或網站或應用程式明確允許,請指定 Window.PERSISTENT。持久化儲存需要使用者授予站點配額。

size

您希望為您的應用程式分配的儲存空間大小。

successCallback

當檔案系統成功獲取時呼叫的函式。回撥函式接收一個引數:一個 FileSystem 物件,表示應用程式有許可權使用的檔案系統。

errorCallback 可選

一個可選引數,指定一個函式,在嘗試獲取檔案系統時發生錯誤,或者使用者拒絕建立或訪問檔案系統的許可權時呼叫。回撥函式接收一個引數作為輸入:一個描述錯誤的 DOMException 物件。

返回值

無(undefined)。

規範

由於此方法已從 檔案和目錄條目 API 提案中移除,因此它沒有官方的 W3C 或 WHATWG 規範。它不再有望成為標準。

瀏覽器相容性