chrome.fileSystemProvider

Beschreibung

Verwende die chrome.fileSystemProvider API, um Dateisysteme zu erstellen, auf die unter ChromeOS über den Dateimanager zugegriffen werden kann.

Berechtigungen

fileSystemProvider

Verfügbarkeit

<ph type="x-smartling-placeholder"></ph> Nur ChromeOS

Manifest

Sie müssen „fileSystemProvider“ im Erweiterungsmanifest, 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 wie folgt deklariert werden:

configurable (boolesch) – optional
Gibt an, ob die Konfiguration über onConfigureRequested unterstützt wird. Der Standardwert ist „false“.
multiple_mounts (boolesch) – optional
Gibt an, ob mehrere (mehrere) bereitgestellte Dateisysteme unterstützt werden. Der Standardwert ist „false“.
watchable (boolesch) – optional
Ob das Festlegen von Watchern und Benachrichtigungen über Änderungen unterstützt werden. Der Standardwert ist „false“.
source (Enum von "file", "device" oder "network") – erforderlich
Datenquelle für bereitgestellte Dateisysteme.

Die Files App verwendet die oben genannten Informationen, um zugehörige UI-Elemente entsprechend zu rendern. Ist configurable beispielsweise auf „true“ gesetzt, wird ein Menüpunkt zum Konfigurieren von Volumes gerendert. Wenn multiple_mounts auf true gesetzt ist, erlaubt die Files App das Hinzufügen von mehr als einem Bereitstellungspunkt über die Benutzeroberfläche. Wenn watchable den Wert false hat, wird eine Aktualisierungsschaltfläche gerendert. Beachten Sie, dass Sie nach Möglichkeit Unterstützung für Watchers hinzufügen sollten, 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. Zu den Anwendungsfällen gehören das Dekomprimieren von Archiven und der Zugriff auf Dateien in einem anderen Cloud-Dienst als Drive.

Bereitstellen von Dateisystemen

Durch die Bereitstellung von Erweiterungen können entweder Inhalte des Dateisystems aus einer externen Quelle (z. B. einem Remote-Server oder USB-Gerät) bereitgestellt werden oder es wird eine lokale Datei (z. B. ein Archiv) als Eingabe verwendet.

Zum Schreiben von Dateisystemen, die Datei-Handler sind (Quelle ist "file"), muss es sich beim Anbieter um eine gepackte Anwendung handeln, da das onLaunched-Ereignis 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

Nach der Bereitstellung können bereitgestellte Dateisysteme über das Ereignis onConfigureRequested konfiguriert werden. Dies ist besonders nützlich für Dateisysteme, die Inhalte über das Netzwerk bereitstellen, um geeignete Anmeldedaten festzulegen. Die Verarbeitung dieses Ereignisses ist optional.

Lebenszyklus

Bereitgestellte Dateisysteme werden von Chrome gespeichert und nach einem Neustart automatisch wieder bereitgestellt. Wenn ein Dateisystem durch eine vorhandene Erweiterung bereitgestellt wird, bleibt es so lange bestehen, bis entweder die Erweiterung entladen wird oder die Erweiterung die Methode unmount aufruft.

Typen

AbortRequestedOptions

Attribute

  • fileSystemId

    String

    Die ID des Dateisystems, das für diesen Vorgang verwendet wird.

  • operationRequestId

    Zahl

    Eine ID der abzubrechenden Anfrage.

  • requestId

    Zahl

    Die eindeutige ID dieser Anfrage.

Action

Chrome (ab Version 45)

Attribute

  • id

    String

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

  • Titel

    String optional

    Der Titel der Aktion. Er wird bei gängigen Aktionen möglicherweise ignoriert.

AddWatcherRequestedOptions

Attribute

  • entryPath

    String

    Der Pfad des zu beobachtenden Eintrags.

  • fileSystemId

    String

    Die ID des Dateisystems, das für diesen Vorgang verwendet wird.

  • recursive

    boolean

    Gibt an, ob die Beobachtung alle untergeordneten Einträge rekursiv einschließen soll. Er kann nur für Verzeichnisse "true" sein.

  • requestId

    Zahl

    Die eindeutige ID dieser Anfrage.

Change

Attribute

  • changeType

    Die Art der Änderung, die an dem Eintrag vorgenommen wurde.

  • cloudFileInfo

    CloudFileInfo optional

    Chrome 125 oder höher

    Informationen zur Datei, sofern diese durch ein Cloud-Dateisystem gesichert sind.

  • entryPath

    String

    Der Pfad des geänderten Eintrags.

