chrome.fileSystemProvider

Beschrijving

Gebruik de chrome.fileSystemProvider API om bestandssystemen te creëren die toegankelijk zijn vanuit de bestandsbeheerder van Chrome OS.

Toestemmingen

fileSystemProvider

Beschikbaarheid

alleen ChromeOS

Manifest

Om de File System Provider API te kunnen gebruiken, moet u de machtiging en sectie "fileSystemProvider" in het extensiemanifest declareren. Bijvoorbeeld:

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

De sectie file_system_provider moet als volgt worden gedeclareerd:

configurable (booleaans) - optioneel
Of configuratie via onConfigureRequested wordt ondersteund. Standaard: false.
multiple_mounts (boolean) - optioneel
Of meerdere (meer dan één) gekoppelde bestandssystemen worden ondersteund. Standaard: false.
watchable (boolean) - optioneel
Of het instellen van watchers en het versturen van meldingen over wijzigingen wordt ondersteund. Standaard: false.
source (opsomming van "bestand", "apparaat" of "netwerk") - verplicht
Gegevensbron voor gekoppelde bestandssystemen.

De Bestanden-app gebruikt bovenstaande informatie om de bijbehorende UI-elementen correct weer te geven. Als bijvoorbeeld configurable is ingesteld op 'true', wordt een menu-item voor het configureren van volumes weergegeven. Evenzo, als multiple_mounts is ingesteld op true , staat de Bestanden-app toe om meer dan één mountpoint toe te voegen via de UI. Als watchable is ingesteld op false , wordt een vernieuwingsknop weergegeven. Het is aan te raden om, indien mogelijk, ondersteuning voor watchers toe te voegen, zodat wijzigingen in het bestandssysteem direct en automatisch worden doorgevoerd.

Overzicht

De File System Provider API maakt het mogelijk voor extensies om virtuele bestandssystemen te ondersteunen, die beschikbaar zijn in de bestandsbeheerder van ChromeOS. Gebruiksscenario's zijn onder andere het decomprimeren van archieven en het openen van bestanden in een cloudservice anders dan Drive.

Bestandssystemen koppelen

Het opgeven van extensies kan op twee manieren: door de inhoud van het bestandssysteem van een externe bron te halen (zoals een externe server of een USB-apparaat), of door een lokaal bestand (zoals een archief) als invoer te gebruiken.

Om bestandssystemen te kunnen schrijven die bestandshandlers zijn (bron is "file" ), moet de provider een verpakte app zijn, aangezien de onLaunched -gebeurtenis niet beschikbaar is voor extensies.

Als de bron een netwerk of een apparaat is, moet het bestandssysteem worden aangekoppeld wanneer de onMountRequested -gebeurtenis wordt aangeroepen.

Bron van de bestandssysteemgegevens Toegangspunt
"file" Alleen beschikbaar voor apps die als pakket worden meegeleverd.
"device" of "network" onMountRequested

Bestandssystemen configureren

Aangeleverde bestandssystemen kunnen na het aankoppelen worden geconfigureerd via de onConfigureRequested -gebeurtenis. Dit is met name handig voor bestandssystemen die inhoud via het netwerk beschikbaar stellen, om de juiste inloggegevens in te stellen. Het afhandelen van deze gebeurtenis is optioneel.

Levenscyclus

Eenmaal aangekoppelde bestandssystemen worden door Chrome onthouden en na een herstart automatisch opnieuw aangekoppeld. Zodra een bestandssysteem dus door een extensie is aangekoppeld , blijft het aangekoppeld totdat de extensie wordt verwijderd of de extensie de unmount- methode aanroept.

Soorten

AbortRequestedOptions

Eigenschappen

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • operationRequestId

    nummer

    Een ID van het verzoek dat moet worden geannuleerd.

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

Action

Chrome 45+

Eigenschappen

  • id

    snaar

    De identificatiecode van de actie. Elke tekenreeks of CommonActionId voor algemene acties.

  • titel

    string optioneel

    De titel van de vordering. Deze kan bij gewone vorderingen worden weggelaten.

AddWatcherRequestedOptions

