chrome.fileSystemProvider

refresh date: 2026-09-25 robots: noindex

Beschrijving

Gebruik de chrome.fileSystemProvider API om bestandssystemen te maken die kunnen worden geopend door de bestandsbeheerder op ChromeOS.

Rechten

fileSystemProvider

Beschikbaarheid

Alleen ChromeOS

Manifest

Je moet het recht en het gedeelte 'fileSystemProvider' definiëren in het extensiemanifest om de File System Provider API te gebruiken. Voorbeeld:

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

Het gedeelte file_system_provider moet als volgt worden gedeclareerd:

configurable (Booleaans) - optioneel
Of instellen via onConfigureRequested wordt ondersteund. Standaard: onwaar.
multiple_mounts (Booleaans) - optioneel
Of meerdere (meer dan één) gekoppelde bestandssystemen worden ondersteund. Standaard: onwaar.
watchable (Booleaans) - optioneel
Of het instellen van watchers en meldingen over wijzigingen wordt ondersteund. Standaard: onwaar.
source (enum van 'file', 'device' of 'network') - vereist
Bron van gegevens voor gekoppelde bestandssystemen.

De Bestanden-app gebruikt de bovenstaande informatie om gerelateerde UI-elementen op de juiste manier weer te geven. Als configurable bijvoorbeeld is ingesteld op True, wordt er een menu-item weergegeven om volumes in te stellen. Als multiple_mounts is ingesteld op true, staat de Bestanden-app toe dat er meer dan één koppelingspunt wordt toegevoegd via de UI. Als watchable false is, wordt er een vernieuwingsknop weergegeven. Voeg indien mogelijk ondersteuning voor watchers toe, zodat wijzigingen in het bestandssysteem onmiddellijk en automatisch worden doorgevoerd.

Overzicht

Met de File System Provider API kunnen extensies virtuele bestandssystemen ondersteunen die beschikbaar zijn in de bestandsbeheerder op ChromeOS. Voorbeelden van use cases zijn archieven decomprimeren en toegang krijgen tot bestanden in een andere cloudservice dan Drive.

Bestandssystemen koppelen

Extensies die bestandssystemen leveren, kunnen de content van het bestandssysteem leveren vanuit een externe bron (zoals een externe server of een USB-apparaat) of een lokaal bestand (zoals een archief) als invoer gebruiken.

Als je bestandssystemen wilt schrijven die bestandshandlers zijn (bron is "file"), moet de aanbieder een verpakte app zijn, omdat de gebeurtenis onLaunched 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 Invoerpunt
"file" Alleen beschikbaar voor pakket-apps.
"device" of "network" onMountRequested

Bestandssystemen configureren

Bestandssystemen die eenmaal zijn geactiveerd, kunnen worden geconfigureerd via de gebeurtenis onConfigureRequested. Dit is vooral handig voor bestandssystemen die content via een netwerk leveren, zodat de juiste inloggegevens kunnen worden ingesteld. De verwerking van deze gebeurtenis is optioneel.

Levenscyclus

Bestandssystemen die eenmaal zijn gekoppeld, worden onthouden door Chrome en automatisch opnieuw gekoppeld nadat het apparaat opnieuw is opgestart. Als een bestandssysteem eenmaal is gekoppeld door een extensie, blijft het dus gekoppeld totdat de extensie wordt verwijderd of de extensie de methode unmount aanroept.

Typen

AbortRequestedOptions

Eigenschappen

  • fileSystemId

    tekenreeks

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

  • operationRequestId

    getal

    De ID van het verzoek dat moet worden afgebroken.

  • requestId

    getal

    De unieke ID van dit verzoek.

Action

Chrome 45+

Eigenschappen

  • id

    tekenreeks

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

  • titel

    tekenreeks optioneel

    De titel van de actie. Voor veelvoorkomende acties kan de instelling worden genegeerd.

AddWatcherRequestedOptions

Eigenschappen

  • entryPath

    tekenreeks

    Het pad van de invoer die moet worden geobserveerd.

  • fileSystemId

    tekenreeks

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

  • recursief

    booleaans

    Of de observatie alle onderliggende items recursief moet bevatten. Dit kan alleen waar zijn voor directory's.

  • requestId

    getal

    De unieke ID van dit verzoek.