ChangeType

Typ einer im beobachteten Verzeichnis erkannten Änderung.

Enum

"GEÄNDERT"

„GELÖSCHT“

CloseFileRequestedOptions

Attribute

  • fileSystemId

    String

    Die ID des Dateisystems, das für diesen Vorgang verwendet wird.

  • openRequestId

    Zahl

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

  • requestId

    Zahl

    Die eindeutige ID 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 Anbieterkennung für die angegebene Datei bzw. das angegebene Verzeichnis.

  • providerName

    String

    Kennung des Cloud Storage-Anbieters (z.B. „drive.google.com“).

CommonActionId

Chrome (ab Version 45)

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

Enum

"SAVE_FOR_OFFLINE"

&quot;OFFLINE_NOT_NECESSARY&quot;

„TEILEN“

ConfigureRequestedOptions

Chrome (ab Version 44)

Attribute

  • fileSystemId

    String

    Die Kennung des zu konfigurierenden Dateisystems.

  • requestId

    Zahl

    Die eindeutige ID dieser Anfrage.

CopyEntryRequestedOptions

Attribute

  • fileSystemId

    String

    Die ID des Dateisystems für diesen Vorgang.

  • requestId

    Zahl

    Die eindeutige ID dieser Anfrage.

  • sourcePath

    String

    Der Quellpfad des Eintrags, der kopiert werden soll.

  • targetPath

    String

    Der Zielpfad für den Kopiervorgang.

CreateDirectoryRequestedOptions

Attribute

  • directoryPath

    String

    Der Pfad des Verzeichnisses, das erstellt werden soll.

  • fileSystemId

    String

    Die ID des Dateisystems, das für diesen Vorgang verwendet wird.

  • recursive

    boolean

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

  • requestId

    Zahl

    Die eindeutige ID dieser Anfrage.

CreateFileRequestedOptions

Attribute

  • filePath

    String

    Der Pfad der zu erstellenden Datei.

  • fileSystemId

    String

    Die ID des Dateisystems für diesen Vorgang.

  • requestId

    Zahl

    Die eindeutige ID dieser Anfrage.

DeleteEntryRequestedOptions

Attribute

  • entryPath

    String

    Der Pfad des Eintrags, der gelöscht werden soll.

  • fileSystemId

    String

    Die ID des Dateisystems, das für diesen Vorgang verwendet wird.

  • recursive

    boolean

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

  • requestId

    Zahl

    Die eindeutige ID 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 dies in options angefordert wird und die Datei durch Cloud-Speicher gestützt wird.

  • cloudIdentifier

    CloudIdentifier optional

    Chrome 117 oder höher

    Cloud Storage-Darstellung dieses Eintrags. Muss angegeben werden, wenn dies in options angefordert wird und die Datei durch Cloud-Speicher gesichert wird. Für lokale Dateien, die nicht durch Cloud-Speicher gesichert sind, sollte der Wert auf Anfrage nicht definiert sein.

  • isDirectory

    Boolescher Wert optional

    "True", wenn es sich um ein Verzeichnis handelt. Muss bei Anforderung in options angegeben werden.

  • mimeType

    String optional

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

  • modificationTime

    Datum optional

    Der Zeitpunkt der letzten Änderung dieses Eintrags. Muss bei Anforderung in options angegeben werden.

  • Name

    String optional

    Name dieses Eintrags (nicht der vollständige Pfadname). Darf nicht „/“ enthalten. Für den Stamm muss das Feld leer sein. Muss bei Anforderung in options angegeben werden.

  • Größe

    Zahl optional

    Dateigröße in Byte. Muss bei Anforderung in options angegeben werden.

  • thumbnail

    String optional

    Miniaturansicht als Daten-URI im PNG-, JPEG- oder WEBP-Format, maximal 32 KB groß. Optional, kann aber nur angegeben werden, wenn dies vom onGetMetadataRequested-Ereignis explizit angefordert wird.

ExecuteActionRequestedOptions

Chrome (ab Version 45)

Attribute

  • actionId

    String

    Die ID der auszuführenden Aktion.

  • entryPaths

    String[]

    Chrome 47 und höher

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

  • fileSystemId

    String

    Die ID des Dateisystems für diesen Vorgang.

  • requestId

    Zahl

    Die eindeutige ID dieser Anfrage.

FileSystemInfo

