chrome.fileSystemProvider

refresh date: 2026-09-25 robots: noindex

說明

使用 chrome.fileSystemProvider API 建立檔案系統，並透過 ChromeOS 上的檔案管理員存取。

權限

fileSystemProvider

可用性

僅適用於 ChromeOS

資訊清單

您必須在擴充功能資訊清單中宣告「fileSystemProvider」權限和區段，才能使用 File System Provider API。例如：

{
  "name": "My extension",
  ...
  "permissions": [
    "fileSystemProvider"
  ],
  ...
  "file_system_provider_capabilities": {
    "configurable": true,
    "watchable": false,
    "multiple_mounts": true,
    "source": "network"
  },
  ...
}

file_system_provider 區段必須宣告如下：

configurable (布林值) - 選用
是否支援透過 onConfigureRequested 進行設定。預設值：false。
multiple_mounts (布林值) - 選用
是否支援多個 (超過一個) 掛接的檔案系統。預設值：false。
watchable (布林值) - 選用
是否支援設定監看者及通知變更。預設值：false。
source (列舉「file」、「device」或「network」) - 必要
掛接檔案系統的資料來源。

「檔案」應用程式會使用上述資訊，適當算繪相關 UI 元素。舉例來說，如果 configurable 設為 true，系統就會顯示用於設定磁碟區的選單項目。同樣地，如果 multiple_mounts 設為 true，Files 應用程式就會允許從使用者介面新增多個掛接點。如果 watchable 為 false，系統會顯示重新整理按鈕。請注意，如果可以，您應該新增對監控程式的支援，以便立即自動反映檔案系統的變更。

總覽

File System Provider API 可讓擴充功能支援虛擬檔案系統，並在 ChromeOS 的檔案管理員中提供。用途包括解壓縮封存檔案，以及存取雲端硬碟以外雲端服務中的檔案。

掛接檔案系統

提供擴充功能可從外部來源 (例如遠端伺服器或 USB 裝置) 提供檔案系統內容，或使用本機檔案 (例如封存檔) 做為輸入內容。

如要寫入檔案系統做為檔案處理常式 (來源為 "file")，提供者必須是封裝應用程式，因為擴充功能無法使用 onLaunched 事件。

如果來源是網路或裝置，則應在呼叫 onMountRequested 事件時掛接檔案系統。

檔案系統資料的來源 進入點
"file" 僅適用於封裝應用程式。
"device" 或 "network" onMountRequested

設定檔案系統

提供的檔案系統在掛接後，可透過 onConfigureRequested 事件進行設定。這項功能特別適用於透過網路提供內容的檔案系統，以便設定適當的憑證。您可以選擇是否要處理這個事件。

生命週期

Chrome 會記住已掛接的檔案系統，並在重新啟動後自動重新掛接。因此，一旦提供擴充功能掛接檔案系統，該系統就會保留，直到擴充功能卸載或呼叫 unmount 方法為止。

類型

AbortRequestedOptions

屬性

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • operationRequestId

    數字

    要取消的要求 ID。

  • requestId

    數字

    這項要求的專屬 ID。

Action

Chrome 45 以上版本

屬性

  • id

    字串

    動作的 ID。任何字串或 CommonActionId (適用於常見動作)。

  • title

    字串 選填

    動作的名稱。如果是常見動作，系統可能會忽略這項屬性。

AddWatcherRequestedOptions

屬性

  • entryPath

    字串

    要觀測的項目路徑。

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • 遞迴

    布林值

    觀察是否應遞迴包含所有子項目。只有目錄可以設為 true。

  • requestId

    數字

    這項要求的專屬 ID。

Change

屬性

  • changeType

    ChangeType

    項目變更的類型。

  • cloudFileInfo

    CloudFileInfo 選填

    Chrome 125 以上版本

    檔案相關資訊 (如果由雲端檔案系統支援)。

  • entryPath

    字串

    變更項目的路徑。

ChangeType

在觀測目錄中偵測到的變更類型。

列舉

"CHANGED"

「DELETED」

CloseFileRequestedOptions

屬性

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • openRequestId

    數字

    用於開啟檔案的要求 ID。

  • requestId

    數字

    這項要求的專屬 ID。

CloudFileInfo

Chrome 125 以上版本

屬性

  • versionTag

    字串 選填

    代表檔案版本的標記。

CloudIdentifier

