chrome.fileSystemProvider

Beschrijving

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

Machtigingen

fileSystemProvider

Beschikbaarheid

Alleen ChromeOS

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

De Bestanden-app gebruikt bovenstaande informatie om gerelateerde UI-elementen correct weer te geven. Als configurable bijvoorbeeld is ingesteld op true, wordt een menu-item voor het configureren van volumes weergegeven. Als multiple_mounts is ingesteld op true , kan de Bestanden-app meerdere koppelpunten toevoegen vanuit de gebruikersinterface. Als watchable is ingesteld op false , wordt een vernieuwingsknop weergegeven. Voeg indien mogelijk ondersteuning voor watchers toe, zodat wijzigingen in het bestandssysteem direct en automatisch kunnen worden doorgevoerd.

Overzicht

Met de File System Provider API kunnen extensies virtuele bestandssystemen ondersteunen, die beschikbaar zijn in de bestandsbeheerder van ChromeOS. Voorbeelden van toepassingen zijn het decomprimeren van archieven en het openen van bestanden in een andere cloudservice dan Drive.

Bestandssystemen koppelen

U kunt extensies opgeven waarmee u de inhoud van het bestandssysteem van een externe bron (zoals een externe server of een USB-apparaat) kunt aanleveren, of waarmee u een lokaal bestand (zoals een archief) als invoer kunt gebruiken.

