chrome.fileSystemProvider

refresh date: 2026-09-25 robots: noindex

Beschreibung

Mit der chrome.fileSystemProvider API können Sie Dateisysteme erstellen, auf die über den Dateimanager unter ChromeOS zugegriffen werden kann.

Berechtigungen

fileSystemProvider

Verfügbarkeit

Nur ChromeOS

Manifest

Sie müssen die Berechtigung und den Abschnitt „fileSystemProvider“ im Manifest der Erweiterung deklarieren, um die File System Provider API zu verwenden. Beispiel:

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

Der Abschnitt „file_system_provider“ muss so deklariert werden:

configurable (boolesch) – optional
Gibt an, ob die Konfiguration über onConfigureRequested unterstützt wird. Standard: false.
multiple_mounts (boolesch) – optional
Gibt an, ob mehrere (mehr als ein) bereitgestellte Dateisysteme unterstützt werden. Standard: false.
watchable (boolesch) – optional
Gibt an, ob das Festlegen von Beobachtern und das Benachrichtigen über Änderungen unterstützt werden. Standard: false.
source (Enum von „file“, „device“ oder „network“) – erforderlich
Datenquelle für bereitgestellte Dateisysteme.

Die Files App verwendet die oben genannten Informationen, um die entsprechenden UI-Elemente korrekt darzustellen. Wenn configurable beispielsweise auf „true“ gesetzt ist, wird ein Menüpunkt zum Konfigurieren von Volumes gerendert. Wenn multiple_mounts auf true festgelegt ist, können in der App „Dateien“ über die Benutzeroberfläche mehrere Bereitstellungspunkte hinzugefügt werden. Wenn watchable den Wert false hat, wird eine Schaltfläche zum Aktualisieren gerendert. Wenn möglich, sollten Sie Unterstützung für Watcher hinzufügen, damit Änderungen am Dateisystem sofort und automatisch übernommen werden können.

Übersicht

Mit der File System Provider API können Erweiterungen virtuelle Dateisysteme unterstützen, die im Dateimanager unter ChromeOS verfügbar sind. Anwendungsfälle sind beispielsweise das Dekomprimieren von Archiven und der Zugriff auf Dateien in einem anderen Cloud-Dienst als Drive.

Bereitstellen von Dateisystemen

Erweiterungen können entweder Dateisysteminhalte aus einer externen Quelle (z. B. einem Remote-Server oder einem USB-Gerät) bereitstellen oder eine lokale Datei (z. B. ein Archiv) als Eingabe verwenden.

Um Dateisysteme zu schreiben, die Datei-Handler sind (Quelle ist "file"), muss der Anbieter eine gepackte App sein, da das Ereignis onLaunched für Erweiterungen nicht verfügbar ist.

Wenn die Quelle ein Netzwerk oder ein Gerät ist, sollte das Dateisystem bereitgestellt werden, wenn das Ereignis onMountRequested aufgerufen wird.

Quelle der Dateisystemdaten Einstiegspunkt
"file" Nur für gepackte Apps verfügbar.
"device" oder "network" onMountRequested

Dateisysteme konfigurieren

Bereitgestellte Dateisysteme können nach dem Einbinden über das Ereignis onConfigureRequested konfiguriert werden. Dies ist besonders nützlich für Dateisysteme, die Inhalte über das Netzwerk bereitstellen, um die richtigen Anmeldedaten festzulegen. Die Verarbeitung dieses Ereignisses ist optional.

Lebenszyklus

Bereitgestellte Dateisysteme werden nach dem Einbinden von Chrome gespeichert und nach einem Neustart automatisch wieder eingebunden. Wenn ein Dateisystem von einer bereitstellenden Erweiterung bereitgestellt wird, bleibt es daher so lange bestehen, bis entweder die Erweiterung entladen wird oder die Erweiterung die Methode unmount aufruft.

Typen

AbortRequestedOptions

Attribute

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • operationRequestId

    Zahl

    Eine ID der abzubrechenden Anfrage.

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

Action

Chrome 45 oder höher

Attribute

  • id

    String

    Die Kennung der Aktion. Beliebiger String oder CommonActionId für gängige Aktionen.

  • Titel

    String optional

    Der Titel der Aktion. Bei gängigen Aktionen kann sie ignoriert werden.

AddWatcherRequestedOptions