Change

Eigenschappen

  • changeType

    ChangeType

    Het type wijziging dat is aangebracht in het item.

  • cloudFileInfo

    CloudFileInfo optioneel

    Chrome 125+

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

  • entryPath

    tekenreeks

    Het pad van de gewijzigde invoer.

ChangeType

Type wijziging dat is gevonden in de geobserveerde directory.

Enum

"CHANGED"

DELETED

CloseFileRequestedOptions

Eigenschappen

  • fileSystemId

    tekenreeks

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

  • openRequestId

    getal

    Een verzoek-ID die is gebruikt om het bestand te openen.

  • requestId

    getal

    De unieke ID van dit verzoek.

CloudFileInfo

Chrome 125+

Eigenschappen

  • versionTag

    tekenreeks optioneel

    Een tag die de versie van het bestand vertegenwoordigt.

CloudIdentifier

Chrome 117+

Eigenschappen

  • id

    tekenreeks

    De ID van de provider voor het betreffende bestand of de betreffende directory.

  • providerName

    tekenreeks

    ID voor de cloudopslagprovider (bijv. drive.google.com).

CommonActionId

Chrome 45+

Lijst met veelgebruikte acties. "SHARE" is bedoeld om bestanden met anderen te delen. "SAVE_FOR_OFFLINE" om vast te zetten (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

DELEN

ConfigureRequestedOptions

Chrome 44+

Eigenschappen

  • fileSystemId

    tekenreeks

    De ID van het bestandssysteem dat moet worden ingesteld.

  • requestId

    getal

    De unieke ID van dit verzoek.

CopyEntryRequestedOptions

Eigenschappen

  • fileSystemId

    tekenreeks

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

  • requestId

    getal

    De unieke ID van dit verzoek.

  • sourcePath

    tekenreeks

    Het bronpad van het item dat moet worden gekopieerd.

  • targetPath

    tekenreeks

    Het bestemmingspad voor de kopieerbewerking.

CreateDirectoryRequestedOptions

Eigenschappen

  • directoryPath

    tekenreeks

    Het pad van de directory die wordt gemaakt.

  • fileSystemId

    tekenreeks

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

  • recursief

    booleaans

    Of de bewerking recursief is (alleen voor mappen).

  • requestId

    getal

    De unieke ID van dit verzoek.

CreateFileRequestedOptions

Eigenschappen

  • filePath

    tekenreeks

    Het pad van het bestand dat moet worden gemaakt.

  • fileSystemId

    tekenreeks

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

  • requestId

    getal

    De unieke ID van dit verzoek.

DeleteEntryRequestedOptions

Eigenschappen

  • entryPath

    tekenreeks

    Het pad van het item dat moet worden verwijderd.

  • fileSystemId

    tekenreeks

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

  • recursief

    booleaans

    Of de bewerking recursief is (alleen voor mappen).

  • requestId

    getal

    De unieke ID van dit verzoek.

EntryMetadata

Eigenschappen

  • cloudFileInfo

    CloudFileInfo optioneel

    Chrome 125+

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

  • cloudIdentifier

    CloudIdentifier optioneel

    Chrome 117+

    Cloud Storage-weergave van dit item. Moet worden verstrekt als hierom wordt gevraagd in options en het bestand wordt ondersteund door cloudopslag. Voor lokale bestanden die niet worden ondersteund door cloudopslag, moet deze ongedefinieerd zijn wanneer deze wordt aangevraagd.

  • isDirectory

    booleaans optioneel

    Waar als het een directory is. Moet worden verstrekt als hierom wordt gevraagd in options.

  • mimeType

    tekenreeks optioneel

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

  • modificationTime

    Datum optioneel

    De tijd van de laatste wijziging van dit item. Moet worden verstrekt als hierom wordt gevraagd in options.

  • name

    tekenreeks optioneel

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

  • maat

    number optioneel

    Bestandsgrootte in bytes. Moet worden verstrekt als hierom wordt gevraagd in options.

  • thumbnail

    tekenreeks optioneel

    Thumbnailafbeelding als een gegevens-URI in de indeling png, jpeg of webp, met een maximale grootte van 32 KB. Optioneel, maar kan alleen worden verstrekt als de gebeurtenis onGetMetadataRequested hier expliciet om vraagt.

ExecuteActionRequestedOptions

Chrome 45+

Eigenschappen

  • actionId

    tekenreeks

    De ID van de actie die moet worden uitgevoerd.

  • entryPaths

    tekenreeks[]

    Chrome 47+

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

  • fileSystemId

    tekenreeks

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

  • requestId

    getal

    De unieke ID van dit verzoek.

FileSystemInfo

Eigenschappen

  • displayName

    tekenreeks

    Een voor mensen leesbare naam voor het bestandssysteem.

  • fileSystemId

    tekenreeks

    De ID van het bestandssysteem.

  • openedFiles

    OpenedFile[]

    Lijst met momenteel geopende bestanden.

  • openedFilesLimit

    getal

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

  • supportsNotifyTag

    booleaans optioneel

    Chrome 45+

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

  • watchers

    Watcher[]

    Chrome 45+

    Lijst met kijkers.

  • schrijfbaar

    booleaans

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

GetActionsRequestedOptions

Chrome 45+

Eigenschappen

  • entryPaths

    tekenreeks[]

    Chrome 47+

    Lijst met paden van items voor de lijst met acties.

  • fileSystemId

    tekenreeks

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

  • requestId

    getal

    De unieke ID van dit verzoek.

GetMetadataRequestedOptions

Eigenschappen

  • cloudFileInfo

    booleaans

    Chrome 125+

    Stel in op true als de waarde cloudFileInfo wordt gevraagd.

  • cloudIdentifier

    booleaans

    Chrome 117+

    Stel in op true als de waarde cloudIdentifier wordt gevraagd.

  • entryPath

    tekenreeks

    Het pad van het item waarvoor je metadata wilt ophalen.

  • fileSystemId

    tekenreeks

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

  • isDirectory

    booleaans

    Chrome 49+

    Stel in op true als de waarde is_directory wordt gevraagd.

  • mimeType

    booleaans

    Chrome 49+

    Stel in op true als de waarde mimeType wordt gevraagd.

  • modificationTime

    booleaans

    Chrome 49+

    Stel in op true als de waarde modificationTime wordt gevraagd.

  • name

    booleaans

    Chrome 49+

    Stel in op true als de waarde name wordt gevraagd.

  • requestId

    getal

    De unieke ID van dit verzoek.

  • maat

    booleaans

    Chrome 49+

    Stel in op true als de waarde size wordt gevraagd.

  • thumbnail

    booleaans

    Stel in op true als de waarde thumbnail wordt gevraagd.

MountOptions

Eigenschappen

  • displayName

    tekenreeks

    Een voor mensen leesbare naam voor het bestandssysteem.

  • fileSystemId

    tekenreeks

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

  • openedFilesLimit

    number optioneel

    Het maximale aantal bestanden dat tegelijk kan worden geopend. Als u niets of 0 invoert, is er geen limiet.

  • persistent

    booleaans optioneel

    Chrome 64 of hoger

    Of het framework het bestandssysteem moet hervatten bij de volgende inlogsessie. Standaard True.

  • supportsNotifyTag

    booleaans optioneel

    Chrome 45+

    Of het bestandssysteem het veld tag ondersteunt voor geobserveerde mappen.

  • schrijfbaar

    booleaans optioneel

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

MoveEntryRequestedOptions

Eigenschappen

  • fileSystemId

    tekenreeks

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

  • requestId

    getal

    De unieke ID van dit verzoek.

  • sourcePath

    tekenreeks

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

  • targetPath

    tekenreeks

    Het bestemmingspad voor de kopieerbewerking.

NotifyOptions

Eigenschappen

  • changeType

    ChangeType

    Het type wijziging dat is aangebracht in de geobserveerde invoer. Als de status VERWIJDERD is, wordt de geobserveerde invoer automatisch verwijderd uit de lijst met geobserveerde invoer.

  • veranderingen

    Change[] optioneel

    Lijst met wijzigingen in items in de geobserveerde directory (waaronder het item zelf)

  • fileSystemId

    tekenreeks

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

  • observedPath

    tekenreeks

    Het pad van de geobserveerde invoer.

  • recursief

    booleaans

    Modus van de geobserveerde invoer.

  • tag

    tekenreeks optioneel

    Tag voor de melding. Vereist als het bestandssysteem is gekoppeld met de optie supportsNotifyTag. Deze markering is nodig om meldingen te geven over wijzigingen die zijn aangebracht, zelfs als het systeem was afgesloten.

OpenedFile

Eigenschappen

  • filePath

    tekenreeks

    Het pad van het geopende bestand.

  • modus

    OpenFileMode

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

  • openRequestId

    getal

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

OpenFileMode

Modus voor het openen van een bestand. Gebruikt door onOpenFileRequested.

Enum

READ

WRITE

OpenFileRequestedOptions

Eigenschappen

  • filePath

    tekenreeks

    Het pad van het bestand dat moet worden geopend.

  • fileSystemId

    tekenreeks

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

  • modus

    OpenFileMode

    Of het bestand wordt gebruikt voor lezen of schrijven.

  • requestId

    getal

    Een verzoek-ID die wordt gebruikt door opeenvolgende lees-/schrijf- en sluitingsverzoeken.

ProviderError

Foutcodes die worden gebruikt door extensies te bieden als reactie op verzoeken en in het geval van fouten bij het aanroepen van methoden van de API. Voor een succesvolle implementatie moet u "OK" gebruiken.

Enum

OK

FAILED

"IN_USE"

EXISTS

"NOT_FOUND"

ACCESS_DENIED

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"INVALID_OPERATION"

"SECURITY"

"ABORT"

"NOT_A_FILE"

"NOT_EMPTY"

"INVALID_URL"

IO

ReadDirectoryRequestedOptions

Eigenschappen

  • directoryPath

    tekenreeks

    Het pad van de directory waarvan de content wordt opgevraagd.

  • fileSystemId

    tekenreeks

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

  • isDirectory

    booleaans

    Chrome 49+

    Stel in op true als de waarde is_directory wordt gevraagd.

  • mimeType

    booleaans

    Chrome 49+

    Stel in op true als de waarde mimeType wordt gevraagd.

  • modificationTime

    booleaans

    Chrome 49+

    Stel in op true als de waarde modificationTime wordt gevraagd.

  • name

    booleaans

    Chrome 49+

    Stel in op true als de waarde name wordt gevraagd.

  • requestId

    getal

    De unieke ID van dit verzoek.

  • maat

    booleaans

    Chrome 49+

    Stel in op true als de waarde size wordt gevraagd.

  • thumbnail

    booleaans

    Chrome 49+

    Stel in op true als de waarde thumbnail wordt gevraagd.

ReadFileRequestedOptions

Eigenschappen

  • fileSystemId

    tekenreeks

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

  • lengte

    getal

    Het aantal bytes dat moet worden geretourneerd.

  • gecompenseerd

    getal

    De positie in het bestand (in bytes) waar het lezen moet beginnen.

  • openRequestId

    getal

    Een verzoek-ID die is gebruikt om het bestand te openen.

  • requestId

    getal

    De unieke ID van dit verzoek.

RemoveWatcherRequestedOptions

Eigenschappen

  • entryPath

    tekenreeks

    Het pad van het bekeken item.

  • fileSystemId

    tekenreeks

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

  • recursief

    booleaans

    Modus van de controleur.

  • requestId

    getal

    De unieke ID van dit verzoek.

TruncateRequestedOptions

Eigenschappen

  • filePath

    tekenreeks

    Het pad van het bestand dat moet worden afgekapt.

  • fileSystemId

    tekenreeks

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

  • lengte

    getal

    Het aantal bytes dat moet worden bewaard nadat de bewerking is afgerond.

  • requestId

    getal

    De unieke ID van dit verzoek.

UnmountOptions

Eigenschappen

  • fileSystemId

    tekenreeks

    De ID van het bestandssysteem dat moet worden ontkoppeld.

UnmountRequestedOptions

Eigenschappen

  • fileSystemId

    tekenreeks

    De ID van het bestandssysteem dat moet worden ontkoppeld.

  • requestId

    getal

    De unieke ID van dit verzoek.

Watcher

Eigenschappen

  • entryPath

    tekenreeks

    Het pad van de invoer die wordt geobserveerd.

  • lastTag

    tekenreeks optioneel

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

  • recursief

    booleaans

    Of alle onderliggende items recursief moeten worden opgenomen. Dit kan alleen waar zijn voor directory's.

WriteFileRequestedOptions

Eigenschappen

  • gegevens

    ArrayBuffer

    Buffer van bytes die naar het bestand moeten worden geschreven.

  • fileSystemId

    tekenreeks

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

  • gecompenseerd

    getal

    De positie in het bestand (in bytes) waar de bytes moeten worden geschreven.

  • openRequestId

    getal

    Een verzoek-ID die is gebruikt om het bestand te openen.

  • requestId

    getal

    De unieke ID van dit verzoek.

Methoden

get()

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

Retourneert informatie over een bestandssysteem met de doorgegeven fileSystemId.

Parameters

  • fileSystemId

    tekenreeks

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (fileSystem: FileSystemInfo) => void

Retourzendingen

  • Promise<FileSystemInfo>

    Chrome 96+

    Callback om het resultaat van de functie get te krijgen.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getAll()

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

Retourneert alle bestandssystemen die door de extensie zijn gekoppeld.

Parameters

Retourzendingen

  • Promise<FileSystemInfo[]>

    Chrome 96+

    Callback om het resultaat van de functie getAll te krijgen.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

mount()

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

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

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

Parameters

  • opties

    MountOptions

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 96+

    Een algemene resultaat-callback om aan te geven of de actie is geslaagd of mislukt.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

notify()

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

Stuurt meldingen over wijzigingen in de gecontroleerde directory op observedPath in de modus recursive. Als het bestandssysteem is gekoppeld met supportsNotifyTag, moet tag worden verstrekt 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.

Als je deze optie wilt gebruiken, moet de manifestoptie file_system_provider.notify zijn ingesteld op Waar.

De waarde van tag kan elke tekenreeks zijn die uniek is per gesprek, zodat de laatst geregistreerde melding kan worden geïdentificeerd. Als de verstrekkende extensie bijvoorbeeld start na een herstart en de tag van de laatst geregistreerde melding gelijk is aan 123, moet deze notify aanroepen voor alle wijzigingen die hebben plaatsgevonden sinds de wijziging met de tag 123. Het mag geen lege tekenreeks zijn.

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

Als een hoofddirectory wordt verwijderd, worden alle onderliggende items ook verwijderd. Als deze worden gecontroleerd, moet de API hiervan op de hoogte worden gesteld. Als de naam van een directory wordt gewijzigd, worden alle onderliggende vermeldingen verwijderd, omdat er geen vermelding meer is onder de oorspronkelijke paden.

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

Parameters

  • opties

    NotifyOptions

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 96+

    Een algemene resultaat-callback om aan te geven of de actie is geslaagd of mislukt.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

unmount()

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

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

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

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 96+

    Een algemene resultaat-callback om aan te geven of de actie is geslaagd of mislukt.

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

Evenementen

onAbortRequested

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

Wordt geactiveerd als wordt gevraagd een bewerking met operationRequestId af te breken. De bewerking die is uitgevoerd met operationRequestId moet onmiddellijk worden gestopt en successCallback van dit afbreekverzoek moet worden uitgevoerd. Als het afbreken mislukt, moet errorCallback worden aangeroepen. Callbacks van de afgebroken bewerking mogen niet worden aangeroepen, omdat ze worden genegeerd. Ondanks het aanroepen van errorCallback kan het verzoek geforceerd worden afgebroken.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

onAddWatcherRequested

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

Wordt geactiveerd als er een verzoek is om een nieuwe directory-watcher in te stellen. Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

onCloseFileRequested

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

Wordt geactiveerd als een bestand dat eerder is geopend met openRequestId, moet worden gesloten.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

onConfigureRequested

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

Wordt geactiveerd als er een verzoek is om een configuratiedialoogvenster voor fileSystemId te tonen. Als dit wordt afgehandeld, moet de manifestoptie file_system_provider.configurable zijn ingesteld op Waar.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

onCopyEntryRequested

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

Wordt geactiveerd als er een verzoek is om een item te kopiëren (recursief als het een directory is). Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

onCreateDirectoryRequested

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

Wordt geactiveerd als er een verzoek wordt gedaan om een directory te maken. De bewerking moet mislukken met de fout EXISTS als de doelmap al bestaat. Als recursive waar is, moeten alle ontbrekende mappen in het mappad worden gemaakt.

Parameters

onCreateFileRequested

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

Wordt geactiveerd als er een verzoek wordt gedaan om een bestand te maken. Als het bestand al bestaat, moet errorCallback worden aangeroepen met de foutcode "EXISTS".

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

onDeleteEntryRequested

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

Wordt geactiveerd als er een verzoek wordt ingediend om een item te verwijderen. Als recursive waar is en de invoer een directory is, moeten alle items daarin ook recursief worden verwijderd.

Parameters

onExecuteActionRequested

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

Wordt geactiveerd als er wordt gevraagd een actie uit te voeren voor een set bestanden of mappen. Nadat de actie is afgerond, moet successCallback worden aangeroepen. Bij een fout moet errorCallback worden aangeroepen.

Parameters

onGetActionsRequested

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

Wordt geactiveerd als een lijst met acties voor een set bestanden of mappen op entryPaths wordt aangevraagd. Alle geretourneerde acties moeten van toepassing zijn op elke invoer. Als er geen 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 geactiveerd als de metadata van een bestand of een directory op entryPath worden opgevraagd. De metadata moeten worden geretourneerd met de aanroep successCallback. In geval van een fout moet errorCallback worden aangeroepen.

Parameters

onMountRequested

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

Wordt geactiveerd als er een verzoek is om een dialoogvenster te tonen voor het koppelen van een nieuw bestandssysteem. 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 als een bestand wordt geopend. Voor meerdere koppelingen moet de manifestoptie file_system_provider.multiple_mounts zijn ingesteld op true.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

    • successCallback

      functie

      De parameter successCallback ziet er zo uit: 

      () => void

    • errorCallback

      functie

      De parameter errorCallback ziet er zo uit: 

      (error: ProviderError) => void

onMoveEntryRequested

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

Wordt geactiveerd als wordt gevraagd een item te verplaatsen (recursief als het een directory is). Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

onOpenFileRequested

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

Wordt geactiveerd als wordt gevraagd een bestand te openen op filePath. Als het bestand niet bestaat, moet de bewerking mislukken. Je kunt het maximale aantal bestanden dat tegelijk kan worden geopend, aangeven met MountOptions.

Parameters

onReadDirectoryRequested

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

Wordt geactiveerd als de content van een directory 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,
)

Wordt geactiveerd als de content van een bestand dat eerder is geopend 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

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

    • successCallback

      functie

      De parameter successCallback ziet er zo uit: 

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

      • gegevens

        ArrayBuffer

      • hasMore

        booleaans

    • errorCallback

      functie

      De parameter errorCallback ziet er zo uit: 

      (error: ProviderError) => void

onRemoveWatcherRequested

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

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

Parameters

onTruncateRequested

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

Wordt geactiveerd als er wordt gevraagd een bestand in te korten tot een gewenste lengte. Als er een fout optreedt, moet errorCallback worden aangeroepen.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

onUnmountRequested

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

Wordt geactiveerd als ontkoppelen wordt aangevraagd voor het bestandssysteem met de ID fileSystemId. In de reactie moet de API-methode unmount samen met successCallback worden aangeroepen. Als ontkoppelen niet mogelijk is (bijvoorbeeld vanwege een bewerking die in behandeling is), moet errorCallback worden aangeroepen.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

onWriteFileRequested

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

Wordt geactiveerd als er wordt gevraagd om content te schrijven naar een bestand dat eerder is geopend met openRequestId.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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