Eigenschappen

  • ingangspad

    snaar

    Het te observeren toegangspad.

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • recursief

    booleaans

    Of het observeren alle onderliggende items recursief moet omvatten. Dit kan alleen voor mappen gelden.

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

Change

Eigenschappen

  • changeType

    ChangeType

    Het type wijziging dat in de invoer heeft plaatsgevonden.

  • cloudFileInfo

    CloudFileInfo optioneel

    Chrome 125+

    Informatie met betrekking tot het bestand indien het wordt opgeslagen in een cloudbestandssysteem.

  • ingangspad

    snaar

    Het pad van de gewijzigde invoer.

ChangeType

Type wijziging gedetecteerd in de geobserveerde map.

Enum

"VERANDERD"

"VERWIJDERD"

CloseFileRequestedOptions

Eigenschappen

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • openRequestId

    nummer

    Een aanvraag-ID die gebruikt wordt om het bestand te openen.

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

CloudFileInfo

Chrome 125+

Eigenschappen

  • versieTag

    string optioneel

    Een label dat de versie van het bestand aangeeft.

CloudIdentifier

Chrome 117+

Eigenschappen

  • id

    snaar

    De provider-ID voor het betreffende bestand/de betreffende map.

  • providerName

    snaar

    Identificatiecode voor de cloudopslagprovider (bijv. 'drive.google.com').

CommonActionId

Chrome 45+

Lijst met veelgebruikte acties. "SHARE" is voor het delen van bestanden met anderen. "SAVE_FOR_OFFLINE" is voor het vastzetten (opslaan voor offline toegang). "OFFLINE_NOT_NECESSARY" is voor het aangeven dat het bestand niet langer hoeft te worden opgeslagen voor offline toegang. Gebruikt door onGetActionsRequested en onExecuteActionRequested .

Enum

"OPSLAAN VOOR OFFLINE"

"OFFLINE_NIET_NODIG"

"DEEL"

ConfigureRequestedOptions

Chrome 44+

Eigenschappen

  • bestandssysteem-ID

    snaar

    De identificatiecode van het te configureren bestandssysteem.

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

CopyEntryRequestedOptions

Eigenschappen

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

  • bronpad

    snaar

    Het bronpad van het te kopiëren item.

  • doelpad

    snaar

    Het bestemmingspad voor de kopieerbewerking.

CreateDirectoryRequestedOptions

Eigenschappen

  • mapPath

    snaar

    Het pad naar de map die moet worden aangemaakt.

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • recursief

    booleaans

    Of de bewerking recursief is (alleen voor mappen).

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

CreateFileRequestedOptions

Eigenschappen

  • bestandspad

    snaar

    Het pad naar het aan te maken bestand.

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

DeleteEntryRequestedOptions

Eigenschappen

  • ingangspad

    snaar

    Het pad van het te verwijderen item.

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • recursief

    booleaans

    Of de bewerking recursief is (alleen voor mappen).

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

EntryMetadata

Eigenschappen

  • cloudFileInfo

    CloudFileInfo optioneel

    Chrome 125+

    Informatie die een specifiek bestand in het onderliggende cloudbestandssysteem identificeert. Moet worden verstrekt indien hierom wordt gevraagd in options en het bestand wordt opgeslagen in de cloud.

  • cloudIdentifier

    CloudIdentifier optioneel

    Chrome 117+

    Weergave van deze vermelding in de cloud. Moet worden opgegeven indien gevraagd in options en het bestand wordt opgeslagen in de cloud. Voor lokale bestanden die niet in de cloud worden opgeslagen, moet deze waarde ongedefinieerd blijven indien gevraagd.

  • isDirectory

    boolean optioneel

    Als het een map betreft, is dit waar. Moet worden opgegeven indien dit in options is aangegeven.

  • mimeType

    string optioneel

    MIME-type voor de invoer. Altijd optioneel, maar moet worden opgegeven indien hierom wordt gevraagd in options .

  • wijzigingstijd

    Datum optioneel

    De laatste wijzigingstijd van dit item. Moet worden opgegeven indien hierom wordt gevraagd in options .

  • naam

    string optioneel

    Naam van dit item (niet het volledige pad). Mag geen '/' bevatten. Voor root moet het leeg zijn. Moet worden opgegeven indien gevraagd in options .

  • maat

    nummer optioneel

    Bestandsgrootte in bytes. Moet worden opgegeven indien gevraagd in options .

  • miniatuur

    string optioneel

    Miniatuurafbeelding als data-URI in PNG-, JPEG- of WEBP-formaat, met een maximale grootte van 32 KB. Optioneel, maar kan alleen worden verstrekt indien expliciet aangevraagd door de onGetMetadataRequested -gebeurtenis.