Attribute

  • entryPath

    String

    Der Pfad des Eintrags, der beobachtet werden soll.

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • recursive

    boolean

    Gibt an, ob die Beobachtung alle untergeordneten Einträge rekursiv enthalten soll. Es kann nur für Verzeichnisse auf „true“ festgelegt sein.

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

Change

Attribute

  • changeType

    ChangeType

    Die Art der Änderung, die am Eintrag vorgenommen wurde.

  • cloudFileInfo

    CloudFileInfo optional

    Chrome 125 oder höher

    Informationen zur Datei, wenn sie von einem Cloud-Dateisystem unterstützt wird.

  • entryPath

    String

    Der Pfad des geänderten Eintrags.

ChangeType

Typ einer Änderung, die im beobachteten Verzeichnis erkannt wurde.

Enum

"CHANGED"

"DELETED"

CloseFileRequestedOptions

Attribute

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • openRequestId

    Zahl

    Eine Anfrage-ID, die zum Öffnen der Datei verwendet wird.

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

CloudFileInfo

Chrome 125 oder höher

Attribute

  • versionTag

    String optional

    Ein Tag, das die Version der Datei darstellt.

CloudIdentifier

Chrome 117 oder höher

Attribute

  • id

    String

    Die Kennung des Anbieters für die angegebene Datei oder das angegebene Verzeichnis.

  • providerName

    String

    ID für den Cloud-Speicheranbieter (z.B. „drive.google.com“).

CommonActionId

Chrome 45 oder höher

Liste häufiger Aktionen. "SHARE" dient zum Freigeben von Dateien für andere. "SAVE_FOR_OFFLINE" zum Anpinnen (Speichern für den Offlinezugriff). "OFFLINE_NOT_NECESSARY", um zu melden, dass die Datei nicht mehr für den Offlinezugriff gespeichert werden muss. Wird von onGetActionsRequested und onExecuteActionRequested verwendet.

Enum

"SAVE_FOR_OFFLINE"

"OFFLINE_NOT_NECESSARY"

TEILEN

ConfigureRequestedOptions

Chrome 44 oder höher

Attribute

  • fileSystemId

    String

    Die Kennung des zu konfigurierenden Dateisystems.

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

CopyEntryRequestedOptions

Attribute

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

  • sourcePath

    String

    Der Quellpfad des zu kopierenden Eintrags.

  • targetPath

    String

    Der Zielpfad für den Kopiervorgang.

CreateDirectoryRequestedOptions

Attribute

  • directoryPath

    String

    Der Pfad des Verzeichnisses, das erstellt werden soll.

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • recursive

    boolean

    Gibt an, ob der Vorgang rekursiv ist (nur für Verzeichnisse).

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

CreateFileRequestedOptions

Attribute

  • filePath

    String

    Der Pfad der Datei, die erstellt werden soll.

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

DeleteEntryRequestedOptions

Attribute

  • entryPath

    String

    Der Pfad des zu löschenden Eintrags.

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • recursive

    boolean

    Gibt an, ob der Vorgang rekursiv ist (nur für Verzeichnisse).

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

EntryMetadata

Attribute

  • cloudFileInfo

    CloudFileInfo optional

    Chrome 125 oder höher

    Informationen, die eine bestimmte Datei im zugrunde liegenden Cloud-Dateisystem identifizieren. Muss angegeben werden, wenn in options angefordert und die Datei in Cloud Storage gespeichert ist.

  • cloudIdentifier

    CloudIdentifier optional

    Chrome 117 oder höher

    Cloud Storage-Darstellung dieses Eintrags. Muss angegeben werden, wenn in options angefordert und die Datei in Cloud Storage gespeichert ist. Bei lokalen Dateien, die nicht in einem Cloud-Speicher gesichert sind, sollte der Wert bei der Anfrage „undefined“ sein.

  • isDirectory

    Boolesch optional

    „True“, wenn es sich um ein Verzeichnis handelt. Muss angegeben werden, wenn in options angefordert.

  • mimeType

    String optional

    MIME-Typ für den Eintrag. Immer optional, sollte aber angegeben werden, wenn in options angefordert.

  • modificationTime

    Datum optional

    Der Zeitpunkt der letzten Änderung dieses Eintrags. Muss angegeben werden, wenn in options angefordert.

  • name

    String optional

    Name dieses Eintrags (nicht der vollständige Pfadname). Darf kein „/“ enthalten. Für das Stammverzeichnis muss es leer sein. Muss angegeben werden, wenn in options angefordert.

  • Größe

    number optional

    Dateigröße in Byte. Muss angegeben werden, wenn in options angefordert.

  • Thumbnail

    String optional

    Thumbnail-Bild als Daten-URI im PNG-, JPEG- oder WEBP-Format mit einer Größe von maximal 32 KB. Optional, kann aber nur angegeben werden, wenn dies vom onGetMetadataRequested-Ereignis explizit angefordert wird.

