chrome.fileSystemProvider

Beschrijving

Gebruik de chrome.fileSystemProvider API om bestandssystemen te maken die toegankelijk zijn via bestandsbeheer in Chrome OS.

Machtigingen

fileSystemProvider

Beschikbaarheid

Alleen ChromeOS

U moet de machtiging 'fileSystemProvider' en de sectie in het extensiemanifest declareren om de File System Provider API te kunnen gebruiken. 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 configureren via onConfigureRequested wordt ondersteund. Standaard: onwaar.
multiple_mounts (booleaans) - optioneel
Of meerdere (meer dan één) aangekoppelde bestandssystemen worden ondersteund. Standaard: onwaar.
watchable (Boolean) - optioneel
Of het instellen van watchers en het melden van wijzigingen wordt ondersteund. Standaard: onwaar.
source (opsomming van "bestand", "apparaat" of "netwerk") - vereist
Gegevensbron voor aangekoppelde bestandssystemen.

De Bestanden-app gebruikt bovenstaande informatie om gerelateerde UI-elementen op de juiste manier weer te geven. Als configurable bijvoorbeeld is ingesteld op waar, wordt een menu-item voor het configureren van volumes weergegeven. Op dezelfde manier, als multiple_mounts is ingesteld op true , kan de app Bestanden meer dan één koppelpunt toevoegen vanuit de gebruikersinterface. Als watchable false is, wordt een vernieuwingsknop weergegeven. Houd er rekening mee dat u indien mogelijk ondersteuning voor watchers moet toevoegen, zodat wijzigingen in het bestandssysteem onmiddellijk en automatisch kunnen worden doorgevoerd.

Overzicht

Met de File System Provider API kunnen extensies virtuele bestandssystemen ondersteunen, die beschikbaar zijn in bestandsbeheer op ChromeOS. Gebruiksscenario's zijn onder meer het decomprimeren van archieven en het openen van bestanden in een andere cloudservice dan Drive.

Bestandssystemen mounten

Het aanbieden van extensies kan de inhoud van het bestandssysteem leveren vanaf een externe bron (zoals een externe server of een USB-apparaat), of door een lokaal bestand (zoals een archief) als invoer te gebruiken.

Om bestandssystemen te 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 Ingangspunt
"file" Alleen beschikbaar voor verpakte apps.
"device" of "network" opMountRequested

Bestandssystemen configureren

De opgegeven bestandssystemen kunnen, zodra ze zijn aangekoppeld, worden geconfigureerd via de onConfigureRequested- gebeurtenis. Het is vooral handig voor bestandssystemen die inhoud via een netwerk leveren om de juiste inloggegevens in te stellen. Het afhandelen van deze gebeurtenis is optioneel.

Levenscyclus

Op voorwaarde dat de bestandssystemen die eenmaal zijn aangekoppeld, door Chrome worden onthouden en automatisch opnieuw worden gekoppeld na opnieuw opstarten of opnieuw opstarten. Wanneer een bestandssysteem eenmaal is aangekoppeld door een beschikbare extensie, blijft het daar staan ​​totdat de extensie wordt verwijderd, of totdat de extensie de ontkoppelingsmethode aanroept.

Soorten

AbortRequestedOptions

Eigenschappen

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • operatieRequestId

    nummer

    Een ID van het verzoek om te worden afgebroken.

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

Action

Chroom 45+

Eigenschappen

  • Identiteitskaart

    snaar

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

  • titel

    tekenreeks optioneel

    De titel van de actie. Het kan worden genegeerd voor algemene acties.

AddWatcherRequestedOptions

Eigenschappen

  • entryPad

    snaar

    Het pad van de ingang dat in acht moet worden genomen.

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • recursief

    Booleaans

    Of observatie alle onderliggende gegevens recursief moet omvatten. Het kan alleen waar zijn voor mappen.

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

Change

Eigenschappen

  • verandertype

    Type wijzigen

    Het type wijziging dat met de invoer heeft plaatsgevonden.

  • cloudFileInfo

    CloudFileInfo optioneel

    Chroom 125+

    Informatie met betrekking tot het bestand, indien ondersteund door een cloudbestandssysteem.

  • entryPad

    snaar

    Het pad van het gewijzigde item.