ExecuteActionRequestedOptions

Chrome 45+

Eigenschappen

  • actie-ID

    snaar

    De identificatiecode van de uit te voeren actie.

  • ingangspaden

    snaar[]

    Chrome 47+

    De set paden van de items die voor de actie gebruikt moeten worden.

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

FileSystemInfo

Eigenschappen

  • displayweergave

    snaar

    Een voor mensen leesbare naam voor het bestandssysteem.

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem.

  • geopende bestanden

    OpenedFile []

    Lijst met momenteel geopende bestanden.

  • openedFilesLimit

    nummer

    Het maximale aantal bestanden dat tegelijk geopend kan worden. Als dit 0 is, is er geen limiet.

  • ondersteuntNotifyTag

    boolean optioneel

    Chrome 45+

    Of het bestandssysteem het tag ondersteunt voor het observeren van mappen.

  • kijkers

    Watcher []

    Chrome 45+

    Lijst met kijkers.

  • beschrijfbaar

    booleaans

    Of het bestandssysteem bewerkingen ondersteunt die de inhoud van het bestandssysteem kunnen wijzigen (zoals het aanmaken, verwijderen of schrijven van bestanden).

GetActionsRequestedOptions

Chrome 45+

Eigenschappen

  • ingangspaden

    snaar[]

    Chrome 47+

    Lijst met paden naar items voor de lijst met acties.

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

GetMetadataRequestedOptions

Eigenschappen

  • cloudFileInfo

    booleaans

    Chrome 125+

    Stel deze waarde in op ' true als de waarde cloudFileInfo wordt opgevraagd.

  • cloudIdentifier

    booleaans

    Chrome 117+

    Stel deze waarde in op ' true als er cloudIdentifier waarde wordt opgevraagd.

  • ingangspad

    snaar

    Het pad naar de vermelding waarover metadata moeten worden opgehaald.

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • isDirectory

    booleaans

    Chrome 49+

    Stel deze waarde in op true als er om een ​​waarde is_directory wordt gevraagd.

  • mimeType

    booleaans

    Chrome 49+

    Stel deze waarde in op ' true als er mimeType waarde wordt opgevraagd.

  • wijzigingstijd

    booleaans

    Chrome 49+

    Stel deze waarde in op ' true als er een waarde modificationTime wordt opgevraagd.

  • naam

    booleaans

    Chrome 49+

    Stel deze waarde in op ' true als er om name wordt gevraagd.

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

  • maat

    booleaans

    Chrome 49+

    Stel deze waarde in op ' true als er size wordt opgevraagd.

  • miniatuur

    booleaans

    Stel deze waarde in op ' true als er om thumbnail wordt gevraagd.

MountOptions

Eigenschappen

  • displayweergave

    snaar

    Een voor mensen leesbare naam voor het bestandssysteem.

  • bestandssysteem-ID

    snaar

    De tekenreeksidentificatiecode van het bestandssysteem. Moet uniek zijn voor elke extensie.

  • openedFilesLimit

    nummer optioneel

    Het maximale aantal bestanden dat tegelijk geopend kan worden. Indien niet gespecificeerd, of 0, dan is er geen limiet.

  • volhardend

    boolean optioneel

    Chrome 64+

    Of het framework het bestandssysteem bij de volgende aanmeldingssessie moet hervatten. Standaardwaarde is True.

  • ondersteuntNotifyTag

    boolean optioneel

    Chrome 45+

    Of het bestandssysteem het tag voor waargenomen mappen ondersteunt.

  • beschrijfbaar

    boolean optioneel

    Of het bestandssysteem bewerkingen ondersteunt die de inhoud van het bestandssysteem kunnen wijzigen (zoals het aanmaken, verwijderen of schrijven van bestanden).