ExecuteActionRequestedOptions

Chrome 45 oder höher

Attribute

  • actionId

    String

    Die Kennung der auszuführenden Aktion.

  • entryPaths

    String[]

    Chrome 47 oder höher

    Die Pfade der Einträge, die für die Aktion verwendet werden sollen.

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

FileSystemInfo

Attribute

  • displayName

    String

    Ein menschenlesbarer Name für das Dateisystem.

  • fileSystemId

    String

    Die Kennung des Dateisystems.

  • openedFiles

    OpenedFile[]

    Liste der aktuell geöffneten Dateien.

  • openedFilesLimit

    Zahl

    Die maximale Anzahl von Dateien, die gleichzeitig geöffnet werden können. Wenn 0, dann nicht begrenzt.

  • supportsNotifyTag

    Boolesch optional

    Chrome 45 oder höher

    Gibt an, ob das Dateisystem das Feld tag zum Beobachten von Verzeichnissen unterstützt.

  • watchers

    Watcher[]

    Chrome 45 oder höher

    Liste der Beobachter.

  • Bearbeitbar

    boolean

    Gibt an, ob das Dateisystem Vorgänge unterstützt, die den Inhalt des Dateisystems ändern können (z. B. das Erstellen, Löschen oder Schreiben von Dateien).

GetActionsRequestedOptions

Chrome 45 oder höher

Attribute

  • entryPaths

    String[]

    Chrome 47 oder höher

    Liste der Pfade von Einträgen für die Liste der Aktionen.

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

GetMetadataRequestedOptions

Attribute

  • cloudFileInfo

    boolean

    Chrome 125 oder höher

    Legen Sie true fest, wenn der Wert cloudFileInfo angefordert wird.

  • cloudIdentifier

    boolean

    Chrome 117 oder höher

    Legen Sie true fest, wenn der Wert cloudIdentifier angefordert wird.

  • entryPath

    String

    Der Pfad des Eintrags, für den Metadaten abgerufen werden sollen.

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • isDirectory

    boolean

    Chrome 49 oder höher

    Legen Sie true fest, wenn der Wert is_directory angefordert wird.

  • mimeType

    boolean

    Chrome 49 oder höher

    Legen Sie true fest, wenn der Wert mimeType angefordert wird.

  • modificationTime

    boolean

    Chrome 49 oder höher

    Legen Sie true fest, wenn der Wert modificationTime angefordert wird.

  • name

    boolean

    Chrome 49 oder höher

    Legen Sie true fest, wenn der Wert name angefordert wird.

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

  • Größe

    boolean

    Chrome 49 oder höher

    Legen Sie true fest, wenn der Wert size angefordert wird.

  • Thumbnail

    boolean

    Legen Sie true fest, wenn der Wert thumbnail angefordert wird.

MountOptions

Attribute

  • displayName

    String

    Ein menschenlesbarer Name für das Dateisystem.

  • fileSystemId

    String

    Die String-ID des Dateisystems. Muss für jede Erweiterung eindeutig sein.

  • openedFilesLimit

    number optional

    Die maximale Anzahl von Dateien, die gleichzeitig geöffnet werden können. Wenn nicht angegeben oder 0, gibt es keine Beschränkung.

  • nichtflüchtige

    Boolesch optional

    Chrome 64 oder höher

    Gibt an, ob das Framework das Dateisystem bei der nächsten Anmeldung fortsetzen soll. Standardmäßig „true“.

  • supportsNotifyTag

    Boolesch optional

    Chrome 45 oder höher

    Gibt an, ob das Dateisystem das Feld tag für beobachtete Verzeichnisse unterstützt.

  • Bearbeitbar

    Boolesch optional

    Gibt an, ob das Dateisystem Vorgänge unterstützt, die den Inhalt des Dateisystems ändern können (z. B. das Erstellen, Löschen oder Schreiben von Dateien).