ChangeType

Type wijziging gedetecteerd in de waargenomen map.

Enum

"GEWIJZIGD"

"VERWIJDERD"

CloseFileRequestedOptions

Eigenschappen

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • openRequestId

    nummer

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

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

CloudFileInfo

Chroom 125+

Eigenschappen

  • versieTag

    tekenreeks optioneel

    Een tag die de versie van het bestand vertegenwoordigt.

CloudIdentifier

Chroom 117+

Eigenschappen

  • Identiteitskaart

    snaar

    De identificatie van de provider voor het opgegeven bestand/de opgegeven map.

  • providernaam

    snaar

    Identificatie voor de cloudopslagprovider (bijvoorbeeld 'drive.google.com').

CommonActionId

Chroom 45+

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

Enum

"SAVE_FOR_OFFLINE"

"OFFLINE_NOT_NECESSARY"

"DEEL"

ConfigureRequestedOptions

Chroom 44+

Eigenschappen

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat moet worden geconfigureerd.

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

CopyEntryRequestedOptions

Eigenschappen

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

  • bronpad

    snaar

    Het bronpad van het item dat moet worden gekopieerd.

  • doelpad

    snaar

    Het doelpad voor de kopieerbewerking.

CreateDirectoryRequestedOptions

Eigenschappen

  • directoryPad

    snaar

    Het pad van de map die moet worden gemaakt.

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • recursief

    Booleaans

    Of de bewerking recursief is (alleen voor mappen).

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

CreateFileRequestedOptions

Eigenschappen

  • bestandspad

    snaar

    Het pad van het bestand dat moet worden gemaakt.

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

DeleteEntryRequestedOptions

Eigenschappen

  • entryPad

    snaar

    Het pad van het item dat moet worden verwijderd.

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • recursief

    Booleaans

    Of de bewerking recursief is (alleen voor mappen).

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

EntryMetadata

Eigenschappen

  • cloudFileInfo

    CloudFileInfo optioneel

    Chroom 125+

    Informatie die een specifiek bestand in het onderliggende cloudbestandssysteem identificeert. Moet worden opgegeven indien gevraagd in de options en het bestand wordt ondersteund door cloudopslag.

  • cloudIdentificatie

    CloudIdentifier optioneel

    Chroom 117+

    Weergave in de cloudopslag van dit item. Moet worden opgegeven indien gevraagd in de options en het bestand wordt ondersteund door cloudopslag. Voor lokale bestanden die niet worden ondersteund door cloudopslag, moet deze op verzoek ongedefinieerd zijn.

  • isDirectory

    Booleaans optioneel

    Waar als het een map is. Moet worden opgegeven als dit wordt gevraagd in options .

  • mimeType

    tekenreeks optioneel

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

  • wijzigingTijd

    Datum optioneel

    Het laatst gewijzigde tijdstip van deze invoer. Moet worden opgegeven als dit wordt gevraagd in options .

  • naam

    tekenreeks optioneel

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

  • maat

    nummer optioneel

    Bestandsgrootte in bytes. Moet worden opgegeven als dit wordt gevraagd in options .

  • miniatuur

    tekenreeks optioneel

    Miniatuurafbeelding als gegevens-URI in PNG-, JPEG- of WEBP-indeling, maximaal 32 KB groot. Optioneel, maar kan alleen worden verstrekt als dit expliciet wordt aangevraagd door de gebeurtenis onGetMetadataRequested .

ExecuteActionRequestedOptions

Chroom 45+

Eigenschappen

  • actie-id

    snaar

    De identificatie van de uit te voeren actie.

  • entryPaden

    snaar[]

    Chroom 47+

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

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

FileSystemInfo