MoveEntryRequestedOptions

Eigenschappen

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

  • bronpad

    snaar

    Het bronpad van het item dat naar een nieuwe locatie moet worden verplaatst.

  • doelpad

    snaar

    Het bestemmingspad voor de kopieerbewerking.

NotifyOptions

Eigenschappen

  • changeType

    ChangeType

    Het type wijziging dat heeft plaatsgevonden in de waargenomen vermelding. Als deze is VERWIJDERD, wordt de waargenomen vermelding automatisch verwijderd uit de lijst met waargenomen vermeldingen.

  • veranderingen

    Wijzig [] optioneel

    Lijst met wijzigingen aan items in de geobserveerde map (inclusief het item zelf).

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze wijziging hoort.

  • waargenomen pad

    snaar

    Het traject van de waargenomen inzending.

  • recursief

    booleaans

    Wijze van de waargenomen instroom.

  • tag

    string optioneel

    Tag voor de notificatie. Vereist als het bestandssysteem is aangekoppeld met de optie supportsNotifyTag . Houd er rekening mee dat deze vlag nodig is om notificaties te kunnen versturen over wijzigingen die ook hebben plaatsgevonden toen het systeem werd afgesloten.

OpenedFile

Eigenschappen

  • bestandspad

    snaar

    Het pad van het geopende bestand.

  • Of het bestand nu geopend was om te lezen of om erin te schrijven.

  • openRequestId

    nummer

    Een aanvraag-ID die gebruikt zal worden door opeenvolgende lees-/schrijf- en sluitverzoeken.

OpenFileMode

De manier waarop een bestand wordt geopend. Wordt gebruikt door onOpenFileRequested .

Enum

"LEZEN"

"SCHRIJVEN"

OpenFileRequestedOptions

Eigenschappen

  • bestandspad

    snaar

    Het pad naar het te openen bestand.

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • Of het bestand gebruikt zal worden om te lezen of om te schrijven.

  • verzoek-ID

    nummer

    Een aanvraag-ID die gebruikt zal worden door opeenvolgende lees-/schrijf- en sluitverzoeken.

ProviderError

Foutcodes worden gebruikt bij het verstrekken van extensies als reactie op verzoeken, evenals in geval van fouten bij het aanroepen van API-methoden. Voor succes moet "OK" worden gebruikt.

Enum

"OK"

"MISLUKT"

"IN_USE"

"BESTAAT"

"NIET GEVONDEN"

"TOEGANG GEWEIGERD"

"TE_VEEL_GEOPEND"

"GEEN_GEHEUGEN"

"GEEN SPATIE"

"GEEN_MAP"

"ONGELDIGE_OPERATIE"

"BEVEILIGING"

"AFBREKEN"

"GEEN_BESTAND"

"NIET_LEEG"

"ONGELDIGE_URL"

"IO"

ReadDirectoryRequestedOptions

Eigenschappen

  • mapPath

    snaar

    Het pad naar de map waarvan de inhoud wordt opgevraagd.

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • isDirectory

    booleaans

    Chrome 49+

    Stel deze waarde in op true als er om een ​​waarde is_directory wordt gevraagd.

  • mimeType

    booleaans

    Chrome 49+

    Stel deze waarde in op ' true als er mimeType waarde wordt opgevraagd.

  • wijzigingstijd

    booleaans

    Chrome 49+

    Stel deze waarde in op ' true als er een waarde modificationTime wordt opgevraagd.

  • naam

    booleaans

    Chrome 49+

    Stel deze waarde in op ' true als er om name wordt gevraagd.

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

  • maat

    booleaans

    Chrome 49+

    Stel deze waarde in op ' true als er size wordt opgevraagd.

  • miniatuur

    booleaans

    Chrome 49+

    Stel deze waarde in op ' true als er om thumbnail wordt gevraagd.

ReadFileRequestedOptions

Eigenschappen

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • lengte

    nummer

    Aantal bytes dat moet worden geretourneerd.

  • verschuiving

    nummer

    Positie in het bestand (in bytes) waar het lezen moet beginnen.

  • openRequestId

    nummer

    Een aanvraag-ID die gebruikt wordt om het bestand te openen.

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