MoveEntryRequestedOptions

Attribute

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

  • sourcePath

    String

    Der Quellpfad des Eintrags, der an einen neuen Ort verschoben werden soll.

  • targetPath

    String

    Der Zielpfad für den Kopiervorgang.

NotifyOptions

Attribute

  • changeType

    ChangeType

    Die Art der Änderung, die am beobachteten Eintrag vorgenommen wurde. Wenn er GELÖSCHT ist, wird der beobachtete Eintrag automatisch aus der Liste der beobachteten Einträge entfernt.

  • Änderungen

    Änderung[] optional

    Liste der Änderungen an Einträgen im beobachteten Verzeichnis (einschließlich des Eintrags selbst)

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit dieser Änderung zusammenhängt.

  • observedPath

    String

    Der Pfad des beobachteten Eintrags.

  • recursive

    boolean

    Modus des beobachteten Eintrags.

  • Tag

    String optional

    Tag für die Benachrichtigung. Erforderlich, wenn das Dateisystem mit der Option supportsNotifyTag bereitgestellt wurde. Dieses Flag ist erforderlich, um Benachrichtigungen über Änderungen zu erhalten, die auch dann vorgenommen wurden, wenn das System heruntergefahren war.

OpenedFile

Attribute

  • filePath

    String

    Der Pfad der geöffneten Datei.

  • Modus

    OpenFileMode

    Gibt an, ob die Datei zum Lesen oder Schreiben geöffnet wurde.

  • openRequestId

    Zahl

    Eine Anfrage-ID, die von aufeinanderfolgenden Lese-/Schreib- und Schließanfragen verwendet werden soll.

OpenFileMode

Modus zum Öffnen einer Datei. Wird von onOpenFileRequested verwendet.

Enum

"READ"

"WRITE"

OpenFileRequestedOptions

Attribute

  • filePath

    String

    Der Pfad der Datei, die geöffnet werden soll.

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • Modus

    OpenFileMode

    Gibt an, ob die Datei zum Lesen oder Schreiben verwendet wird.

  • requestId

    Zahl

    Eine Anfrage-ID, die von aufeinanderfolgenden Lese-/Schreib- und Schließanfragen verwendet wird.

ProviderError

Fehlercodes, die von Erweiterungen als Antwort auf Anfragen sowie bei Fehlern beim Aufrufen von Methoden der API verwendet werden. Für den Erfolg muss "OK" verwendet werden.

Enum

OK

"FAILED"

"IN_USE"

"EXISTS"

"NOT_FOUND"

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"INVALID_OPERATION"

"SECURITY"

"ABORT"

"NOT_A_FILE"

"NOT_EMPTY"

"INVALID_URL"

"IO"

ReadDirectoryRequestedOptions

Attribute

  • directoryPath

    String

    Der Pfad des Verzeichnisses, dessen Inhalt angefordert wird.

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • isDirectory

    boolean

    Chrome 49 oder höher

    Legen Sie true fest, wenn der Wert is_directory angefordert wird.

  • mimeType

    boolean

    Chrome 49 oder höher

    Legen Sie true fest, wenn der Wert mimeType angefordert wird.

  • modificationTime

    boolean

    Chrome 49 oder höher

    Legen Sie true fest, wenn der Wert modificationTime angefordert wird.

  • name

    boolean

    Chrome 49 oder höher

    Legen Sie true fest, wenn der Wert name angefordert wird.

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

  • Größe

    boolean

    Chrome 49 oder höher

    Legen Sie true fest, wenn der Wert size angefordert wird.

  • Thumbnail

    boolean

    Chrome 49 oder höher

    Legen Sie true fest, wenn der Wert thumbnail angefordert wird.

ReadFileRequestedOptions

Attribute

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • Länge

    Zahl

    Anzahl der zurückzugebenden Bytes.

  • kompensiert

    Zahl

    Position in der Datei (in Byte), ab der gelesen werden soll.

  • openRequestId

    Zahl

    Eine Anfrage-ID, die zum Öffnen der Datei verwendet wird.

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

RemoveWatcherRequestedOptions