Attribute

  • displayName

    String

    Ein für Menschen lesbarer Name für das Dateisystem.

  • fileSystemId

    String

    Die Kennung des Dateisystems.

  • openedFiles

    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

    Boolescher Wert optional

    Chrome (ab Version 45)

    Gibt an, ob das Dateisystem das Feld tag zur Beobachtung von Verzeichnissen unterstützt.

  • Watcher
    Chrome (ab Version 45)

    Liste der Watcher.

  • Bearbeitbar

    boolean

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

GetActionsRequestedOptions

Chrome (ab Version 45)

Attribute

  • entryPaths

    String[]

    Chrome 47 und höher

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

  • fileSystemId

    String

    Die ID des Dateisystems für diesen Vorgang.

  • requestId

    Zahl

    Die eindeutige ID 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, zu dem Metadaten abgerufen werden sollen.

  • fileSystemId

    String

    Die ID des Dateisystems für diesen Vorgang.

  • isDirectory

    boolean

    Chrome (ab Version 49)

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

  • mimeType

    boolean

    Chrome (ab Version 49)

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

  • modificationTime

    boolean

    Chrome (ab Version 49)

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

  • Name

    boolean

    Chrome (ab Version 49)

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

  • requestId

    Zahl

    Die eindeutige ID dieser Anfrage.

  • Größe

    boolean

    Chrome (ab Version 49)

    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 für Menschen lesbarer Name für das Dateisystem.

  • fileSystemId

    String

    Die Zeichenfolgenkennung des Dateisystems. Muss für jede Erweiterung eindeutig sein.

  • openedFilesLimit

    Zahl optional

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

  • nichtflüchtige

    Boolescher Wert optional

    Chrome (ab Version 64)

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

  • supportsNotifyTag

    Boolescher Wert optional

    Chrome (ab Version 45)

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

  • Bearbeitbar

    Boolescher Wert optional

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

MoveEntryRequestedOptions

Attribute

  • fileSystemId

    String

    Die ID des Dateisystems für diesen Vorgang.

  • requestId

    Zahl

    Die eindeutige ID 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

    Die Art der Änderung, die am beobachteten Eintrag vorgenommen wurde. Bei DELETED wird der beobachtete Eintrag automatisch aus der Liste der beobachteten Einträge entfernt.

  • Änderungen

    Ändern[] optional

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

  • fileSystemId

    String

    Die ID des Dateisystems, das für diese Änderung gilt.

  • 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. Beachten Sie, dass dieses Flag erforderlich ist, um Benachrichtigungen über Änderungen bereitzustellen, die sich auch beim Herunterfahren des Systems geändert haben.

OpenedFile

Attribute

  • filePath

    String

    Der Pfad der geöffneten Datei.

  • Modus

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

  • openRequestId

    Zahl

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

OpenFileMode

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

Enum

„LESEN“

"WRITE"

OpenFileRequestedOptions

Attribute

  • filePath

    String

    Der Pfad der zu öffnenden Datei.

  • fileSystemId

    String

    Die ID des Dateisystems für diesen Vorgang.

  • Modus

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

  • requestId

    Zahl

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

ProviderError

Fehlercodes, die durch die Bereitstellung von Erweiterungen als Antwort auf Anfragen sowie im Fall von Fehlern beim Aufrufen von API-Methoden verwendet werden. Für Erfolg muss "OK" verwendet werden.

Enum

„OK“

"FEHLGESCHLAGEN"

„IN_USE“

„EXISTS“

"NOT_FOUND"

„ACCESS_DENIED“

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

„NOT_A_DIRECTORY“

"UNGÜLTIGE_OPERATION"

„SICHERHEIT“

"ABORT"

"NOT_A_FILE"

„NOT_EMPTY“

"INVALID_URL"

"IO"

ReadDirectoryRequestedOptions

Attribute

  • directoryPath

    String

    Der Pfad des Verzeichnisses, in dem Inhalte angefordert werden.

  • fileSystemId

    String

    Die ID des Dateisystems für diesen Vorgang.

  • isDirectory

    boolean

    Chrome (ab Version 49)

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

  • mimeType

    boolean

    Chrome (ab Version 49)

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

  • modificationTime

    boolean

    Chrome (ab Version 49)

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

  • Name

    boolean

    Chrome (ab Version 49)

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

  • requestId

    Zahl

    Die eindeutige ID dieser Anfrage.

  • Größe

    boolean

    Chrome (ab Version 49)

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

  • thumbnail

    boolean

    Chrome (ab Version 49)

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

ReadFileRequestedOptions