Om bestandssystemen te schrijven die bestandsafhandelingsfuncties vervullen (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 gekoppeld wanneer de gebeurtenis onMountRequested wordt aangeroepen.

Bron van de bestandssysteemgegevens Instappunt
"file" Alleen beschikbaar voor pakket-apps.
"device" of "network" opMountRequested

Bestandssystemen configureren

Eenmaal gekoppelde bestandssystemen kunnen worden geconfigureerd via de gebeurtenis onConfigureRequested . Dit is vooral handig voor bestandssystemen die inhoud via het netwerk aanbieden om de juiste referenties in te stellen. Het afhandelen van deze gebeurtenis is optioneel.

Levenscyclus

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

Typen

AbortRequestedOptions

Eigenschappen

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

  • bewerkingsaanvraag-ID

    nummer

    Een ID van het af te breken verzoek.

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

Action

Chroom 45+

Eigenschappen

  • id

    snaar

    De identificatie van de actie. Een tekenreeks of CommonActionId voor veelvoorkomende acties.

  • titel

    string optioneel

    De titel van de actie. Deze kan bij veelvoorkomende acties worden genegeerd.

AddWatcherRequestedOptions

Eigenschappen

  • entryPath

    snaar

    Het pad van de ingang dat moet worden gevolgd.

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

  • recursief

    Booleaanse

    Of bij het observeren alle onderliggende items recursief moeten worden meegenomen. Dit kan alleen voor mappen gelden.

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

Change

Eigenschappen

  • changeType

    Wijzigingstype

    Het type wijziging dat in het item is doorgevoerd.

  • cloudFileInfo

    CloudFileInfo optioneel

    Chroom 125+

    Informatie over het bestand als het wordt ondersteund door een cloudbestandssysteem.

  • entryPath

    snaar

    Het pad van het gewijzigde item.

ChangeType

Type wijziging dat is gedetecteerd in de waargenomen directory.

Enum

"VERANDERD"

"VERWIJDERD"

CloseFileRequestedOptions

Eigenschappen

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

  • openRequestId

    nummer

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

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

CloudFileInfo

Chroom 125+

Eigenschappen

  • versieTag

    string optioneel

    Een tag die de versie van het bestand vertegenwoordigt.

CloudIdentifier

Chroom 117+

Eigenschappen

  • id

    snaar

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

  • providernaam

    snaar

    Identificatie voor de aanbieder van cloudopslag (bijv. 'drive.google.com').

CommonActionId

Chroom 45+

Lijst met veelgebruikte 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 opgeslagen hoeft te worden voor offline toegang. Gebruikt door onGetActionsRequested en onExecuteActionRequested .

Enum

"OPSLAAN VOOR OFFLINE"

"OFFLINE_NIET_NODIG"

"DEEL"

ConfigureRequestedOptions

Chroom 44+

Eigenschappen

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat moet worden geconfigureerd.

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

CopyEntryRequestedOptions

Eigenschappen

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

  • bronpad

    snaar

    Het bronpad van het item dat gekopieerd moet worden.

  • doelpad

    snaar

    Het doelpad voor de kopieerbewerking.

CreateDirectoryRequestedOptions

Eigenschappen

  • directoryPad

    snaar

    Het pad van de map die gemaakt moet worden.

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

  • recursief

    Booleaanse

    Of de bewerking recursief is (alleen voor mappen).

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

CreateFileRequestedOptions

Eigenschappen

  • bestandspad

    snaar

    Het pad van het bestand dat moet worden gemaakt.

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

DeleteEntryRequestedOptions

Eigenschappen

  • entryPath

    snaar

    Het pad van het item dat verwijderd moet worden.

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

  • recursief

    Booleaanse

    Of de bewerking recursief is (alleen voor mappen).

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

EntryMetadata

Eigenschappen

  • cloudFileInfo

    CloudFileInfo optioneel

    Chroom 125+

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

  • cloudIdentifier

    CloudIdentifier optioneel

    Chroom 117+

    Cloudopslagweergave van dit item. Moet worden opgegeven indien gevraagd in options en het bestand wordt ondersteund door cloudopslag. Voor lokale bestanden die niet door cloudopslag worden ondersteund, moet dit bij aanvraag ongedefinieerd zijn.

  • isDirectory

    boolean optioneel

    Waar als het een directory is. Moet worden opgegeven indien aangevraagd in options .

  • mimeType

    string optioneel

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

  • wijzigingstijd

    Datum optioneel

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

  • naam

    string optioneel

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

  • maat

    nummer optioneel

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

  • miniatuur

    string optioneel

    Miniatuurafbeelding als data-URI in PNG-, JPEG- of WEBP-formaat, maximaal 32 KB groot. Optioneel, maar kan alleen worden verstrekt wanneer expliciet aangevraagd via de gebeurtenis onGetMetadataRequested .

ExecuteActionRequestedOptions

Chroom 45+

Eigenschappen

  • actie-ID

    snaar

    De identificatie van de uit te voeren actie.

  • toegangspaden

    snaar[]

    Chroom 47+

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

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

FileSystemInfo

Eigenschappen

  • Getoond

    snaar

    Een voor mensen leesbare naam voor het bestandssysteem.

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem.

  • geopende bestanden

    Geopend bestand []

    Lijst met momenteel geopende bestanden.

  • geopendeBestandenLimit

    nummer

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

  • ondersteuntNotifyTag

    boolean optioneel

    Chroom 45+

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

  • toeschouwers

    Toeschouwer []

    Chroom 45+

    Lijst van waarnemers.

  • beschrijfbaar

    Booleaanse

    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

  • toegangspaden

    snaar[]

    Chroom 47+

    Lijst met paden van vermeldingen voor de lijst met acties.

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

GetMetadataRequestedOptions

Eigenschappen

  • cloudFileInfo

    Booleaanse

    Chroom 125+

    Stel in op true als cloudFileInfo -waarde wordt opgevraagd.

  • cloudIdentifier

    Booleaanse

    Chroom 117+

    Stel in op true als cloudIdentifier waarde wordt opgevraagd.

  • entryPath

    snaar

    Het pad van het item waarvan u de metagegevens wilt ophalen.

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

  • isDirectory

    Booleaanse

    Chroom 49+

    Op true zetten als is_directory waarde wordt opgevraagd.

  • mimeType

    Booleaanse

    Chroom 49+

    Stel in op true als mimeType waarde wordt opgevraagd.

  • wijzigingstijd

    Booleaanse

    Chroom 49+

    Op true zetten als de waarde modificationTime wordt opgevraagd.

  • naam

    Booleaanse

    Chroom 49+

    Stel in op true als name wordt opgevraagd.

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

  • maat

    Booleaanse

    Chroom 49+

    Op true zetten als size wordt opgevraagd.

  • miniatuur

    Booleaanse

    Op true zetten als de thumbnail wordt opgevraagd.

MountOptions

Eigenschappen

  • Getoond

    snaar

    Een voor mensen leesbare naam voor het bestandssysteem.

  • bestandssysteem-ID

    snaar

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

  • geopendeBestandenLimit

    nummer optioneel

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

  • volhardend

    boolean optioneel

    Chroom 64+

    Of het framework het bestandssysteem bij de volgende aanmeldingssessie moet hervatten. Standaard ingesteld op True.

  • ondersteuntNotifyTag

    boolean optioneel

    Chroom 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 maken, verwijderen of schrijven naar bestanden).