Attribute

  • entryPath

    String

    Der Pfad des beobachteten Eintrags.

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • recursive

    boolean

    Modus des Watchers.

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

TruncateRequestedOptions

Attribute

  • filePath

    String

    Der Pfad der Datei, die gekürzt werden soll.

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • Länge

    Zahl

    Anzahl der Bytes, die nach Abschluss des Vorgangs beibehalten werden sollen.

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

UnmountOptions

Attribute

  • fileSystemId

    String

    Die Kennung des Dateisystems, dessen Bereitstellung aufgehoben werden soll.

UnmountRequestedOptions

Attribute

  • fileSystemId

    String

    Die Kennung des Dateisystems, dessen Bereitstellung aufgehoben werden soll.

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

Watcher

Attribute

  • entryPath

    String

    Der Pfad des beobachteten Eintrags.

  • lastTag

    String optional

    Tag, der von der letzten Benachrichtigung für den Watcher verwendet wurde.

  • recursive

    boolean

    Gibt an, ob alle untergeordneten Einträge rekursiv beobachtet werden sollen. Es kann nur für Verzeichnisse auf „true“ festgelegt sein.

WriteFileRequestedOptions

Attribute

  • Daten

    ArrayBuffer

    Byte-Zwischenspeicher, der in die Datei geschrieben werden soll.

  • fileSystemId

    String

    Die Kennung des Dateisystems, das mit diesem Vorgang verknüpft ist.

  • kompensiert

    Zahl

    Position in der Datei (in Byte), ab der die Bytes geschrieben werden sollen.

  • openRequestId

    Zahl

    Eine Anfrage-ID, die zum Öffnen der Datei verwendet wird.

  • requestId

    Zahl

    Die eindeutige Kennung dieser Anfrage.

Methoden

get()

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

Gibt Informationen zu einem Dateisystem mit der übergebenen fileSystemId zurück.

Parameter

  • fileSystemId

    String

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (fileSystem: FileSystemInfo) => void

Ausgabe

  • Promise<FileSystemInfo>

    Chrome 96 oder höher

    Callback, um das Ergebnis der Funktion get zu erhalten.

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getAll()

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

Gibt alle Dateisysteme zurück, die von der Erweiterung bereitgestellt werden.

Parameter

Ausgabe

  • Promise<FileSystemInfo[]>

    Chrome 96 oder höher

    Callback, um das Ergebnis der Funktion getAll zu erhalten.

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

mount()

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

Stellt ein Dateisystem mit dem angegebenen fileSystemId und displayName bereit. displayName wird im linken Bereich der App „Dateien“ angezeigt. displayName kann beliebige Zeichen enthalten, einschließlich „/“, darf aber kein leerer String sein. displayName muss beschreibend sein, aber nicht eindeutig. fileSystemId darf kein leerer String sein.

Je nach Typ des bereitgestellten Dateisystems muss die Option source entsprechend festgelegt werden.

Im Falle eines Fehlers wird runtime.lastError mit einem entsprechenden Fehlercode festgelegt.

Parameter

  • Optionen

    MountOptions

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 96 oder höher

    Ein generischer Ergebnis-Callback, der Erfolg oder Misserfolg angibt.

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

notify()

Promise Chrome 45 und höher 
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
  callback?: function,
): Promise<void>

Benachrichtigt über Änderungen im überwachten Verzeichnis unter observedPath im Modus recursive. Wenn das Dateisystem mit supportsNotifyTag bereitgestellt wird, muss tag angegeben werden. Alle Änderungen seit der letzten Benachrichtigung müssen immer gemeldet werden, auch wenn das System heruntergefahren wurde. Das letzte Tag kann mit getAll abgerufen werden.

Damit Sie diese Option verwenden können, muss die Manifestoption file_system_provider.notify auf „true“ gesetzt sein.

Der Wert von tag kann ein beliebiger String sein, der pro Aufruf eindeutig ist, sodass die zuletzt registrierte Benachrichtigung identifiziert werden kann. Wenn die bereitstellende Erweiterung beispielsweise nach einem Neustart gestartet wird und das Tag der letzten registrierten Benachrichtigung „123“ ist, sollte sie notify für alle Änderungen aufrufen, die seit der mit „123“ getaggten Änderung aufgetreten sind. Es darf kein leerer String sein.