Eigenschappen

  • weergavenaam

    snaar

    Een voor mensen leesbare naam voor het bestandssysteem.

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem.

  • geopende bestanden

    GeopendBestand []

    Lijst met momenteel geopende bestanden.

  • geopendFilesLimit

    nummer

    Het maximale aantal bestanden dat tegelijk kan worden geopend. Indien 0, dan niet beperkt.

  • ondersteuntNotifyTag

    Booleaans optioneel

    Chroom 45+

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

  • toeschouwers

    Waarnemer []

    Chroom 45+

    Lijst met kijkers.

  • beschrijfbaar

    Booleaans

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

GetActionsRequestedOptions

Chroom 45+

Eigenschappen

  • entryPaden

    snaar[]

    Chroom 47+

    Lijst met paden van vermeldingen voor de lijst met acties.

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

GetMetadataRequestedOptions

Eigenschappen

  • cloudFileInfo

    Booleaans

    Chroom 125+

    Stel in op true als cloudFileInfo waarde wordt gevraagd.

  • cloudIdentificatie

    Booleaans

    Chroom 117+

    Stel in op true als cloudIdentifier waarde wordt gevraagd.

  • entryPad

    snaar

    Het pad van het item waarover metagegevens moeten worden opgehaald.

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • isDirectory

    Booleaans

    Chroom 49+

    Stel in op true als de waarde is_directory wordt gevraagd.

  • mimeType

    Booleaans

    Chroom 49+

    Stel in op true als mimeType waarde wordt gevraagd.

  • wijzigingTijd

    Booleaans

    Chroom 49+

    Stel in op true als modificationTime wordt aangevraagd.

  • naam

    Booleaans

    Chroom 49+

    Stel in op true als name wordt gevraagd.

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

  • maat

    Booleaans

    Chroom 49+

    Stel in op true als size wordt gevraagd.

  • miniatuur

    Booleaans

    Stel in op true als thumbnail wordt gevraagd.

MountOptions

Eigenschappen

  • weergavenaam

    snaar

    Een voor mensen leesbare naam voor het bestandssysteem.

  • bestandssysteemID

    snaar

    De tekenreeks-ID van het bestandssysteem. Moet per extensie uniek zijn.

  • geopendFilesLimit

    nummer optioneel

    Het maximale aantal bestanden dat tegelijk kan worden geopend. Indien niet gespecificeerd, of 0, dan niet beperkt.

  • volhardend

    Booleaans optioneel

    Chroom 64+

    Of het framework het bestandssysteem moet hervatten bij de volgende aanmeldingssessie. Standaard waar.

  • ondersteuntNotifyTag

    Booleaans optioneel

    Chroom 45+

    Of het bestandssysteem het tag voor waargenomen mappen ondersteunt.

  • beschrijfbaar

    Booleaans optioneel

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

MoveEntryRequestedOptions

Eigenschappen

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

  • bronpad

    snaar

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

  • doelpad

    snaar

    Het doelpad voor de kopieerbewerking.

NotifyOptions

Eigenschappen

  • verandertype

    Type wijzigen

    Het type wijziging dat is opgetreden met de waargenomen invoer. Als het VERWIJDERD is, wordt de waargenomen vermelding automatisch verwijderd uit de lijst met waargenomen vermeldingen.

  • veranderingen

    Wijzig [] optioneel

    Lijst met wijzigingen in vermeldingen in de waargenomen directory (inclusief de vermelding zelf)

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze wijziging.

  • waargenomenPad

    snaar

    Het pad van de waargenomen vermelding.

  • recursief

    Booleaans

    Wijze van de waargenomen invoer.

  • label

    tekenreeks optioneel

    Tag voor de melding. Vereist als het bestandssysteem is aangekoppeld met de optie supportsNotifyTag . Houd er rekening mee dat deze vlag nodig is om meldingen te geven over wijzigingen die zijn gewijzigd, zelfs toen het systeem werd afgesloten.

OpenedFile

Eigenschappen

  • bestandspad

    snaar

    Het pad van het geopende bestand.

  • Of het bestand is geopend om te lezen of te schrijven.

  • openRequestId

    nummer

    Een verzoek-ID dat moet worden gebruikt bij opeenvolgende lees-/schrijf- en sluitverzoeken.