MoveEntryRequestedOptions

Eigenschappen

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

  • bronpad

    snaar

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

  • doelpad

    snaar

    Het doelpad voor de kopieerbewerking.

NotifyOptions

Eigenschappen

  • changeType

    Wijzigingstype

    Het type wijziging dat is aangebracht in het geobserveerde item. Als het wordt VERWIJDERD, wordt het geobserveerde item automatisch verwijderd uit de lijst met geobserveerde items.

  • veranderingen

    Wijzigen [] optioneel

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

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze wijziging gerelateerd is.

  • waargenomen pad

    snaar

    Het pad van de waargenomen invoer.

  • recursief

    Booleaanse

    Wijze van de waargenomen binnenkomst.

  • label

    string optioneel

    Tag voor de melding. Vereist als het bestandssysteem is gekoppeld met de optie supportsNotifyTag . Deze vlag is nodig om meldingen te verstrekken over wijzigingen die zelfs zijn gewijzigd toen het systeem werd afgesloten.

OpenedFile

Eigenschappen

  • bestandspad

    snaar

    Het pad van het geopende bestand.

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

  • openRequestId

    nummer

    Een aanvraag-ID die gebruikt wordt door opeenvolgende lees-/schrijf- en sluitaanvragen.

OpenFileMode

Manier om een bestand te openen. Gebruikt door onOpenFileRequested .

Enum

"LEZEN"

"SCHRIJVEN"

OpenFileRequestedOptions

Eigenschappen

  • bestandspad

    snaar

    Het pad van het te openen bestand.

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

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

  • aanvraag-ID

    nummer

    Een aanvraag-ID die wordt gebruikt door opeenvolgende lees-/schrijf- en sluitaanvragen.

ProviderError

Foutcodes die worden gebruikt bij het verstrekken van extensies als reactie op verzoeken en bij fouten bij het aanroepen van API-methoden. Voor succes moet "OK" worden gebruikt.

Enum

"OK"

"MISLUKT"

"IN_GEBRUIK"

"BESTAAT"

"NIET_GEVONDEN"

"TOEGANG_GEWEIGERD"

"TE_VEEL_GEOPEND"

"GEEN_GEHEUGEN"

"GEEN_RUIMTE"

"GEEN_MAP"

"ONGELDIGE_BEWERKING"

"BEVEILIGING"

"ABORTEREN"

"GEEN_BESTAND"

"NIET_LEEG"

"ONGELDIGE_URL"

"IO"

ReadDirectoryRequestedOptions

Eigenschappen

  • directoryPad

    snaar

    Het pad van de map waarvan de inhoud wordt opgevraagd.

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

  • isDirectory

    Booleaanse

    Chroom 49+

    Op true zetten als is_directory waarde wordt opgevraagd.

  • mimeType

    Booleaanse

    Chroom 49+

    Stel in op true als mimeType waarde wordt opgevraagd.

  • wijzigingstijd

    Booleaanse

    Chroom 49+

    Op true zetten als de waarde modificationTime wordt opgevraagd.

  • naam

    Booleaanse

    Chroom 49+

    Stel in op true als name wordt opgevraagd.

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

  • maat

    Booleaanse

    Chroom 49+

    Op true zetten als size wordt opgevraagd.

  • miniatuur

    Booleaanse

    Chroom 49+

    Op true zetten als de thumbnail wordt opgevraagd.