Nicht alle Anbieter können ein Tag bereitstellen. Wenn das Dateisystem jedoch ein Änderungsprotokoll hat, kann das Tag z. B. eine Änderungsnummer oder eine Revisionsnummer sein.

Wenn ein übergeordnetes Verzeichnis entfernt wird, werden auch alle untergeordneten Einträge entfernt. Wenn sie beobachtet werden, muss die API darüber informiert werden. Wenn ein Verzeichnis umbenannt wird, werden alle untergeordneten Einträge entfernt, da es unter ihren ursprünglichen Pfaden keinen Eintrag mehr gibt.

Im Falle eines Fehlers wird runtime.lastError mit einem entsprechenden Fehlercode festgelegt.

Parameter

  • Optionen

    NotifyOptions

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 96 oder höher

    Ein generischer Ergebnis-Callback, der Erfolg oder Misserfolg angibt.

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

unmount()

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

Hebt die Bereitstellung eines Dateisystems mit der angegebenen fileSystemId auf. Sie muss nach dem Aufruf von onUnmountRequested aufgerufen werden. Außerdem kann die bereitstellende Erweiterung entscheiden, die Bereitstellung aufzuheben, wenn dies nicht angefordert wird (z. B. bei einer unterbrochenen Verbindung oder einem Dateifehler).

Im Falle eines Fehlers wird runtime.lastError mit einem entsprechenden Fehlercode festgelegt.

Parameter

  • Optionen

    UnmountOptions

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 96 oder höher

    Ein generischer Ergebnis-Callback, der Erfolg oder Misserfolg angibt.

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

Ereignisse

onAbortRequested

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

Wird ausgelöst, wenn der Abbruch eines Vorgangs mit operationRequestId angefordert wird. Der mit operationRequestId ausgeführte Vorgang muss sofort beendet und successCallback dieser Abbruchanfrage ausgeführt werden. Wenn der Abbruch fehlschlägt, muss errorCallback aufgerufen werden. Beachten Sie, dass Callbacks des abgebrochenen Vorgangs nicht aufgerufen werden dürfen, da sie ignoriert werden. Trotz des Aufrufs von errorCallback kann die Anfrage abgebrochen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

onAddWatcherRequested

Chrome 45 oder höher 
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

Wird ausgelöst, wenn das Einrichten eines neuen Verzeichnis-Watchers angefordert wird. Wenn ein Fehler auftritt, muss errorCallback aufgerufen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

onCloseFileRequested

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

Wird ausgelöst, wenn eine zuvor mit openRequestId geöffnete Datei geschlossen werden soll.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

onConfigureRequested

Chrome 44 oder höher 
chrome.fileSystemProvider.onConfigureRequested.addListener(
  callback: function,
)

Wird ausgelöst, wenn das Anzeigen eines Konfigurationsdialogfelds für fileSystemId angefordert wird. Wenn sie verarbeitet wird, muss die Manifestoption file_system_provider.configurable auf „true“ gesetzt werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

onCopyEntryRequested

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

Wird ausgelöst, wenn das Kopieren eines Eintrags (rekursiv, wenn es sich um ein Verzeichnis handelt) angefordert wird. Wenn ein Fehler auftritt, muss errorCallback aufgerufen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

onCreateDirectoryRequested

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

Wird ausgelöst, wenn das Erstellen eines Verzeichnisses angefordert wird. Der Vorgang muss mit dem Fehler EXISTS fehlschlagen, wenn das Zielverzeichnis bereits vorhanden ist. Wenn recursive „true“ ist, müssen alle fehlenden Verzeichnisse im Verzeichnispfad erstellt werden.

Parameter

onCreateFileRequested

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

Wird ausgelöst, wenn das Erstellen einer Datei angefordert wird. Wenn die Datei bereits vorhanden ist, muss errorCallback mit dem Fehlercode "EXISTS" aufgerufen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

onDeleteEntryRequested

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

Wird ausgelöst, wenn das Löschen eines Eintrags angefordert wird. Wenn recursive „true“ ist und der Eintrag ein Verzeichnis ist, müssen auch alle darin enthaltenen Einträge rekursiv gelöscht werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

onExecuteActionRequested

Chrome 48 oder höher 
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
  callback: function,
)