Attribute

  • fileSystemId

    String

    Die ID des Dateisystems für diesen Vorgang.

  • Länge

    Zahl

    Anzahl der zurückzugebenden Byte.

  • kompensiert

    Zahl

    Position in der Datei (in Byte), ab der mit dem Lesen beginnen soll.

  • openRequestId

    Zahl

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

  • requestId

    Zahl

    Die eindeutige ID dieser Anfrage.

RemoveWatcherRequestedOptions

Attribute

  • entryPath

    String

    Der Pfad des beobachteten Eintrags.

  • fileSystemId

    String

    Die ID des Dateisystems, das für diesen Vorgang verwendet wird.

  • recursive

    boolean

    Modus des Watchers.

  • requestId

    Zahl

    Die eindeutige ID dieser Anfrage.

TruncateRequestedOptions

Attribute

  • filePath

    String

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

  • fileSystemId

    String

    Die ID des Dateisystems für diesen Vorgang.

  • Länge

    Zahl

    Anzahl der Byte, die nach Abschluss des Vorgangs aufbewahrt werden sollen.

  • requestId

    Zahl

    Die eindeutige ID dieser Anfrage.

UnmountOptions

Attribute

  • fileSystemId

    String

    Die Kennung des Dateisystems, das entfernt werden soll.

UnmountRequestedOptions

Attribute

  • fileSystemId

    String

    Die Kennung des Dateisystems, das entfernt werden soll.

  • requestId

    Zahl

    Die eindeutige ID dieser Anfrage.

Watcher

Attribute

  • entryPath

    String

    Der Pfad des beobachteten Eintrags.

  • lastTag

    String optional

    Von der letzten Benachrichtigung für den Watcher verwendetes Tag.

  • recursive

    boolean

    Gibt an, ob bei der Beobachtung alle untergeordneten Einträge rekursiv eingeschlossen werden sollen. Er kann nur für Verzeichnisse "true" sein.

WriteFileRequestedOptions

Attribute

  • Daten

    ArrayBuffer

    Puffer von Bytes, die in die Datei geschrieben werden sollen.

  • fileSystemId

    String

    Die ID des Dateisystems für diesen Vorgang.

  • kompensiert

    Zahl

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

  • openRequestId

    Zahl

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

  • requestId

    Zahl

    Die eindeutige ID dieser Anfrage.

Methoden

get()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.fileSystemProvider.get(
  fileSystemId: string,
  callback?: function,
)

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

Parameter

  • fileSystemId

    String

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (fileSystem: FileSystemInfo) => void

Gibt Folgendes zurück:

  • Promise&lt;FileSystemInfo&gt;

    Chrome 96 und höher

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

getAll()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.fileSystemProvider.getAll(
  callback?: function,
)

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

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (fileSystems: FileSystemInfo[]) => void

Gibt Folgendes zurück:

  • Promise&lt;FileSystemInfo[]&gt;

    Chrome 96 und höher

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

mount()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.fileSystemProvider.mount(
  options: MountOptions,
  callback?: function,
)

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

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

Bei einem Fehler wird runtime.lastError mit einem entsprechenden Fehlercode festgelegt.

Parameter

  • Optionen
  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome 96 und höher

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

notify()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome (ab Version 45)
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
  callback?: function,
)

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

Wenn Sie die Manifestoption file_system_provider.notify verwenden möchten, muss sie auf „true“ gesetzt sein.

Der Wert für tag kann ein beliebiger String sein, der pro Aufruf eindeutig ist. So ist es möglich, die zuletzt registrierte Benachrichtigung zu identifizieren. Beispiel: Wenn die bereitgestellte Erweiterung nach einem Neustart startet und das Tag der letzten registrierten Benachrichtigung „123“ lautet, sollte notify für alle Änderungen aufgerufen werden, die seit der mit „123“ getaggten Änderung vorgenommen wurden. Der String darf nicht leer 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 Versionsnummer.

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

Wenn ein Fehler auftritt, wird für runtime.lastError ein entsprechender Fehlercode festgelegt.

Parameter

  • Optionen
  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome 96 und höher

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

unmount()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.fileSystemProvider.unmount(
  options: UnmountOptions,
  callback?: function,
)

Trennt ein Dateisystem mit dem angegebenen fileSystemId. Sie muss aufgerufen werden, nachdem onUnmountRequested aufgerufen wurde. Außerdem kann die betreffende Erweiterung entscheiden, ob die Bereitstellung aufgehoben wird, wenn sie nicht dazu aufgefordert wird (z. B. bei Verbindungsabbrüchen oder Dateifehlern).