Chrome 117 以上版本

屬性

  • id

    字串

    提供者為指定檔案/目錄設定的 ID。

  • providerName

    字串

    雲端儲存空間供應商的 ID (例如「drive.google.com」)。

CommonActionId

Chrome 45 以上版本

常見動作清單。"SHARE" 可與他人共用檔案。"SAVE_FOR_OFFLINE"：固定 (儲存供離線存取)。"OFFLINE_NOT_NECESSARY"：通知系統不再需要儲存檔案供離線存取。由 onGetActionsRequested 和 onExecuteActionRequested 使用。

列舉

"SAVE_FOR_OFFLINE"

"OFFLINE_NOT_NECESSARY"

「分享」

ConfigureRequestedOptions

Chrome 44 以上版本

屬性

  • fileSystemId

    字串

    要設定的檔案系統 ID。

  • requestId

    數字

    這項要求的專屬 ID。

CopyEntryRequestedOptions

屬性

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • requestId

    數字

    這項要求的專屬 ID。

  • sourcePath

    字串

    要複製的項目來源路徑。

  • targetPath

    字串

    複製作業的目的地路徑。

CreateDirectoryRequestedOptions

屬性

  • directoryPath

    字串

    要建立的目錄路徑。

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • 遞迴

    布林值

    作業是否為遞迴 (僅限目錄)。

  • requestId

    數字

    這項要求的專屬 ID。

CreateFileRequestedOptions

屬性

  • filePath

    字串

    要建立的檔案路徑。

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • requestId

    數字

    這項要求的專屬 ID。

DeleteEntryRequestedOptions

屬性

  • entryPath

    字串

    要刪除的項目路徑。

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • 遞迴

    布林值

    作業是否為遞迴 (僅限目錄)。

  • requestId

    數字

    這項要求的專屬 ID。

EntryMetadata

屬性

  • cloudFileInfo

    CloudFileInfo 選填

    Chrome 125 以上版本

    用於識別基礎雲端檔案系統中特定檔案的資訊。如果 options 要求提供，且檔案由雲端儲存空間支援，則必須提供。

  • cloudIdentifier

    CloudIdentifier 選填

    Chrome 117 以上版本

    這個項目的 Cloud Storage 表示法。如果 options 要求提供，且檔案由雲端儲存空間支援，則必須提供。如果本機檔案未備份至雲端儲存空間，則在要求時應為未定義。

  • isDirectory

    布林值 選填

    如果是目錄，則為 True。如果 options 要求，則必須提供。

  • mimeType

    字串 選填

    項目的 MIME 類型。一律為選填，但如果 options 要求，則應提供。

  • modificationTime

    日期 選填

    這個項目的上次修改時間。如果 options 要求，則必須提供。

  • 名稱

    字串 選填

    這個項目的名稱 (非完整路徑名稱)。不得包含「/」。根目錄必須留空。如果 options 要求，則必須提供。

  • 大小

    數字 選填

    檔案大小 (以位元組為單位)。如果 options 要求，則必須提供。

  • 縮圖

    字串 選填

    縮圖圖片，格式為 PNG、JPEG 或 WEBP 的資料 URI，大小不超過 32 KB。選用，但只有在 onGetMetadataRequested 事件明確要求時才能提供。

ExecuteActionRequestedOptions

Chrome 45 以上版本

屬性

  • actionId

    字串

    要執行的動作 ID。

  • entryPaths

    string[]

    Chrome 47 以上版本

    要用於動作的項目路徑組合。

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • requestId

    數字

    這項要求的專屬 ID。

FileSystemInfo

屬性

  • displayName

    字串

    人類可讀的檔案系統名稱。

  • fileSystemId

    字串

    檔案系統的 ID。

  • openedFiles

    OpenedFile[]

    目前開啟的檔案清單。

  • openedFilesLimit

    數字

    一次可開啟的檔案數量上限。如果設為 0，則不設限。

  • supportsNotifyTag

    布林值 選填

    Chrome 45 以上版本

    檔案系統是否支援用於觀測目錄的 tag 欄位。

  • watchers

    Watcher[]

    Chrome 45 以上版本

    觀察者清單。

  • 可寫入

    布林值

    檔案系統是否支援可能變更檔案系統內容的作業 (例如建立、刪除或寫入檔案)。

GetActionsRequestedOptions

Chrome 45 以上版本