Wird ausgelöst, wenn die Ausführung einer Aktion für eine Reihe von Dateien oder Verzeichnissen angefordert wird. Nach Abschluss der Aktion muss successCallback aufgerufen werden. Bei einem Fehler muss errorCallback aufgerufen werden.

Parameter

onGetActionsRequested

Chrome 48 oder höher 
chrome.fileSystemProvider.onGetActionsRequested.addListener(
  callback: function,
)

Wird ausgelöst, wenn eine Liste von Aktionen für eine Reihe von Dateien oder Verzeichnissen unter entryPaths angefordert wird. Alle zurückgegebenen Aktionen müssen auf jeden Eintrag anwendbar sein. Wenn es keine solchen Aktionen gibt, sollte ein leeres Array zurückgegeben werden. Die Aktionen müssen mit dem successCallback-Aufruf zurückgegeben werden. Im Falle eines Fehlers muss errorCallback aufgerufen werden.

Parameter

onGetMetadataRequested

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

Wird ausgelöst, wenn Metadaten einer Datei oder eines Verzeichnisses unter entryPath angefordert werden. Die Metadaten müssen mit dem Aufruf successCallback zurückgegeben werden. Im Falle eines Fehlers muss errorCallback aufgerufen werden.

Parameter

onMountRequested

Chrome 44 oder höher 
chrome.fileSystemProvider.onMountRequested.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein Dialogfeld zum Bereitstellen eines neuen Dateisystems angefordert wird. Wenn die Erweiterung/App ein Datei-Handler ist, sollte dieses Ereignis nicht verarbeitet werden. Stattdessen sollte app.runtime.onLaunched verarbeitet werden, um neue Dateisysteme bereitzustellen, wenn eine Datei geöffnet wird. Bei mehreren Bereitstellungen muss die Manifestoption file_system_provider.multiple_mounts auf „true“ gesetzt sein.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: 

      () => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: 

      (error: ProviderError) => void

onMoveEntryRequested

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

Wird ausgelöst, wenn das Verschieben eines Eintrags (rekursiv, wenn es sich um ein Verzeichnis handelt) angefordert wird. Wenn ein Fehler auftritt, muss errorCallback aufgerufen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

onOpenFileRequested

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

Wird ausgelöst, wenn das Öffnen einer Datei unter filePath angefordert wird. Wenn die Datei nicht vorhanden ist, muss der Vorgang fehlschlagen. Die maximale Anzahl von Dateien, die gleichzeitig geöffnet werden können, kann mit MountOptions angegeben werden.

Parameter

onReadDirectoryRequested

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

Wird ausgelöst, wenn der Inhalt eines Verzeichnisses unter directoryPath angefordert wird. Die Ergebnisse müssen in Blöcken zurückgegeben werden, indem die successCallback mehrmals aufgerufen wird. Im Falle eines Fehlers muss errorCallback aufgerufen werden.

Parameter

onReadFileRequested

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

Wird ausgelöst, wenn der Inhalt einer zuvor mit openRequestId geöffneten Datei gelesen werden soll. Die Ergebnisse müssen in Blöcken zurückgegeben werden, indem successCallback mehrmals aufgerufen wird. Im Falle eines Fehlers muss errorCallback aufgerufen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: 

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

      • Daten

        ArrayBuffer

      • hasMore

        boolean

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: 

      (error: ProviderError) => void

onRemoveWatcherRequested

Chrome 45 oder höher 
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
  callback: function,
)

Wird ausgelöst, wenn der Watcher entfernt werden soll. Wenn ein Fehler auftritt, muss errorCallback aufgerufen werden.

Parameter

onTruncateRequested

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

Wird ausgelöst, wenn das Kürzen einer Datei auf eine gewünschte Länge angefordert wird. Wenn ein Fehler auftritt, muss errorCallback aufgerufen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

onUnmountRequested

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

Wird ausgelöst, wenn das Aufheben der Bereitstellung für das Dateisystem mit der Kennung fileSystemId angefordert wird. In der Antwort muss die API-Methode unmount zusammen mit successCallback aufgerufen werden. Wenn das Aufheben der Bereitstellung nicht möglich ist (z. B. aufgrund eines ausstehenden Vorgangs), muss errorCallback aufgerufen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

onWriteFileRequested

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

Wird ausgelöst, wenn das Schreiben von Inhalten in eine zuvor mit openRequestId geöffnete Datei angefordert wird.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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