Bei einem Fehler wird runtime.lastError mit einem entsprechenden Fehlercode festgelegt.

Parameter

  • Optionen
  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome 96 und höher

    Promise-Objekte 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 werden und successCallback dieser Abbruchanfrage muss ausgeführt werden. Wenn der Abbruch fehlschlägt, muss errorCallback aufgerufen werden. Callbacks des abgebrochenen Vorgangs dürfen nicht aufgerufen werden, da sie ignoriert werden. Trotz des Aufrufs von errorCallback kann der Abbruch der Anfrage erzwungen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      () => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => void

onAddWatcherRequested

Chrome (ab Version 45)
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein neuer Verzeichnis-Watcher angefordert wird. Wenn ein Fehler auftritt, muss errorCallback aufgerufen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      () => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => void

onCloseFileRequested

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

Wird ausgelöst, wenn das Schließen einer Datei angefordert wird, die zuvor mit openRequestId geöffnet wurde.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      () => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => void

onConfigureRequested

Chrome (ab Version 44)
chrome.fileSystemProvider.onConfigureRequested.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein Konfigurationsdialogfeld für fileSystemId angefordert wird. Wenn sie verarbeitet wird, muss die Verwaltungskontooption file_system_provider.configurable auf „true“ festgelegt werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      () => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => void

onCopyEntryRequested

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

Wird ausgelöst, wenn ein Eintrag (rekursiv, wenn ein Verzeichnis) angefordert wird. Wenn ein Fehler auftritt, muss errorCallback aufgerufen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      () => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => 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

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      () => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => void

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: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      () => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => 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: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      () => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => void

onExecuteActionRequested

Chrome (ab Version 48)
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
  callback: function,
)

Wird ausgelöst, wenn eine 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

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      () => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => void

onGetActionsRequested

Chrome (ab Version 48)
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 keine derartigen Aktionen vorhanden sind, sollte ein leeres Array zurückgegeben werden. Die Aktionen müssen mit dem successCallback-Aufruf zurückgegeben werden. Tritt ein Fehler auf, muss errorCallback aufgerufen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (actions: Action[]) => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => void

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 successCallback-Aufruf zurückgegeben werden. Tritt ein Fehler auf, muss errorCallback aufgerufen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

onMountRequested

Chrome (ab Version 44)
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 verwendet werden, um neue Dateisysteme beim Öffnen einer Datei bereitzustellen. Bei mehreren Bereitstellungen muss die Manifestoption file_system_provider.multiple_mounts auf „true“ gesetzt sein.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      () => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => void

onMoveEntryRequested

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

Wird ausgelöst, wenn ein Eintrag (rekursiv, wenn ein Verzeichnis) angefordert wird, um einen Eintrag zu verschieben. Wenn ein Fehler auftritt, muss errorCallback aufgerufen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      () => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => 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. Mit MountOptions kann die maximale Anzahl der gleichzeitig geöffneten Dateien angegeben werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

onReadDirectoryRequested

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

Wird ausgelöst, wenn Inhalte eines Verzeichnisses unter directoryPath angefordert werden. Die Ergebnisse müssen in Blöcken zurückgegeben werden, indem successCallback mehrmals aufgerufen wird. Tritt ein Fehler auf, muss errorCallback aufgerufen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (entries: EntryMetadata[], hasMore: boolean) => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => void

onReadFileRequested

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

Wird ausgelöst, wenn das Lesen des Inhalts einer zuvor mit openRequestId geöffneten Datei angefordert wird. Die Ergebnisse müssen in Blöcken zurückgegeben werden, indem successCallback mehrmals aufgerufen wird. Tritt ein Fehler auf, muss errorCallback aufgerufen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

      • Daten

        ArrayBuffer

      • hasMore

        boolean

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => void

onRemoveWatcherRequested

Chrome (ab Version 45)
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
  callback: function,
)

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

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      () => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => void

onTruncateRequested

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

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

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      () => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => void

onUnmountRequested

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

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

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      () => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => void

onWriteFileRequested

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

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

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • successCallback

      Funktion

      Der Parameter successCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      () => void

    • errorCallback

      Funktion

      Der Parameter errorCallback sieht so aus: <ph type="x-smartling-placeholder"></ph>

      (error: ProviderError) => void