屬性

  • entryPaths

    string[]

    Chrome 47 以上版本

    動作清單的項目路徑清單。

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • requestId

    數字

    這項要求的專屬 ID。

GetMetadataRequestedOptions

屬性

  • cloudFileInfo

    布林值

    Chrome 125 以上版本

    如果要求 cloudFileInfo 值，請設為 true。

  • cloudIdentifier

    布林值

    Chrome 117 以上版本

    如果要求 cloudIdentifier 值，請設為 true。

  • entryPath

    字串

    要擷取中繼資料的項目路徑。

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • isDirectory

    布林值

    Chrome 49 以上版本

    如果要求 is_directory 值，請設為 true。

  • mimeType

    布林值

    Chrome 49 以上版本

    如果要求 mimeType 值，請設為 true。

  • modificationTime

    布林值

    Chrome 49 以上版本

    如果要求 modificationTime 值，請設為 true。

  • 名稱

    布林值

    Chrome 49 以上版本

    如果要求 name 值，請設為 true。

  • requestId

    數字

    這項要求的專屬 ID。

  • 大小

    布林值

    Chrome 49 以上版本

    如果要求 size 值，請設為 true。

  • 縮圖

    布林值

    如果要求 thumbnail 值，請設為 true。

MountOptions

屬性

  • displayName

    字串

    人類可讀的檔案系統名稱。

  • fileSystemId

    字串

    檔案系統的字串 ID。每個擴充功能不得重複。

  • openedFilesLimit

    數字 選填

    一次可開啟的檔案數量上限。如未指定或設為 0，則不設限。

  • 永久

    布林值 選填

    Chrome 64 以上版本

    架構是否應在下次登入工作階段時繼續使用檔案系統。預設為 True。

  • supportsNotifyTag

    布林值 選填

    Chrome 45 以上版本

    檔案系統是否支援觀測目錄的 tag 欄位。

  • 可寫入

    布林值 選填

    檔案系統是否支援可能變更檔案系統內容的作業 (例如建立、刪除或寫入檔案)。

MoveEntryRequestedOptions

屬性

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • requestId

    數字

    這項要求的專屬 ID。

  • sourcePath

    字串

    要移至新位置的項目來源路徑。

  • targetPath

    字串

    複製作業的目的地路徑。

NotifyOptions

屬性

  • changeType

    ChangeType

    觀察到的項目發生的變更類型。如果狀態為「DELETED」，系統會自動從觀察項目清單中移除觀察項目。

  • 變更

    Change[] 選填

    觀察目錄中項目的變更清單 (包括項目本身)

  • fileSystemId

    字串

    與這項變更相關的檔案系統 ID。

  • observedPath

    字串

    觀察項目的路徑。

  • 遞迴

    布林值

    觀測項目的模式。

  • 標記

    字串 選填

    通知的標記。如果檔案系統是以 supportsNotifyTag 選項掛接，則為必填。請注意，即使系統關閉，也必須提供這項標記，才能提供有關變更的通知。

OpenedFile

屬性

  • filePath

    字串

    開啟檔案的路徑。

  • 模式

    OpenFileMode

    開啟檔案是為了讀取或寫入。

  • openRequestId

    數字

    連續讀取/寫入和關閉要求使用的要求 ID。

OpenFileMode

開啟檔案的模式。由 onOpenFileRequested 使用。

列舉

「READ」

"WRITE"

OpenFileRequestedOptions

屬性

  • filePath

    字串

    要開啟的檔案路徑。

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • 模式

    OpenFileMode

    檔案是否會用於讀取或寫入。

  • requestId

    數字

    要求 ID，用於連續讀取/寫入和關閉要求。

ProviderError

提供擴充功能時，用於回應要求的錯誤代碼，以及呼叫 API 方法時發生錯誤的錯誤代碼。如要成功，必須使用 "OK"。

列舉

「好」

"FAILED"

"IN_USE"

"EXISTS"

"NOT_FOUND"

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"INVALID_OPERATION"

「安全性」

"ABORT"

"NOT_A_FILE"

"NOT_EMPTY"

"INVALID_URL"

「IO」

ReadDirectoryRequestedOptions