RemoveWatcherRequestedOptions

Eigenschappen

  • ingangspad

    snaar

    Het pad van de bekeken inzending.

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • recursief

    booleaans

    Modus van de waarnemer.

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

TruncateRequestedOptions

Eigenschappen

  • bestandspad

    snaar

    Het pad van het bestand dat moet worden ingekort.

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • lengte

    nummer

    Aantal bytes dat bewaard moet blijven nadat de bewerking is voltooid.

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

UnmountOptions

Eigenschappen

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat moet worden ontkoppeld.

UnmountRequestedOptions

Eigenschappen

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat moet worden ontkoppeld.

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

Watcher

Eigenschappen

  • ingangspad

    snaar

    Het waargenomen pad van de inkomende beweging.

  • laatste tag

    string optioneel

    De tag die gebruikt is in de laatste melding voor de volger.

  • recursief

    booleaans

    Of het bewaken alle onderliggende items recursief moet omvatten. Dit kan alleen voor mappen gelden.

WriteFileRequestedOptions

Eigenschappen

  • gegevens

    ArrayBuffer

    Buffer met bytes die naar het bestand moeten worden geschreven.

  • bestandssysteem-ID

    snaar

    De identificatiecode van het bestandssysteem dat bij deze bewerking hoort.

  • verschuiving

    nummer

    De positie in het bestand (in bytes) waar het schrijven van de bytes moet beginnen.

  • openRequestId

    nummer

    Een aanvraag-ID die gebruikt wordt om het bestand te openen.

  • verzoek-ID

    nummer

    De unieke identificatiecode van dit verzoek.

Methoden

get()

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

Geeft informatie terug over een bestandssysteem met de opgegeven fileSystemId .

Parameters

  • bestandssysteem-ID

    snaar

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (fileSystem: FileSystemInfo) => void

Retourneert

  • Promise< FileSystemInfo >

    Chrome 96+

    Callbackfunctie om het resultaat van de get -functie te ontvangen.

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getAll()

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

Geeft alle bestandssystemen terug die door de extensie zijn aangekoppeld.

Parameters

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (fileSystems: FileSystemInfo[]) => void

Retourneert

  • Promise< FileSystemInfo []>

    Chrome 96+

    Callbackfunctie om het resultaat van de getAll -functie te ontvangen.

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

mount()

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

Hiermee wordt een bestandssysteem gekoppeld met de opgegeven fileSystemId en displayName . displayName wordt weergegeven in het linkerpaneel van de app Bestanden. displayName mag alle tekens bevatten, inclusief '/', maar mag geen lege tekenreeks zijn. displayName moet beschrijvend zijn, maar hoeft niet uniek te zijn. De fileSystemId mag geen lege tekenreeks zijn.

Afhankelijk van het type bestandssysteem dat wordt aangekoppeld, moet de source dienovereenkomstig worden ingesteld.

In geval van een fout wordt runtime.lastError ingesteld met de bijbehorende foutcode.

Parameters

  • opties

    Montageopties

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 96+

    Een algemene callback-functie die aangeeft of het project geslaagd of mislukt is.

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

notify()

Promise Chrome 45+
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
  callback?: function,
): Promise<void>

Geeft een melding over wijzigingen in de bewaakte map op observedPath in recursive modus. Als het bestandssysteem is aangekoppeld met supportsNotifyTag , moet tag worden opgegeven en worden alle wijzigingen sinds de laatste melding altijd gerapporteerd, zelfs als het systeem is afgesloten. De laatste tag kan worden verkregen met getAll .

Om dit te kunnen gebruiken, moet de manifestoptie file_system_provider.notify op true worden ingesteld.

De waarde van de tag kan elke tekenreeks zijn die uniek is per aanroep, zodat de laatst geregistreerde melding kan worden geïdentificeerd. Bijvoorbeeld: als de leverende extensie na een herstart opstart en de tag van de laatst geregistreerde melding gelijk is aan "123", dan moet deze notify aanroepen voor alle wijzigingen die hebben plaatsgevonden sinds de wijziging met de tag "123". De waarde mag geen lege tekenreeks zijn.

