chrome.fileSystemProvider

Descrizione

Utilizza l'API chrome.fileSystemProvider per creare file system accessibili dal gestore di file su ChromeOS.

Autorizzazioni

fileSystemProvider

Disponibilità

Solo ChromeOS

Per utilizzare l'API File System Provider, devi dichiarare l'autorizzazione "fileSystemProvider" e la sezione nel manifest dell'estensione. Ad esempio:

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

La sezione file_system_provider deve essere dichiarata come segue:

configurable (booleano) - facoltativo
Indica se è supportata la configurazione tramite onConfiguraRequested. Per impostazione predefinita è false.
multiple_mounts (booleano) - facoltativo
Indica se sono supportati più file system montati (più di uno). Per impostazione predefinita è false.
watchable (booleano) - facoltativo
Indica se è supportata l'impostazione degli spettatori e delle notifiche relative ai cambiamenti. Per impostazione predefinita è false.
source (enum di "file", "device" o "network") - obbligatorio
Origine dei dati per i file system montati.

L'app Files utilizza le informazioni sopra indicate per visualizzare correttamente gli elementi dell'interfaccia utente correlati. Ad esempio, se configurable è impostato su true, verrà visualizzata una voce di menu per la configurazione dei volumi. Allo stesso modo, se il criterio multiple_mounts è impostato su true, l'app File consentirà di aggiungere più di un punto di montaggio dalla UI. Se watchable è false, verrà mostrato un pulsante di aggiornamento. Tieni presente che, se possibile, dovresti aggiungere il supporto per gli spettatori, in modo che le modifiche apportate al file system possano essere applicate immediatamente e automaticamente.

Panoramica

L'API File System Provider consente alle estensioni di supportare file system virtuali, disponibili nel gestore di file su ChromeOS. I casi d'uso includono la decompressione degli archivi e l'accesso ai file in un servizio cloud diverso da Drive.

Montaggio di file system

Le estensioni indicate possono fornire contenuti del file system provenienti da una sorgente esterna (ad esempio un server remoto o un dispositivo USB) oppure utilizzare un file locale (ad esempio un archivio) come input.