屬性

  • directoryPath

    字串

    要求內容的目錄路徑。

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • isDirectory

    布林值

    Chrome 49 以上版本

    如果要求 is_directory 值，請設為 true。

  • mimeType

    布林值

    Chrome 49 以上版本

    如果要求 mimeType 值，請設為 true。

  • modificationTime

    布林值

    Chrome 49 以上版本

    如果要求 modificationTime 值，請設為 true。

  • 名稱

    布林值

    Chrome 49 以上版本

    如果要求 name 值，請設為 true。

  • requestId

    數字

    這項要求的專屬 ID。

  • 大小

    布林值

    Chrome 49 以上版本

    如果要求 size 值，請設為 true。

  • 縮圖

    布林值

    Chrome 49 以上版本

    如果要求 thumbnail 值，請設為 true。

ReadFileRequestedOptions

屬性

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • 長度

    數字

    要傳回的位元組數。

  • 碳補償

    數字

    檔案中要開始讀取的位置 (以位元組為單位)。

  • openRequestId

    數字

    用於開啟檔案的要求 ID。

  • requestId

    數字

    這項要求的專屬 ID。

RemoveWatcherRequestedOptions

屬性

  • entryPath

    字串

    監控項目的路徑。

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • 遞迴

    布林值

    看守工具的模式。

  • requestId

    數字

    這項要求的專屬 ID。

TruncateRequestedOptions

屬性

  • filePath

    字串

    要截斷的檔案路徑。

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • 長度

    數字

    作業完成後要保留的位元組數。

  • requestId

    數字

    這項要求的專屬 ID。

UnmountOptions

屬性

  • fileSystemId

    字串

    要卸載的檔案系統 ID。

UnmountRequestedOptions

屬性

  • fileSystemId

    字串

    要卸載的檔案系統 ID。

  • requestId

    數字

    這項要求的專屬 ID。

Watcher

屬性

  • entryPath

    字串

    觀察中項目的路徑。

  • lastTag

    字串 選填

    觀察器上次通知使用的標記。

  • 遞迴

    布林值

    監控作業是否應以遞迴方式納入所有子項目。只有目錄可以設為 true。

WriteFileRequestedOptions

屬性

  • 資料

    ArrayBuffer

    要寫入檔案的位元組緩衝區。

  • fileSystemId

    字串

    與這項作業相關的檔案系統 ID。

  • 碳補償

    數字

    檔案中開始寫入位元組的位置 (以位元組為單位)。

  • openRequestId

    數字

    用於開啟檔案的要求 ID。

  • requestId

    數字

    這項要求的專屬 ID。

方法

get()

Promise 
chrome.fileSystemProvider.get(
  fileSystemId: string,
  callback?: function,
): Promise<FileSystemInfo>

傳回檔案系統的資訊，並附上傳遞的 fileSystemId。

參數

傳回

  • Promise<FileSystemInfo>

    Chrome 96 以上版本

    接收 get 函式結果的回呼。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

getAll()

Promise 
chrome.fileSystemProvider.getAll(
  callback?: function,
): Promise<FileSystemInfo[]>

傳回擴充功能掛接的所有檔案系統。

參數

傳回

  • Promise<FileSystemInfo[]>

    Chrome 96 以上版本

    接收 getAll 函式結果的回呼。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

mount()

Promise 
chrome.fileSystemProvider.mount(
  options: MountOptions,
  callback?: function,
): Promise<void>

使用指定的 fileSystemId 和 displayName 掛接檔案系統。displayName 會顯示在「檔案」應用程式的左側面板中。displayName 可以包含任何字元 (包括「/」)，但不得為空白字串。displayName 必須具有描述性，但不一定要是專屬名稱。fileSystemId 不得為空白字串。

視要掛接的檔案系統類型而定，source 選項必須設為適當的值。

如果發生錯誤，runtime.lastError 會設為對應的錯誤代碼。

參數

  • 選項

    MountOptions

  • callback

    函式 選填

    callback 參數如下： 

    () => void

傳回

  • 承諾<void>

    Chrome 96 以上版本

    一般結果回呼，用於指出成功或失敗。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

notify()

Promise Chrome 45 以上版本 
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
  callback?: function,
): Promise<void>

在 recursive 模式下，通知 observedPath 監控目錄中的變更。如果檔案系統是以 supportsNotifyTag 掛接，則必須提供 tag，且一律回報上次通知後的所有變更，即使系統已關機也一樣。您可以使用 getAll 取得最後一個標記。

如要使用，請將 file_system_provider.notify 資訊清單選項設為 true。