Niet alle aanbieders kunnen een tag leveren, maar als het bestandssysteem een ​​wijzigingslogboek heeft, kan de tag bijvoorbeeld een wijzigingsnummer of een revisienummer zijn.

Houd er rekening mee dat als een bovenliggende map wordt verwijderd, alle onderliggende mappen ook worden verwijderd. Als deze mappen worden bewaakt, moet de API hiervan op de hoogte worden gesteld. Ook als een map wordt hernoemd, worden alle onderliggende mappen verwijderd, omdat er geen map meer bestaat onder de oorspronkelijke paden.

In geval van een fout wordt runtime.lastError ingesteld met de bijbehorende foutcode.

Parameters

  • opties

    NotifyOptions

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 96+

    Een algemene callback-functie die aangeeft of het project geslaagd of mislukt is.

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

unmount()

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

Ontkoppelt een bestandssysteem met de opgegeven fileSystemId . Deze functie moet worden aangeroepen nadat onUnmountRequested is geactiveerd. De extensie die de functie levert, kan er ook voor kiezen om het ontkoppelen uit te voeren als hier niet om wordt gevraagd (bijvoorbeeld in geval van een verbroken verbinding of een bestandsfout).

In geval van een fout wordt runtime.lastError ingesteld met de bijbehorende foutcode.

Parameters

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 96+

    Een algemene callback-functie die aangeeft of het project geslaagd of mislukt is.

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

Evenementen

onAbortRequested

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

Deze uitzondering wordt gegenereerd wanneer een verzoek wordt ingediend om een ​​bewerking met operationRequestId af te breken. De bewerking die met operationRequestId wordt uitgevoerd, moet onmiddellijk worden gestopt en successCallback van dit afbreekverzoek moet worden uitgevoerd. Als het afbreken mislukt, moet errorCallback worden aangeroepen. Houd er rekening mee dat callbacks van de afgebroken bewerking niet mogen worden aangeroepen, omdat deze worden genegeerd. Ondanks het aanroepen van errorCallback kan het verzoek alsnog geforceerd worden afgebroken.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

    • succesCallback

      functie

      De parameter successCallback ziet er als volgt uit: 

      () => void

    • fout-callback

      functie

      De parameter errorCallback ziet er als volgt uit: 

      (error: ProviderError) => void

onAddWatcherRequested

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

Deze uitzondering wordt gegenereerd wanneer een nieuwe directory watcher wordt aangevraagd. Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

onCloseFileRequested

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

Deze foutmelding verschijnt wanneer een bestand dat eerder met openRequestId is geopend, moet worden gesloten.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

onConfigureRequested

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

Deze uitzondering treedt op wanneer een configuratiedialoogvenster voor fileSystemId wordt opgevraagd. Indien deze uitzondering wordt verwerkt, moet de manifestoptie file_system_provider.configurable op true worden ingesteld.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

onCopyEntryRequested

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

Deze uitzondering wordt gegenereerd wanneer het kopiëren van een item (recursief als het een map betreft) wordt aangevraagd. Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

onCreateDirectoryRequested

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

Deze uitzondering treedt op wanneer het aanmaken van een map wordt aangevraagd. De bewerking moet mislukken met de EXISTS-fout als de doelmap al bestaat. Als recursive waar is, moeten alle ontbrekende mappen in het mappad worden aangemaakt.

Parameters

onCreateFileRequested

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

Deze uitzondering wordt gegenereerd wanneer het aanmaken van een bestand wordt aangevraagd. Als het bestand al bestaat, moet errorCallback worden aangeroepen met de foutcode "EXISTS" .

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

onDeleteEntryRequested

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

Deze uitzondering wordt gegenereerd wanneer het verwijderen van een item wordt aangevraagd. Als recursive waar is en het item een ​​map is, moeten alle items daarin ook recursief worden verwijderd.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

onExecuteActionRequested

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

Deze uitzondering wordt aangeroepen wanneer een actie voor een set bestanden of mappen wordt aangevraagd. Nadat de actie is voltooid, moet successCallback worden aangeroepen. Bij een fout moet errorCallback worden aangeroepen.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

onGetActionsRequested