OpenFileMode

Wijze van openen van een bestand. Gebruikt door onOpenFileRequested .

Enum

"LEZEN"

"SCHRIJVEN"

OpenFileRequestedOptions

Eigenschappen

  • bestandspad

    snaar

    Het pad van het bestand dat moet worden geopend.

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • Of het bestand wordt gebruikt voor lezen of schrijven.

  • verzoekID

    nummer

    Een verzoek-ID die wordt gebruikt bij opeenvolgende lees-/schrijf- en sluitverzoeken.

ProviderError

Foutcodes die worden gebruikt bij het aanbieden van extensies als reactie op verzoeken en in geval van fouten bij het aanroepen van methoden van de API. Voor succes moet "OK" worden gebruikt.

Enum

"OK"

"mislukt"

"IN_USE"

"BESTAAT"

"NOT_FOUND"

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"GEEN_GEHEUGEN"

"GEEN_SPATIE"

"NOT_A_DIRECTORY"

"INVALID_OPERATION"

"BEVEILIGING"

"ABORT"

"NOT_A_FILE"

"NOT_EMPTY"

"INVALID_URL"

"IO"

ReadDirectoryRequestedOptions

Eigenschappen

  • directoryPad

    snaar

    Het pad van de map waarvan de inhoud wordt opgevraagd.

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • isDirectory

    Booleaans

    Chroom 49+

    Stel in op true als de waarde is_directory wordt gevraagd.

  • mimeType

    Booleaans

    Chroom 49+

    Stel in op true als mimeType waarde wordt gevraagd.

  • wijzigingTijd

    Booleaans

    Chroom 49+

    Stel in op true als modificationTime wordt aangevraagd.

  • naam

    Booleaans

    Chroom 49+

    Stel in op true als name wordt gevraagd.

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

  • maat

    Booleaans

    Chroom 49+

    Stel in op true als size wordt gevraagd.

  • miniatuur

    Booleaans

    Chroom 49+

    Stel in op true als thumbnail wordt gevraagd.

ReadFileRequestedOptions

Eigenschappen

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • lengte

    nummer

    Aantal bytes dat moet worden geretourneerd.

  • gecompenseerd

    nummer

    Positie in het bestand (in bytes) waaruit u wilt beginnen met lezen.

  • openRequestId

    nummer

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

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

RemoveWatcherRequestedOptions

Eigenschappen

  • entryPad

    snaar

    Het pad van de bekeken ingang.

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • recursief

    Booleaans

    Modus van de toeschouwer.

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

TruncateRequestedOptions

Eigenschappen

  • bestandspad

    snaar

    Het pad van het bestand dat moet worden afgekapt.

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • lengte

    nummer

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

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

UnmountOptions

Eigenschappen

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat moet worden ontkoppeld.

UnmountRequestedOptions

Eigenschappen

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat moet worden ontkoppeld.

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

Watcher

Eigenschappen

  • entryPad

    snaar

    Het pad van de ingang die wordt geobserveerd.

  • laatsteTag

    tekenreeks optioneel

    Tag gebruikt door de laatste melding voor de watcher.

  • recursief

    Booleaans

    Of bij het kijken alle onderliggende items recursief moeten worden opgenomen. Het kan alleen waar zijn voor mappen.

WriteFileRequestedOptions

Eigenschappen

  • gegevens

    ArrayBuffer

    Buffer van bytes die naar het bestand moeten worden geschreven.

  • bestandssysteemID

    snaar

    De ID van het bestandssysteem dat betrekking heeft op deze bewerking.

  • gecompenseerd

    nummer

    Positie in het bestand (in bytes) waaruit de bytes moeten worden geschreven.

  • openRequestId

    nummer

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

  • verzoekID

    nummer

    De unieke identificatie van dit verzoek.

Methoden

get()

Belofte
chrome.fileSystemProvider.get(
  fileSystemId: string,
  callback?: function,
)

Retourneert informatie over een bestandssysteem met de doorgegeven fileSystemId .

Parameters

  • bestandssysteemID

    snaar

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (fileSystem: FileSystemInfo) => void