tag 的值可以是每次呼叫都不重複的任何字串，因此可以識別上次註冊的通知。舉例來說，如果提供擴充功能在重新啟動後啟動，且最後註冊的通知標記等於「123」，則應針對自標記為「123」的變更後發生的所有變更呼叫 notify。不得為空字串。

並非所有供應商都能提供標記，但如果檔案系統有變更記錄，標記可以是變更編號或修訂版本編號。

請注意，如果移除上層目錄，所有子系項目也會一併移除，如果這些項目受到監控，則必須通知 API。此外，如果重新命名目錄，所有子系項目實際上都會遭到移除，因為原始路徑下不再有任何項目。

如果發生錯誤，runtime.lastError 會設為對應的錯誤代碼。

參數

  • 選項

    NotifyOptions

  • callback

    函式 選填

    callback 參數如下： 

    () => void

傳回

  • 承諾<void>

    Chrome 96 以上版本

    一般結果回呼，用於指出成功或失敗。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

unmount()

Promise 
chrome.fileSystemProvider.unmount(
  options: UnmountOptions,
  callback?: function,
): Promise<void>

使用指定的 fileSystemId 卸載檔案系統。必須在叫用 onUnmountRequested 後呼叫。此外，如果未收到要求，提供擴充功能可以決定執行卸載 (例如連線中斷或檔案錯誤)。

如果發生錯誤，runtime.lastError 會設為對應的錯誤代碼。

參數

  • callback

    函式 選填

    callback 參數如下： 

    () => void

傳回

  • 承諾<void>

    Chrome 96 以上版本

    一般結果回呼，用於指出成功或失敗。

    Promise 僅適用於 Manifest V3 以上版本，其他平台則須使用回呼。

事件

onAbortRequested

chrome.fileSystemProvider.onAbortRequested.addListener(
  callback: function,
)

要求使用 operationRequestId 中止作業時，系統會引發這個事件。必須立即停止使用 operationRequestId 執行的作業，並執行這項中止要求的 successCallback。如果取消失敗，則必須呼叫 errorCallback。請注意，系統會忽略已取消作業的回呼，因此請勿呼叫。即使呼叫 errorCallback，要求仍可能強制取消。

參數

  • callback

    函式

    callback 參數如下： 

    (options: AbortRequestedOptions, successCallback: function, errorCallback: function) => void

onAddWatcherRequested

Chrome 45 以上版本 
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

在要求設定新的目錄監控程式時觸發。如果發生錯誤，則必須呼叫 errorCallback。

參數

onCloseFileRequested

chrome.fileSystemProvider.onCloseFileRequested.addListener(
  callback: function,
)

開啟先前以 openRequestId 開啟的檔案時，系統要求關閉該檔案，就會引發這個事件。

參數

onConfigureRequested

Chrome 44 以上版本 
chrome.fileSystemProvider.onConfigureRequested.addListener(
  callback: function,
)

要求顯示 fileSystemId 的設定對話方塊時，系統會引發這個事件。如果已處理，file_system_provider.configurable 資訊清單選項必須設為 true。

參數

onCopyEntryRequested

chrome.fileSystemProvider.onCopyEntryRequested.addListener(
  callback: function,
)

要求複製項目 (如果是目錄，則以遞迴方式複製) 時，系統會引發這個事件。如果發生錯誤，則必須呼叫 errorCallback。

參數

onCreateDirectoryRequested

chrome.fileSystemProvider.onCreateDirectoryRequested.addListener(
  callback: function,
)

在要求建立目錄時觸發。如果目標目錄已存在，作業必須失敗，並顯示 EXISTS 錯誤。如果 recursive 為 true，則必須建立目錄路徑中所有缺少的目錄。

參數

onCreateFileRequested

chrome.fileSystemProvider.onCreateFileRequested.addListener(
  callback: function,
)

在要求建立檔案時觸發。如果檔案已存在，則必須使用 "EXISTS" 錯誤代碼呼叫 errorCallback。

參數

onDeleteEntryRequested

chrome.fileSystemProvider.onDeleteEntryRequested.addListener(
  callback: function,
)

在要求刪除項目時觸發。如果 recursive 為 true，且項目是目錄，則其中的所有項目也必須遞迴刪除。

參數

onExecuteActionRequested

Chrome 48 以上版本 
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
  callback: function,
)