Per scrivere file system che sono gestori di file (l'origine è "file"), il provider deve essere un'app in pacchetto, poiché l'evento onLaunched non è disponibile per le estensioni.

Se l'origine è la rete o un dispositivo, il file system deve essere montato quando viene chiamato l'evento onMountRequested.

Origine dei dati del file system Punto di ingresso
"file" Disponibile solo per le app in pacchetto.
"device" o "network" onMountRequested

Configurazione di file system

I file system forniti una volta montati possono essere configurati tramite l'evento onConfigureRequested. È particolarmente utile per i file system che forniscono contenuti tramite rete per impostare le credenziali appropriate. La gestione di questo evento è facoltativa.

ciclo di vita

Una volta montati, i file system forniti vengono memorizzati da Chrome e rimontati automaticamente dopo il riavvio o il riavvio. Di conseguenza, una volta che un file system viene montato da un'estensione che fornisce, rimane fino a quando l'estensione non viene caricata o l'estensione chiama il metodo unmount.

Tipi

AbortRequestedOptions

Proprietà

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • operationRequestId

    numero

    Un ID della richiesta da interrompere.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

Action

Chrome 45 e versioni successive

Proprietà

  • id

    stringa

    L'identificatore dell'azione. Qualsiasi stringa o CommonActionId per le azioni comuni.

  • title

    stringa facoltativo

    Il titolo dell'azione. Potrebbe essere ignorato per le azioni comuni.

AddWatcherRequestedOptions

Proprietà

  • entryPath

    stringa

    Il percorso della voce da osservare.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • ricorsivo

    boolean

    Se l'osservazione deve includere tutte le voci figlio in modo ricorsivo. Può essere vero solo per le directory.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

Change

Proprietà

  • changeType

    ChangeType

    Il tipo di modifica apportata alla voce.

  • cloudFileInfo

    Facoltativo CloudFileInfo

    In attesa

    Informazioni relative al file, se supportate da un file system cloud.

  • entryPath

    stringa

    Il percorso della voce modificata.

ChangeType

Tipo di modifica rilevata nella directory osservata.

Enum

CloseFileRequestedOptions

Proprietà

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • openRequestId

    numero

    Un ID richiesta utilizzato per aprire il file.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

CloudFileInfo

In attesa

Proprietà

  • versionTag

    stringa facoltativo

    Un tag che rappresenta la versione del file.

CloudIdentifier

Chrome 117 e versioni successive

Proprietà

  • id

    stringa

    Identificatore del provider per il file o la directory specificati.

  • providerName

    stringa

    Identificatore del fornitore di spazio di archiviazione sul cloud (ad es. "drive.google.com").

CommonActionId

Chrome 45 e versioni successive

Elenco di azioni comuni. "SHARE" consente la condivisione di file con altre persone. "SAVE_FOR_OFFLINE" per il blocco (salvataggio per l'accesso offline). "OFFLINE_NOT_NECESSARY" per notificare che non è più necessario archiviare il file per l'accesso offline. Utilizzato da onGetActionsRequested e onExecuteActionRequested.

Enum

"OFFLINE_NOT_NECESSARY"

ConfigureRequestedOptions

Chrome 44 e versioni successive

Proprietà

  • fileSystemId

    stringa

    L'identificatore del file system da configurare.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

CopyEntryRequestedOptions

Proprietà

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

  • sourcePath

    stringa

    Il percorso di origine della voce da copiare.

  • targetPath

    stringa

    Il percorso di destinazione per l'operazione di copia.

CreateDirectoryRequestedOptions

Proprietà

  • directoryPath

    stringa

    Il percorso della directory da creare.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • ricorsivo

    boolean

    Indica se l'operazione è ricorsiva (solo per le directory).

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

CreateFileRequestedOptions

Proprietà

  • filePath

    stringa

    Il percorso del file da creare.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

DeleteEntryRequestedOptions

Proprietà

  • entryPath

    stringa

    Il percorso della voce da eliminare.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • ricorsivo

    boolean

    Indica se l'operazione è ricorsiva (solo per le directory).

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

EntryMetadata

Proprietà

  • cloudFileInfo

    Facoltativo CloudFileInfo

    In attesa

    Informazioni che identificano un file specifico nel file system cloud sottostante. Deve essere fornito se richiesto in options e il file è supportato dallo spazio di archiviazione sul cloud.

  • cloudIdentifier

    Facoltativo CloudIdentifier

    Chrome 117 e versioni successive

    Rappresentazione di Cloud Storage di questa voce. Deve essere fornito se richiesto in options e il file è supportato dallo spazio di archiviazione sul cloud. Per i file locali non supportati dallo spazio di archiviazione sul cloud, non deve essere definito quando richiesto.

  • isDirectory

    booleano facoltativo

    True se si tratta di una directory. Deve essere fornito se richiesto in options.

  • mimeType

    stringa facoltativo

    Tipo Mime per la voce. Sempre facoltativo, ma deve essere fornito se richiesto in options.

  • modificationTime

    Data facoltativa

    L'ora dell'ultima modifica di questa voce. Deve essere fornito se richiesto in options.

  • nome

    stringa facoltativo

    Nome di questa voce (non il nome completo del percorso). Non deve contenere "/". Il valore del campo root deve essere vuoto. Deve essere fornito se richiesto in options.

  • dimensioni

    numero facoltativo

    Dimensioni del file in byte. Deve essere fornito se richiesto in options.

  • thumbnail

    stringa facoltativo

    Immagine in miniatura come URI dati in formato PNG, JPEG o WEBP e di una dimensione massima di 32 kB. Facoltativa, ma può essere fornita solo quando richiesto esplicitamente dall'evento onGetMetadataRequested.

ExecuteActionRequestedOptions

Chrome 45 e versioni successive

Proprietà

  • actionId

    stringa

    L'identificatore dell'azione da eseguire.

  • entryPaths

    stringa[]

    Chrome 47 e versioni successive

    L'insieme di percorsi delle voci da utilizzare per l'azione.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

FileSystemInfo

Proprietà

  • displayName

    stringa

    Un nome leggibile per il file system.

  • fileSystemId

    stringa

    L'identificatore del file system.

  • openedFiles

    OpenedFile[]

    Elenco dei file attualmente aperti.

  • openedFilesLimit

    numero

    Il numero massimo di file che è possibile aprire contemporaneamente. Se è 0, non è limitato.

  • supportsNotifyTag

    booleano facoltativo

    Chrome 45 e versioni successive

    Indica se il file system supporta il campo tag per l'osservazione delle directory.

  • spettatori

    Guardatore[]

    Chrome 45 e versioni successive

    Elenco degli spettatori.

  • scrivibile

    boolean

    Se il file system supporta operazioni che possono modificare i contenuti del file system (ad esempio la creazione, l'eliminazione o la scrittura sui file).

GetActionsRequestedOptions

Chrome 45 e versioni successive

Proprietà

  • entryPaths

    stringa[]

    Chrome 47 e versioni successive

    Elenco di percorsi di voci per l'elenco di azioni.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

GetMetadataRequestedOptions

Proprietà

  • cloudFileInfo

    boolean

    In attesa

    Imposta su true se viene richiesto il valore di cloudFileInfo.

  • cloudIdentifier

    boolean

    Chrome 117 e versioni successive

    Imposta su true se viene richiesto il valore di cloudIdentifier.

  • entryPath

    stringa

    Il percorso della voce su cui recuperare i metadati.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • isDirectory

    boolean

    Chrome 49 e versioni successive

    Imposta su true se viene richiesto il valore di is_directory.

  • mimeType

    boolean

    Chrome 49 e versioni successive

    Imposta su true se viene richiesto il valore di mimeType.

  • modificationTime

    boolean

    Chrome 49 e versioni successive

    Imposta su true se viene richiesto il valore di modificationTime.

  • nome

    boolean

    Chrome 49 e versioni successive

    Imposta su true se viene richiesto il valore di name.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

  • dimensioni

    boolean

    Chrome 49 e versioni successive

    Imposta su true se viene richiesto il valore di size.

  • thumbnail

    boolean

    Imposta su true se viene richiesto il valore di thumbnail.

MountOptions

Proprietà

  • displayName

    stringa

    Un nome leggibile per il file system.

  • fileSystemId

    stringa

    L'identificatore di stringa del file system. Deve essere univoco per ogni estensione.

  • openedFilesLimit

    numero facoltativo

    Il numero massimo di file che è possibile aprire contemporaneamente. Se non specificato, o 0, non è limitato.

  • permanente

    booleano facoltativo

    Chrome 64 e versioni successive

    Indica se il framework deve riprendere il file system alla successiva sessione di accesso. True per impostazione predefinita.

  • supportsNotifyTag

    booleano facoltativo

    Chrome 45 e versioni successive

    Indica se il file system supporta il campo tag per le directory osservate.

  • scrivibile

    booleano facoltativo

    Se il file system supporta operazioni che possono modificare i contenuti del file system (ad esempio la creazione, l'eliminazione o la scrittura sui file).

MoveEntryRequestedOptions

Proprietà

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

  • sourcePath

    stringa

    Il percorso di origine della voce da spostare in una nuova posizione.

  • targetPath

    stringa

    Il percorso di destinazione per l'operazione di copia.

NotifyOptions

Proprietà

  • changeType

    ChangeType

    Il tipo della modifica apportata alla voce osservata. Se è ELIMINATA, la voce osservata verrà rimossa automaticamente dall'elenco delle voci osservate.

  • modifiche

    Modifica[] facoltativa

    Elenco di modifiche alle voci all'interno della directory osservata (inclusa la voce stessa)

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa modifica.

  • observedPath

    stringa

    Il percorso della voce osservata.

  • ricorsivo

    boolean

    Modalità della voce osservata.

  • Il tag.

    stringa facoltativo

    Tagga per la notifica. Obbligatorio se il file system è stato montato con l'opzione supportsNotifyTag. Tieni presente che questo flag è necessario per fornire notifiche relative a modifiche che sono cambiate anche quando il sistema è stato arrestato.

OpenedFile

Proprietà

  • filePath

    stringa

    Il percorso del file aperto.

  • modalità

    OpenFileMode

    Indica se il file è stato aperto per la lettura o la scrittura.

  • openRequestId

    numero

    Un ID richiesta che deve essere utilizzato da richieste di lettura/scrittura e chiusura consecutive.

OpenFileMode

Modalità di apertura di un file. Utilizzato da onOpenFileRequested.

Enum

OpenFileRequestedOptions

Proprietà

  • filePath

    stringa

    Il percorso del file da aprire.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • modalità

    OpenFileMode

    Indica se il file verrà utilizzato per la lettura o la scrittura.

  • requestId

    numero

    Un ID richiesta che verrà utilizzato da richieste di lettura/scrittura e chiusura consecutive.

ProviderError

Codici di errore utilizzati fornendo estensioni in risposta alle richieste e in caso di errori durante la chiamata dei metodi dell'API. Per l'esito positivo, è necessario utilizzare "OK".

Enum

"OK"

"IN_USE"

"NOT_FOUND"

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"ABORT"

"NOT_A_FILE"

"NOT_EMPTY"

"INVALID_URL"

"IO"

ReadDirectoryRequestedOptions

Proprietà

  • directoryPath

    stringa

    Il percorso della directory di cui vengono richiesti i contenuti.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • isDirectory

    boolean

    Chrome 49 e versioni successive

    Imposta su true se viene richiesto il valore di is_directory.

  • mimeType

    boolean

    Chrome 49 e versioni successive

    Imposta su true se viene richiesto il valore di mimeType.

  • modificationTime

    boolean

    Chrome 49 e versioni successive

    Imposta su true se viene richiesto il valore di modificationTime.

  • nome

    boolean

    Chrome 49 e versioni successive

    Imposta su true se viene richiesto il valore di name.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

  • dimensioni

    boolean

    Chrome 49 e versioni successive

    Imposta su true se viene richiesto il valore di size.

  • thumbnail

    boolean

    Chrome 49 e versioni successive

    Imposta su true se viene richiesto il valore di thumbnail.

ReadFileRequestedOptions

Proprietà

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • length

    numero

    Numero di byte da restituire.

  • offset

    numero

    Posiziona il file (in byte) da cui iniziare la lettura.

  • openRequestId

    numero

    Un ID richiesta utilizzato per aprire il file.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

RemoveWatcherRequestedOptions

Proprietà

  • entryPath

    stringa

    Il percorso della voce guardata.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • ricorsivo

    boolean

    Modalità di chi guarda.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

TruncateRequestedOptions

Proprietà

  • filePath

    stringa

    Il percorso del file da troncare.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • length

    numero

    Numero di byte da conservare al termine dell'operazione.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

UnmountOptions

Proprietà

  • fileSystemId

    stringa

    L'identificatore del file system da smontare.

UnmountRequestedOptions

Proprietà

  • fileSystemId

    stringa

    L'identificatore del file system da smontare.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

Watcher

Proprietà

  • entryPath

    stringa

    Il percorso della voce osservata.

  • lastTag

    stringa facoltativo

    Tag utilizzato dall'ultima notifica per l'utente che guarda.

  • ricorsivo

    boolean

    Se la visione deve includere tutte le voci figlio in modo ricorsivo. Può essere vero solo per le directory.

WriteFileRequestedOptions

Proprietà

  • data

    ArrayBuffer

    Buffer di byte da scrivere nel file.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • offset

    numero

    Posizione all'interno del file (in byte) da cui iniziare a scrivere i byte.

  • openRequestId

    numero

    Un ID richiesta utilizzato per aprire il file.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

Metodi

get()

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

Restituisce informazioni su un file system con il valore fileSystemId passato.

Parametri

  • fileSystemId

    stringa

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (fileSystem: FileSystemInfo)=>void

Ritorni

  • Promise<FileSystemInfo>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

getAll()

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

Restituisce tutti i file system montati dall'estensione.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (fileSystems: FileSystemInfo[])=>void

Ritorni

  • Promise<FileSystemInfo[]>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

mount()

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

Monta un file system con i valori fileSystemId e displayName specificati. displayName verrà visualizzata nel riquadro sinistro dell'app File. displayName può contenere qualsiasi carattere, tra cui "/", ma non può essere una stringa vuota. displayName deve essere descrittivo ma non deve essere univoco. La stringa fileSystemId non deve essere vuota.

A seconda del tipo di file system montato, l'opzione source deve essere impostata correttamente.

In caso di errore, runtime.lastError verrà impostato con il codice di errore corrispondente.

Parametri

  • opzioni del modello.

    MountOptions

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

notify()

Promessa Chrome 45 e versioni successive 
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
  callback?: function,
)

Invia una notifica in caso di modifiche alla directory guardata all'indirizzo observedPath in modalità recursive. Se il file system viene montato con supportsNotifyTag, è necessario specificare tag e tutte le modifiche apportate dall'ultima notifica vengono sempre segnalate, anche se il sistema è stato arrestato. L'ultimo tag può essere ottenuto con getAll.

Per utilizzarla, l'opzione relativa al manifest file_system_provider.notify deve essere impostata su true.

Il valore di tag può essere qualsiasi stringa univoca per chiamata, quindi è possibile identificare l'ultima notifica registrata. Ad esempio, se l'estensione fornita inizia dopo un riavvio e il tag dell'ultima notifica registrata è uguale a "123", dovrebbe chiamare notify per tutte le modifiche apportate dopo la modifica contrassegnata come "123". Non può essere una stringa vuota.

Non tutti i provider sono in grado di fornire un tag. Tuttavia, se il file system ha un log delle modifiche, questo può essere, ad esempio, un numero di modifica o un numero di revisione.

Tieni presente che se viene rimossa una directory padre, vengono rimosse anche tutte le voci discendenti e, se vengono controllate, l'API deve ricevere una notifica a riguardo. Inoltre, se una directory viene rinominata, tutte le voci discendenti vengono di fatto rimosse, in quanto non esistono più voci nei percorsi originali.

In caso di errore, verrà impostato runtime.lastError come codice di errore corrispondente.

Parametri

  • opzioni del modello.

    NotifyOptions

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

unmount()

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

Smonta un file system con il valore fileSystemId specificato. Deve essere chiamato dopo aver richiamato onUnmountRequested. Inoltre, l'estensione che ha fornito può decidere di eseguire lo smontaggio se non richiesto (ad esempio in caso di perdita della connessione o errore di file).

In caso di errore, runtime.lastError verrà impostato con il codice di errore corrispondente.

Parametri

  • opzioni del modello.

    UnmountOptions

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 96 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

Eventi

onAbortRequested

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

Messaggio sollevato quando viene richiesta l'interruzione di un'operazione con operationRequestId. L'operazione eseguita con operationRequestId deve essere immediatamente interrotta ed è necessario eseguire successCallback di questa richiesta di interruzione. Se l'interruzione non va a buon fine, è necessario chiamare errorCallback. Tieni presente che i callback dell'operazione interrotta non devono essere chiamati perché verranno ignorati. Nonostante la chiamata al numero errorCallback, la richiesta potrebbe essere interrotta forzatamente.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • opzioni del modello.

      AbortRequestedOptions

    • successCallback

      funzione

      Il parametro successCallback ha il seguente aspetto: 

      ()=>void

    • errorCallback

      funzione

      Il parametro errorCallback ha il seguente aspetto: 

      (error: ProviderError)=>void

onAddWatcherRequested

Chrome 45 e versioni successive 
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

Assegnato quando viene richiesta l'impostazione di un nuovo strumento di visualizzazione della directory. Se si verifica un errore, è necessario chiamare errorCallback.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • opzioni del modello.

      AddWatcherRequestedOptions

    • successCallback

      funzione

      Il parametro successCallback ha il seguente aspetto: 

      ()=>void

    • errorCallback

      funzione

      Il parametro errorCallback ha il seguente aspetto: 

      (error: ProviderError)=>void

onCloseFileRequested

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

Opzione sollevata quando viene richiesta la chiusura di un file aperto in precedenza con openRequestId.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • opzioni del modello.

      CloseFileRequestedOptions

    • successCallback

      funzione

      Il parametro successCallback ha il seguente aspetto: 

      ()=>void

    • errorCallback

      funzione

      Il parametro errorCallback ha il seguente aspetto: 

      (error: ProviderError)=>void

onConfigureRequested

Chrome 44 e versioni successive 
chrome.fileSystemProvider.onConfigureRequested.addListener(
  callback: function,
)

Opzione sollevata quando viene richiesta la visualizzazione di una finestra di dialogo di configurazione per fileSystemId. Se viene gestita, l'opzione principale di file_system_provider.configurable deve essere impostata su true.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • opzioni del modello.

      ConfigureRequestedOptions

    • successCallback

      funzione

      Il parametro successCallback ha il seguente aspetto: 

      ()=>void

    • errorCallback

      funzione

      Il parametro errorCallback ha il seguente aspetto: 

      (error: ProviderError)=>void

onCopyEntryRequested

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

Valore impostato quando viene richiesta la copia di una voce (in modo ricorsivo se una directory). Se si verifica un errore, è necessario chiamare errorCallback.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • opzioni del modello.

      CopyEntryRequestedOptions

    • successCallback

      funzione

      Il parametro successCallback ha il seguente aspetto: 

      ()=>void

    • errorCallback

      funzione

      Il parametro errorCallback ha il seguente aspetto: 

      (error: ProviderError)=>void

onCreateDirectoryRequested

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

Opzione sollevata quando viene richiesta la creazione di una directory. L'operazione non deve riuscire con l'errore EXISTS se la directory di destinazione esiste già. Se recursive è true, è necessario creare tutte le directory mancanti nel percorso della directory.

Parametri

onCreateFileRequested

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

Selezionato quando viene richiesta la creazione di un file. Se il file esiste già, è necessario chiamare errorCallback con il codice di errore "EXISTS".

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • opzioni del modello.

      CreateFileRequestedOptions

    • successCallback

      funzione

      Il parametro successCallback ha il seguente aspetto: 

      ()=>void

    • errorCallback

      funzione

      Il parametro errorCallback ha il seguente aspetto: 

      (error: ProviderError)=>void

onDeleteEntryRequested

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

Assegnato quando viene richiesta l'eliminazione di una voce. Se recursive è true e la voce è una directory, anche tutte le voci al suo interno devono essere eliminate in modo ricorsivo.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

onExecuteActionRequested

Chrome 48 e versioni successive 
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
  callback: function,
)

Valore impostato quando viene eseguita un'azione per un insieme di file o directory\ richiesta. Una volta completata l'azione, è necessario chiamare successCallback. In caso di errore, è necessario chiamare errorCallback.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

onGetActionsRequested

Chrome 48 e versioni successive 
chrome.fileSystemProvider.onGetActionsRequested.addListener(
  callback: function,
)

Questo comando viene visualizzato quando viene richiesto un elenco di azioni per un insieme di file o directory in entryPaths. Tutte le azioni restituite devono essere applicabili a ciascuna voce. Se queste azioni non sono presenti, deve essere restituito un array vuoto. Le azioni devono essere restituite con la chiamata successCallback. In caso di errore, è necessario chiamare errorCallback.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

onGetMetadataRequested

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

Inviato quando vengono richiesti i metadati di un file o di una directory all'indirizzo entryPath. I metadati devono essere restituiti con la chiamata successCallback. In caso di errore, è necessario chiamare errorCallback.

Parametri

onMountRequested

Chrome 44 e versioni successive 
chrome.fileSystemProvider.onMountRequested.addListener(
  callback: function,
)

Opzione sollevata quando viene visualizzata una finestra di dialogo per montare un nuovo file system. Se l'estensione/l'app è un gestore di file, questo evento non deve essere gestito. Dovresti invece gestire app.runtime.onLaunched per montare nuovi file system all'apertura di un file. Per più montaggi, l'opzione del manifest file_system_provider.multiple_mounts deve essere impostata su true.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • successCallback

      funzione

      Il parametro successCallback ha il seguente aspetto: 

      ()=>void

    • errorCallback

      funzione

      Il parametro errorCallback ha il seguente aspetto: 

      (error: ProviderError)=>void

onMoveEntryRequested

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

Valore impostato quando si sposta una voce (in modo ricorsivo se una directory) viene richiesto. Se si verifica un errore, è necessario chiamare errorCallback.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • opzioni del modello.

      MoveEntryRequestedOptions

    • successCallback

      funzione

      Il parametro successCallback ha il seguente aspetto: 

      ()=>void

    • errorCallback

      funzione

      Il parametro errorCallback ha il seguente aspetto: 

      (error: ProviderError)=>void

onOpenFileRequested

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

Opzione sollevata quando viene richiesta l'apertura di un file in filePath. Se il file non esiste, l'operazione non deve riuscire. Il numero massimo di file aperti contemporaneamente può essere specificato con MountOptions.

Parametri

onReadDirectoryRequested

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

Messaggio sollevato quando vengono richiesti contenuti di una directory in directoryPath. I risultati devono essere restituiti in blocchi chiamando successCallback più volte. In caso di errore, è necessario chiamare errorCallback.

Parametri

onReadFileRequested

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

Questo comando viene sollevato quando viene richiesta la lettura dei contenuti di un file aperto in precedenza con openRequestId. I risultati devono essere restituiti in blocchi chiamando successCallback più volte. In caso di errore, è necessario chiamare errorCallback.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • opzioni del modello.

      ReadFileRequestedOptions

    • successCallback

      funzione

      Il parametro successCallback ha il seguente aspetto: 

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

      • data

        ArrayBuffer

      • hasMore

        boolean

    • errorCallback

      funzione

      Il parametro errorCallback ha il seguente aspetto: 

      (error: ProviderError)=>void

onRemoveWatcherRequested

Chrome 45 e versioni successive 
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
  callback: function,
)

Aumentato quando il visualizzatore deve essere rimosso. Se si verifica un errore, è necessario chiamare errorCallback.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

onTruncateRequested

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

Aumentato quando viene richiesto il troncamento di un file alla lunghezza desiderata. Se si verifica un errore, è necessario chiamare errorCallback.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • opzioni del modello.

      TruncateRequestedOptions

    • successCallback

      funzione

      Il parametro successCallback ha il seguente aspetto: 

      ()=>void

    • errorCallback

      funzione

      Il parametro errorCallback ha il seguente aspetto: 

      (error: ProviderError)=>void

onUnmountRequested

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

Aumentato durante lo smontaggio del file system con l'identificatore fileSystemId. Nella risposta, il metodo API unmount deve essere chiamato insieme a successCallback. Se non è possibile smontare (ad es. a causa di un'operazione in sospeso), è necessario chiamare errorCallback.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • opzioni del modello.

      UnmountRequestedOptions

    • successCallback

      funzione

      Il parametro successCallback ha il seguente aspetto: 

      ()=>void

    • errorCallback

      funzione

      Il parametro errorCallback ha il seguente aspetto: 

      (error: ProviderError)=>void

onWriteFileRequested

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

Pulsante sollevato quando viene richiesta la scrittura di contenuti in un file aperto in precedenza con openRequestId.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • opzioni del modello.

      WriteFileRequestedOptions

    • successCallback

      funzione

      Il parametro successCallback ha il seguente aspetto: 

      ()=>void

    • errorCallback

      funzione

      Il parametro errorCallback ha il seguente aspetto: 

      (error: ProviderError)=>void