Retouren

  • Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

getAll()

Belofte
chrome.fileSystemProvider.getAll(
  callback?: function,
)

Retourneert alle bestandssystemen die door de extensie zijn aangekoppeld.

Parameters

Retouren

  • Belofte< BestandSysteemInfo []>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

mount()

Belofte
chrome.fileSystemProvider.mount(
  options: MountOptions,
  callback?: function,
)

Koppelt een bestandssysteem met de opgegeven fileSystemId en displayName . displayName wordt weergegeven in het linkerpaneel van de Bestanden-app. displayName kan alle tekens bevatten, inclusief '/', maar kan 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 op de juiste manier worden ingesteld.

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

Parameters

  • opties

    Mountopties

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

notify()

BeloofChrome 45+
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
  callback?: function,
)

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

Om deze te kunnen gebruiken, moet de manifestoptie file_system_provider.notify zijn ingesteld op true.

De waarde van tag kan elke tekenreeks zijn die uniek is per oproep, zodat het mogelijk is de laatst geregistreerde melding te identificeren. Bijv. als de leverende extensie start na een herstart en de tag van de laatst geregistreerde melding gelijk is aan "123", dan zou deze notify moeten oproepen voor alle wijzigingen die zijn gebeurd sinds de wijziging die is getagd als "123". Het kan geen lege string zijn.

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

Houd er rekening mee dat als een bovenliggende map wordt verwijderd, alle onderliggende items ook worden verwijderd, en als ze worden bekeken, moet de API hiervan op de hoogte worden gesteld. Als de naam van een directory wordt gewijzigd, worden in feite alle onderliggende items verwijderd, omdat er geen items meer onder hun oorspronkelijke paden staan.

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

Parameters

  • opties

    Meld Opties

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

unmount()

Belofte
chrome.fileSystemProvider.unmount(
  options: UnmountOptions,
  callback?: function,
)

Ontkoppelt een bestandssysteem met de opgegeven fileSystemId . Het moet worden aangeroepen nadat onUnmountRequested is aangeroepen. Ook kan de leverende extensie beslissen om de ontkoppeling uit te voeren als dit niet wordt gevraagd (bijvoorbeeld in geval van verbroken verbinding of een bestandsfout).

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

Parameters

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 96+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

Evenementen

onAbortRequested

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

Wordt gegenereerd bij het afbreken van een bewerking waarbij operationRequestId wordt aangevraagd. De met operationRequestId uitgevoerde bewerking moet onmiddellijk worden gestopt en successCallback van dit abort-verzoek 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 met geweld worden afgebroken.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

    • succesTerugbellen

      functie

      De parameter successCallback ziet er als volgt uit: 

      () => void

    • foutTerugbellen

      functie

      De parameter errorCallback ziet er als volgt uit: 

      (error: ProviderError) => void

onAddWatcherRequested

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

Wordt weergegeven wanneer er wordt gevraagd om een ​​nieuwe directorywatcher in te stellen. Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

onCloseFileRequested

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

Wordt gegenereerd wanneer het openen van een bestand dat eerder is geopend met openRequestId moet worden gesloten.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

    • succesTerugbellen

      functie

      De parameter successCallback ziet er als volgt uit: 

      () => void

    • foutTerugbellen

      functie

      De parameter errorCallback ziet er als volgt uit: 

      (error: ProviderError) => void

onConfigureRequested

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

Wordt weergegeven wanneer er een configuratiedialoogvenster voor fileSystemId wordt weergegeven. Als dit wordt afgehandeld, moet de optie file_system_provider.configurable manfiest worden ingesteld op true.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

onCopyEntryRequested

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

Wordt weergegeven wanneer het kopiëren van een item (recursief als een directory) wordt gevraagd. Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

    • succesTerugbellen

      functie

      De parameter successCallback ziet er als volgt uit: 

      () => void

    • foutTerugbellen

      functie

      De parameter errorCallback ziet er als volgt uit: 

      (error: ProviderError) => void

onCreateDirectoryRequested

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