Chrome 48+
chrome.fileSystemProvider.onGetActionsRequested.addListener(
  callback: function,
)

Deze uitzondering wordt gegenereerd wanneer een lijst met acties voor een set bestanden of mappen op entryPaths wordt opgevraagd. Alle geretourneerde acties moeten van toepassing zijn op elke vermelding. Als er geen dergelijke acties zijn, moet een lege array worden geretourneerd. De acties moeten worden geretourneerd met de successCallback aanroep. In geval van een fout moet errorCallback worden aangeroepen.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

onGetMetadataRequested

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

Deze uitzondering wordt aangeroepen wanneer metadata van een bestand of map op entryPath wordt opgevraagd. De metadata moet worden teruggestuurd met de successCallback aanroep. In geval van een fout moet errorCallback worden aangeroepen.

Parameters

onMountRequested

Chrome 44+
chrome.fileSystemProvider.onMountRequested.addListener(
  callback: function,
)

Deze gebeurtenis wordt geactiveerd wanneer een dialoogvenster voor het koppelen van een nieuw bestandssysteem wordt aangevraagd. Als de extensie/app een bestandshandler is, hoeft deze gebeurtenis niet te worden afgehandeld. In plaats daarvan moet app.runtime.onLaunched worden afgehandeld om nieuwe bestandssystemen te koppelen wanneer een bestand wordt geopend. Voor meerdere koppelingen moet de manifestoptie ` file_system_provider.multiple_mounts op `true` worden ingesteld.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

    • succesCallback

      functie

      De parameter successCallback ziet er als volgt uit: 

      () => void

    • fout-callback

      functie

      De parameter errorCallback ziet er als volgt uit: 

      (error: ProviderError) => void

onMoveEntryRequested

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

Deze uitzondering wordt gegenereerd wanneer een item (recursief als het een map betreft) wordt verplaatst. Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

onOpenFileRequested

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

Deze uitzondering treedt op wanneer het openen van een bestand op filePath wordt aangevraagd. Als het bestand niet bestaat, moet de bewerking mislukken. Het maximale aantal bestanden dat tegelijkertijd geopend kan worden, kan worden opgegeven met MountOptions .

Parameters

onReadDirectoryRequested

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

Deze uitzondering wordt aangeroepen wanneer de inhoud van een map op directoryPath wordt opgevraagd. De resultaten moeten in delen worden geretourneerd door de successCallback meerdere keren aan te roepen. In geval van een fout moet errorCallback worden aangeroepen.

Parameters

onReadFileRequested

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

Deze uitzondering wordt gegenereerd wanneer de inhoud van een bestand dat eerder met openRequestId is geopend, wordt opgevraagd. De resultaten moeten in stukken worden geretourneerd door successCallback meerdere keren aan te roepen. In geval van een fout moet errorCallback worden aangeroepen.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

    • succesCallback

      functie

      De parameter successCallback ziet er als volgt uit: 

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

      • gegevens

        ArrayBuffer

      • heeftMeer

        booleaans

    • fout-callback

      functie

      De parameter errorCallback ziet er als volgt uit: 

      (error: ProviderError) => void

onRemoveWatcherRequested

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

Wordt geactiveerd wanneer de watcher moet worden verwijderd. Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

onTruncateRequested

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

Deze uitzondering wordt gegenereerd wanneer het inkorten van een bestand tot een gewenste lengte wordt aangevraagd. Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

onUnmountRequested

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

Deze uitzondering wordt gegenereerd wanneer het ontkoppelen van het bestandssysteem met de identifier fileSystemId wordt aangevraagd. In het antwoord moet de unmount API-methode samen met successCallback worden aangeroepen. Als ontkoppelen niet mogelijk is (bijvoorbeeld vanwege een lopende bewerking), moet errorCallback worden aangeroepen.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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

    • succesCallback

      functie

      De parameter successCallback ziet er als volgt uit: 

      () => void

    • fout-callback

      functie

      De parameter errorCallback ziet er als volgt uit: 

      (error: ProviderError) => void

onWriteFileRequested

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

Deze foutmelding verschijnt wanneer er een verzoek wordt gedaan om inhoud te schrijven naar een bestand dat eerder is geopend met openRequestId .

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

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