當系統要求對一組檔案或目錄執行動作時，就會引發這個事件。動作完成後，必須呼叫 successCallback。發生錯誤時，必須呼叫 errorCallback。

參數

onGetActionsRequested

Chrome 48 以上版本 
chrome.fileSystemProvider.onGetActionsRequested.addListener(
  callback: function,
)

要求 entryPaths 處一組檔案或目錄的動作清單時，系統會引發這個事件。傳回的所有動作都必須適用於每個項目。如果沒有這類動作，則應傳回空白陣列。動作必須透過 successCallback 呼叫傳回。如果發生錯誤，則必須呼叫 errorCallback。

參數

onGetMetadataRequested

chrome.fileSystemProvider.onGetMetadataRequested.addListener(
  callback: function,
)

在要求 entryPath 的檔案或目錄中繼資料時觸發。中繼資料必須與 successCallback 呼叫一併傳回。如果發生錯誤，則必須呼叫 errorCallback。

參數

onMountRequested

Chrome 44 以上版本 
chrome.fileSystemProvider.onMountRequested.addListener(
  callback: function,
)

要求顯示對話方塊來掛接新檔案系統時，就會引發這個事件。如果擴充功能/應用程式是檔案處理常式，則不應處理這個事件。請改為處理 app.runtime.onLaunched，以便在開啟檔案時掛接新的檔案系統。如要掛接多個磁碟區，請務必將 file_system_provider.multiple_mounts 資訊清單選項設為 true。

參數

  • callback

    函式

    callback 參數如下： 

    (successCallback: function, errorCallback: function) => void

    • successCallback

      函式

      successCallback 參數如下： 

      () => void

    • errorCallback

      函式

      errorCallback 參數如下： 

      (error: ProviderError) => void

onMoveEntryRequested

chrome.fileSystemProvider.onMoveEntryRequested.addListener(
  callback: function,
)

在要求移動項目 (如果是目錄，則為遞迴) 時觸發。如果發生錯誤，則必須呼叫 errorCallback。

參數

onOpenFileRequested

chrome.fileSystemProvider.onOpenFileRequested.addListener(
  callback: function,
)

要求開啟 filePath 的檔案時觸發。如果檔案不存在，作業就會失敗。您可以使用 MountOptions 指定一次開啟的檔案數量上限。

參數

onReadDirectoryRequested

chrome.fileSystemProvider.onReadDirectoryRequested.addListener(
  callback: function,
)

要求 directoryPath 目錄的內容時，系統會引發這個事件。結果必須多次呼叫 successCallback，分批傳回。如果發生錯誤，則必須呼叫 errorCallback。

參數

onReadFileRequested

chrome.fileSystemProvider.onReadFileRequested.addListener(
  callback: function,
)

要求讀取先前以 openRequestId 開啟的檔案內容時，系統會引發這個事件。結果必須多次呼叫 successCallback，以區塊形式傳回。如果發生錯誤，則必須呼叫 errorCallback。

參數

  • callback

    函式

    callback 參數如下： 

    (options: ReadFileRequestedOptions, successCallback: function, errorCallback: function) => void

    • successCallback

      函式

      successCallback 參數如下： 

      (data: ArrayBuffer, hasMore: boolean) => void

      • 資料

        ArrayBuffer

      • hasMore

        布林值

    • errorCallback

      函式

      errorCallback 參數如下： 

      (error: ProviderError) => void

onRemoveWatcherRequested

Chrome 45 以上版本 
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
  callback: function,
)

在應移除監控程式時觸發。如果發生錯誤，則必須呼叫 errorCallback。

參數

onTruncateRequested

chrome.fileSystemProvider.onTruncateRequested.addListener(
  callback: function,
)

在要求將檔案截斷至所需長度時觸發。如果發生錯誤，則必須呼叫 errorCallback。

參數

onUnmountRequested

chrome.fileSystemProvider.onUnmountRequested.addListener(
  callback: function,
)

要求卸載 ID 為 fileSystemId 的檔案系統時，系統會引發這個事件。在回應中，unmount API 方法必須與 successCallback 一起呼叫。如果無法卸載 (例如因作業待處理)，則必須呼叫 errorCallback。

參數

onWriteFileRequested

chrome.fileSystemProvider.onWriteFileRequested.addListener(
  callback: function,
)

要求將內容寫入先前使用 openRequestId 開啟的檔案時，系統會引發這個例外狀況。

參數