Verhoogd bij het aanmaken van een directory wordt gevraagd. 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,
)

Opgeheven bij het aanmaken van een bestand wordt gevraagd. Als het bestand al bestaat, moet errorCallback worden aangeroepen met de foutcode "EXISTS" .

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

onDeleteEntryRequested

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

Wordt verhoogd wanneer er wordt gevraagd om een ​​vermelding te verwijderen. Als recursive waar is en het item een ​​directory is, moeten alle items daarin ook recursief worden verwijderd.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

onExecuteActionRequested

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

Wordt weergegeven wanneer er een actie voor een reeks bestanden of mappen wordt uitgevoerd. Nadat de actie is voltooid, moet successCallback worden aangeroepen. Bij een fout moet errorCallback worden aangeroepen.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

onGetActionsRequested

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

Wordt gegenereerd wanneer een lijst met acties voor een reeks bestanden of mappen bij entryPaths wordt aangevraagd. Alle geretourneerde acties moeten van toepassing zijn op elke inzending. Als dergelijke acties niet plaatsvinden, moet een lege array worden geretourneerd. De acties moeten worden geretourneerd met de aanroep successCallback . In geval van een fout moet errorCallback worden aangeroepen.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

onGetMetadataRequested

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

Wordt weergegeven wanneer metagegevens van een bestand of map op entryPath worden opgevraagd. De metagegevens moeten worden geretourneerd met de successCallback aanroep. In geval van een fout moet errorCallback worden aangeroepen.

Parameters

onMountRequested

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

Wordt weergegeven wanneer er een dialoogvenster wordt weergegeven voor het koppelen van een nieuw bestandssysteem. Als de extensie/app een bestandshandler is, mag deze gebeurtenis niet 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 worden ingesteld op true.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

    • succesTerugbellen

      functie

      De parameter successCallback ziet er als volgt uit: 

      () => void

    • foutTerugbellen

      functie

      De parameter errorCallback ziet er als volgt uit: 

      (error: ProviderError) => void

onMoveEntryRequested

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

Wordt verhoogd wanneer het verplaatsen van een item (recursief als een directory) wordt gevraagd. Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

onOpenFileRequested

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

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

Parameters

onReadDirectoryRequested

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

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

Parameters

onReadFileRequested

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

Wordt weergegeven wanneer er wordt gevraagd om de inhoud te lezen van een bestand dat eerder is geopend met openRequestId . De resultaten moeten in delen worden geretourneerd door successCallback meerdere keren aan te roepen. In geval van een fout moet errorCallback worden aangeroepen.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

    • succesTerugbellen

      functie

      De parameter successCallback ziet er als volgt uit: 

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

      • gegevens

        ArrayBuffer

      • heeftMeer

        Booleaans

    • foutTerugbellen

      functie

      De parameter errorCallback ziet er als volgt uit: 

      (error: ProviderError) => void

onRemoveWatcherRequested

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

Verhoogd wanneer de wachter moet worden verwijderd. Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

onTruncateRequested

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

Verhoogd wanneer het afkappen van een bestand tot de gewenste lengte wordt gevraagd. Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

    • succesTerugbellen

      functie

      De parameter successCallback ziet er als volgt uit: 

      () => void

    • foutTerugbellen

      functie

      De parameter errorCallback ziet er als volgt uit: 

      (error: ProviderError) => void

onUnmountRequested

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

Wordt gegenereerd bij het ontkoppelen van het bestandssysteem met de fileSystemId identificatie. 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

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

    • succesTerugbellen

      functie

      De parameter successCallback ziet er als volgt uit: 

      () => void

    • foutTerugbellen

      functie

      De parameter errorCallback ziet er als volgt uit: 

      (error: ProviderError) => void

onWriteFileRequested

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

Treedt op bij het schrijven van inhoud naar een bestand dat eerder is geopend met openRequestId .

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

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

    • succesTerugbellen

      functie

      De parameter successCallback ziet er als volgt uit: 

      () => void

    • foutTerugbellen

      functie

      De parameter errorCallback ziet er als volgt uit: 

      (error: ProviderError) => void