ReadFileRequestedOptions

Eigenschappen

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

  • lengte

    nummer

    Aantal bytes dat moet worden geretourneerd.

  • offset

    nummer

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

  • openRequestId

    nummer

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

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

RemoveWatcherRequestedOptions

Eigenschappen

  • entryPath

    snaar

    Het pad van het bekeken item.

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

  • recursief

    Booleaanse

    Modus van de toeschouwer.

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

TruncateRequestedOptions

Eigenschappen

  • bestandspad

    snaar

    Het pad van het bestand dat moet worden afgekapt.

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

  • lengte

    nummer

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

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

UnmountOptions

Eigenschappen

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat moet worden ontkoppeld.

UnmountRequestedOptions

Eigenschappen

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat moet worden ontkoppeld.

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

Watcher

Eigenschappen

  • entryPath

    snaar

    Het pad van de ingang die wordt waargenomen.

  • laatsteTag

    string optioneel

    Tag die door de laatste melding voor de waarnemer is gebruikt.

  • recursief

    Booleaanse

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

WriteFileRequestedOptions

Eigenschappen

  • gegevens

    ArrayBuffer

    Buffer van bytes die naar het bestand moeten worden geschreven.

  • bestandssysteem-ID

    snaar

    De identificatie van het bestandssysteem dat aan deze bewerking gerelateerd is.

  • offset

    nummer

    Positie in het bestand (in bytes) waar vanaf moet worden begonnen met het schrijven van de bytes.

  • openRequestId

    nummer

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

  • aanvraag-ID

    nummer

    De unieke identificatie van deze aanvraag.

Methoden

get()

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

Geeft informatie terug over een bestandssysteem met de doorgegeven fileSystemId .

Parameters

  • bestandssysteem-ID

    snaar

Retourneren

getAll()

chrome.fileSystemProvider.getAll(): Promise<FileSystemInfo[]>

Retourneert alle bestandssystemen die door de extensie zijn gekoppeld.

Retourneren

mount()

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

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 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 gekoppeld, moet de source correct worden ingesteld.

Indien er een fout optreedt, wordt runtime.lastError ingesteld met een bijbehorende foutcode.

Parameters

Retourneren

  • Belofte<leegte>

    Chroom 96+

notify()

Chroom 45+
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
): Promise<void>

Geeft een melding over wijzigingen in de bewaakte directory op observedPath in recursive modus. Als het bestandssysteem is gekoppeld met supportsNotifyTag , moet de 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 tag kan elke tekenreeks zijn die uniek is per aanroep, zodat de laatst geregistreerde melding kan worden geïdentificeerd. Bijvoorbeeld: als de leverende extensie start na een herstart en de tag van de laatst geregistreerde melding gelijk is aan "123", dan moet deze notify aanroepen voor alle wijzigingen die zijn aangebracht sinds de wijziging die als "123" is getagd. Dit mag geen lege tekenreeks zijn.

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

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

Indien er een fout optreedt, wordt runtime.lastError voorzien van een bijbehorende foutcode.

Parameters

Retourneren

  • Belofte<leegte>

    Chroom 96+

unmount()

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

Ontkoppelt een bestandssysteem met de opgegeven fileSystemId . Deze moet worden aangeroepen nadat onUnmountRequested is aangeroepen. De leverende extensie kan ook besluiten om ontkoppelen uit te voeren als er niet om is gevraagd (bijvoorbeeld in geval van een verbroken verbinding of een bestandsfout).

Indien er een fout optreedt, wordt runtime.lastError ingesteld met een bijbehorende foutcode.

Parameters

Retourneren

  • Belofte<leegte>

    Chroom 96+

Evenementen

onAbortRequested

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

Wordt gegenereerd wanneer een bewerking met operationRequestId wordt aangevraagd om deze te annuleren. De bewerking die met operationRequestId wordt uitgevoerd, moet onmiddellijk worden gestopt en successCallback van deze afbrekingsaanvraag moet worden uitgevoerd. Als het afbreken mislukt, moet errorCallback worden aangeroepen. Let op: callbacks van de afgebroken bewerking mogen niet worden aangeroepen, omdat deze worden genegeerd. Ondanks het aanroepen van errorCallback kan de aanvraag geforceerd worden afgebroken.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

onAddWatcherRequested

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

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

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

onCloseFileRequested

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

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

Parameters

onConfigureRequested

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

Wordt gegenereerd wanneer een configuratievenster voor fileSystemId wordt opgevraagd. Als dit wordt afgehandeld, moet de optie file_system_provider.configurable manfiest op true worden ingesteld.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

onCopyEntryRequested

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

Wordt gegenereerd wanneer het kopiëren van een item (recursief indien het een directory betreft) wordt aangevraagd. Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

onCreateDirectoryRequested

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

Wordt gegenereerd wanneer een directory wordt aangemaakt. De bewerking moet mislukken met de EXISTS-fout als de doeldirectory al bestaat. Als recursive true is, moeten alle ontbrekende directory's in het directorypad worden aangemaakt.

Parameters

onCreateFileRequested

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

Wordt gegenereerd wanneer een bestand wordt aangemaakt. Als het bestand al bestaat, moet errorCallback worden aangeroepen met de foutcode "EXISTS" .

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

onDeleteEntryRequested

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

Wordt gegenereerd wanneer het verwijderen van een item wordt aangevraagd. Als recursive true is en het item een directory betreft, moeten alle items daarin ook recursief worden verwijderd.

Parameters

onExecuteActionRequested

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

Wordt gegenereerd 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

onGetActionsRequested

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

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 elk item. Als er geen dergelijke acties zijn, 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

onGetMetadataRequested

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

Wordt gegenereerd wanneer metadata van een bestand of directory op entryPath wordt opgevraagd. De metadata moet worden geretourneerd met de aanroep successCallback . In geval van een fout moet errorCallback worden aangeroepen.

Parameters

onMountRequested

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

Wordt gegenereerd wanneer een dialoogvenster voor het koppelen van een nieuw bestandssysteem wordt aangevraagd. Als de extensie/app een bestandshandler is, mag deze gebeurtenis niet worden verwerkt. In plaats daarvan moet app.runtime.onLaunched worden verwerkt 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

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

    • succesCallback

      functie

      De successCallback parameter ziet er als volgt uit: 

      () => void

    • foutCallback

      functie

      De parameter errorCallback ziet er als volgt uit: 

      (error: ProviderError) => void

onMoveEntryRequested

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

Wordt gegenereerd wanneer een item (recursief indien het een directory betreft) wordt verplaatst. Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

onOpenFileRequested

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

Wordt gegenereerd wanneer een bestand op filePath wordt geopend. Als het bestand niet bestaat, mislukt de bewerking. Het maximale aantal bestanden dat tegelijk kan worden geopend, kan worden opgegeven met MountOptions .

Parameters

onReadDirectoryRequested

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

Wordt gegenereerd wanneer de inhoud van een directory op 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 gegenereerd wanneer de inhoud van een eerder geopend bestand met openRequestId 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

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

    • succesCallback

      functie

      De successCallback parameter ziet er als volgt uit: 

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

      • gegevens

        ArrayBuffer

      • heeftMeer

        Booleaanse

    • foutCallback

      functie

      De parameter errorCallback ziet er als volgt uit: 

      (error: ProviderError) => void

onRemoveWatcherRequested

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

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

Parameters

onTruncateRequested

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

Wordt gegenereerd wanneer een bestand wordt afgekapt tot de gewenste lengte. Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

onUnmountRequested

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

Wordt gegenereerd wanneer unmounten voor het bestandssysteem met de fileSystemId identificatie wordt aangevraagd. In het antwoord moet de unmount API-methode samen met successCallback worden aangeroepen. Als unmounten niet mogelijk is (bijvoorbeeld vanwege een in behandeling zijnde bewerking), moet errorCallback worden aangeroepen.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

onWriteFileRequested

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

Wordt gegenereerd wanneer er een aanvraag wordt gedaan om inhoud te schrijven naar een bestand dat eerder is geopend met openRequestId .

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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