chrome.fileSystemProvider

Descrizione

Utilizza l'API chrome.fileSystemProvider per creare file system accessibili tramite Gestione file su ChromeOS.

Autorizzazioni

fileSystemProvider

Disponibilità

Solo ChromeOS .

Manifest

Devi dichiarare il valore "fileSystemProvider" e la sezione del manifest dell'estensione per utilizzare l'API File System Provider. 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 di spettatori e l'invio di notifiche sulle modifiche. 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 riportate sopra per visualizzare in modo appropriato gli elementi UI correlati. Ad esempio, se il criterio configurable viene impostato su true, viene visualizzata una voce di menu per la configurazione dei volumi. Allo stesso modo, se il criterio multiple_mounts è impostato su true, l'app Files consente di aggiungere più di un punto di montaggio dalla UI. Se watchable è false, verrà eseguito il rendering di un pulsante di aggiornamento. Tieni presente che, se possibile, dovresti aggiungere il supporto per gli spettatori, in modo che le modifiche al file system possano essere applicate immediatamente e automaticamente.

Panoramica

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

Montaggio dei file system

Le estensioni possono fornire contenuti del file system 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 è una 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 soltanto per le app in pacchetto.
"device" o "network" onMountRequested

Configurazione dei 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 al fine di impostare le credenziali corrette. 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. Pertanto, una volta che un file system viene montato da un'estensione che fornisce, rimarrà fino a quando l'estensione non viene scaricata o fino a quando l'estensione non 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 della richiesta.

Action

Chrome 45 e versioni successive .

Proprietà

  • id

    stringa

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

  • titolo

    stringa facoltativo

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

AddWatcherRequestedOptions

Proprietà

  • entryPath

    stringa

    Il percorso della voce da osservare.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • ricorsivo

    booleano

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

  • requestId

    numero

    L'identificatore univoco della richiesta.

Change

Proprietà

  • changeType

    ChangeType

    Il tipo di modifica apportata alla voce.

  • cloudFileInfo

    CloudFileInfo facoltativo

    Chrome 125 e versioni successive .

    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

"MODIFICATO"

"ELIMINATO"

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 della richiesta.

CloudFileInfo

Chrome 125 e versioni successive .

Proprietà

  • versionTag

    stringa facoltativo

    Un tag che rappresenta la versione del file.

CloudIdentifier

Chrome 117 e versioni successive .

Proprietà

  • id

    stringa

    L'identificatore del provider per il file/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 delle azioni comuni. "SHARE" consente di condividere file con altre persone. "SAVE_FOR_OFFLINE" per la posizione in primo piano (salvataggio per l'accesso offline). "OFFLINE_NOT_NECESSARY" per la notifica che indica che non è più necessario archiviare il file per l'accesso offline. Utilizzato da onGetActionsRequested e onExecuteActionRequested.

Enum

"SAVE_FOR_OFFLINE"

"OFFLINE_NOT_NECESSARY"

"CONDIVIDI"

ConfigureRequestedOptions

Chrome 44 e versioni successive .

Proprietà

  • fileSystemId

    stringa

    L'identificatore del file system da configurare.

  • requestId

    numero

    L'identificatore univoco della richiesta.

CopyEntryRequestedOptions

Proprietà

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • requestId

    numero

    L'identificatore univoco della 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

    booleano

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

  • requestId

    numero

    L'identificatore univoco della 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 della richiesta.

DeleteEntryRequestedOptions

Proprietà

  • entryPath

    stringa

    Il percorso della voce da eliminare.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • ricorsivo

    booleano

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

  • requestId

    numero

    L'identificatore univoco della richiesta.

EntryMetadata

Proprietà

  • cloudFileInfo

    CloudFileInfo facoltativo

    Chrome 125 e versioni successive .

    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

    CloudIdentifier facoltativo

    Chrome 117 e versioni successive .

    Rappresentazione 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 da Cloud Storage, il valore deve essere indefinito quando richiesto.

  • isDirectory

    booleano facoltativo

    True se è una directory. Deve essere fornito se richiesto in options.

  • mimeType

    stringa facoltativo

    Tipo MIME della 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 della voce (non il nome del percorso completo). Non deve contenere "/". Il campo deve essere vuoto per il root. 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 di dati in formato PNG, JPEG o WEBP, con una dimensione massima di 32 kB. Facoltativo, ma può essere fornito 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 della 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 possono essere aperti 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 di spettatori.

  • accessibile in scrittura

    booleano

    Indica se il file system supporta operazioni che potrebbero modificare i contenuti del file system (ad esempio creazione, eliminazione o scrittura su file).

GetActionsRequestedOptions

Chrome 45 e versioni successive .

Proprietà

  • entryPaths

    stringa[]

    Chrome 47 e versioni successive .

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

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • requestId

    numero

    L'identificatore univoco della richiesta.

GetMetadataRequestedOptions

Proprietà

  • cloudFileInfo

    booleano

    Chrome 125 e versioni successive .

    Imposta su true se viene richiesto il valore cloudFileInfo.

  • cloudIdentifier

    booleano

    Chrome 117 e versioni successive .

    Imposta il valore su true se viene richiesto il valore cloudIdentifier.

  • entryPath

    stringa

    Il percorso della voce di cui recuperare i metadati.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • isDirectory

    booleano

    Chrome 49 e versioni successive .

    Imposta il valore su true se viene richiesto il valore is_directory.

  • mimeType

    booleano

    Chrome 49 e versioni successive .

    Imposta il valore su true se viene richiesto il valore mimeType.

  • modificationTime

    booleano

    Chrome 49 e versioni successive .

    Imposta il valore su true se viene richiesto il valore modificationTime.

  • nome

    booleano

    Chrome 49 e versioni successive .

    Imposta il valore su true se viene richiesto il valore name.

  • requestId

    numero

    L'identificatore univoco della richiesta.

  • dimensioni

    booleano

    Chrome 49 e versioni successive .

    Imposta il valore su true se viene richiesto il valore size.

  • thumbnail

    booleano

    Imposta il valore su true se viene richiesto il valore 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 possono essere aperti contemporaneamente. Se non specificato o se è pari a 0, non è specificato.

  • persistente

    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.

  • accessibile in scrittura

    booleano facoltativo

    Indica se il file system supporta operazioni che potrebbero modificare i contenuti del file system (ad esempio creazione, eliminazione o scrittura su file).

MoveEntryRequestedOptions

Proprietà

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • requestId

    numero

    L'identificatore univoco della 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 di modifica apportata alla voce osservata. Se viene eliminato, la voce osservata verrà rimossa automaticamente dall'elenco delle voci osservate.

  • modifiche

    Modifica[] facoltativa

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

  • fileSystemId

    stringa

    L'identificatore del file system correlato a questa modifica.

  • observedPath

    stringa

    Il percorso della voce osservata.

  • ricorsivo

    booleano

    Modalità della voce osservata.

  • tag

    stringa facoltativo

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

OpenedFile

Proprietà

  • filePath

    stringa

    Il percorso del file aperto.

  • modalità

    OpenFileMode

    Se il file è stato aperto per la lettura o la scrittura.

  • openRequestId

    numero

    Un ID richiesta da utilizzare da richieste di lettura/scrittura e chiusura consecutive.

OpenFileMode

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

Enum

"LEGGI"

"SCRITTURA"

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 consecutive di lettura, scrittura e chiusura.

ProviderError

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

Enum

"Ok"

"NON RIUSCITA"

"IN_USE"

"ESISTE"

"NOT_FOUND"

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"INVALID_OPERATION"

"SICUREZZA"

"INTERRUZIONE"

"NOT_A_FILE"

"NOT_EMPTY"

"INVALID_URL"

"IO"

ReadDirectoryRequestedOptions

Proprietà

  • directoryPath

    stringa

    Il percorso della directory i cui contenuti vengono richiesti.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • isDirectory

    booleano

    Chrome 49 e versioni successive .

    Imposta il valore su true se viene richiesto il valore is_directory.

  • mimeType

    booleano

    Chrome 49 e versioni successive .

    Imposta il valore su true se viene richiesto il valore mimeType.

  • modificationTime

    booleano

    Chrome 49 e versioni successive .

    Imposta su true se viene richiesto il valore modificationTime.

  • nome

    booleano

    Chrome 49 e versioni successive .

    Imposta il valore su true se viene richiesto il valore name.

  • requestId

    numero

    L'identificatore univoco della richiesta.

  • dimensioni

    booleano

    Chrome 49 e versioni successive .

    Imposta il valore su true se viene richiesto il valore size.

  • thumbnail

    booleano

    Chrome 49 e versioni successive .

    Imposta il valore su true se viene richiesto il valore thumbnail.

ReadFileRequestedOptions

Proprietà

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • lunghezza

    numero

    Numero di byte da restituire.

  • offset

    numero

    Posizionati nel file (in byte) da cui iniziare a leggere.

  • openRequestId

    numero

    Un ID richiesta utilizzato per aprire il file.

  • requestId

    numero

    L'identificatore univoco della richiesta.

RemoveWatcherRequestedOptions

Proprietà

  • entryPath

    stringa

    Il percorso della voce controllata.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • ricorsivo

    booleano

    Modalità dello spettatore.

  • requestId

    numero

    L'identificatore univoco della richiesta.

TruncateRequestedOptions

Proprietà

  • filePath

    stringa

    Il percorso del file da troncare.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • lunghezza

    numero

    Numero di byte da conservare al termine dell'operazione.

  • requestId

    numero

    L'identificatore univoco della 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 della richiesta.

Watcher

Proprietà

  • entryPath

    stringa

    Il percorso della voce osservato.

  • lastTag

    stringa facoltativo

    Tag utilizzato dall'ultima notifica per l'osservatore.

  • ricorsivo

    booleano

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

WriteFileRequestedOptions

Proprietà

  • dati

    ArrayBuffer

    Buffer di byte da scrivere nel file.

  • fileSystemId

    stringa

    L'identificatore del file system relativo a questa operazione.

  • offset

    numero

    Posizionati nel 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 della richiesta.

Metodi

get()

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

Restituisce informazioni su un file system con l'istruzione fileSystemId superata.

Parametri

  • fileSystemId

    stringa

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (fileSystem: FileSystemInfo) => void

Resi

  • Promise<FileSystemInfo>

    Chrome 96 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

getAll()

Promesso .
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

Resi

  • Promise<FileSystemInfo[]>

    Chrome 96 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

mount()

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

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

A seconda del tipo di file system da montare, è necessario impostare correttamente l'opzione source.

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

Parametri

  • opzioni

    MountOptions

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 96 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

notify()

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

Notifiche alle modifiche nella directory controllata all'indirizzo observedPath in modalità recursive. Se il file system viene montato con supportsNotifyTag, è necessario fornire tag e tutte le modifiche dall'ultima notifica vengono sempre segnalate, anche se il sistema è stato arrestato. L'ultimo tag può essere ottenuto con getAll.

Per utilizzarla, l'opzione del file manifest file_system_provider.notify deve essere impostata su true.

Il valore tag può essere qualsiasi stringa univoca per chiamata, in modo che sia possibile identificare l'ultima notifica registrata. Ad es. Se l'estensione che fornisce l'estensione inizia dopo un riavvio e il tag dell'ultima notifica registrata è uguale a "123", deve chiamare notify per tutte le modifiche apportate dopo la modifica contrassegnata con "123". Non può essere una stringa vuota.

Non tutti i provider sono in grado di fornire un tag, ma se il file system ha un log delle modifiche, il tag può essere, ad es. 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 queste vengono controllate, l'API deve ricevere una notifica al riguardo. Inoltre, se una directory viene rinominata, tutte le voci discendenti vengono di fatto rimosse, in quanto non ci sono più voci nei percorsi originali.

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

Parametri

  • opzioni

    NotifyOptions

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 96 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

unmount()

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

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

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

Parametri

  • opzioni

    UnmountOptions

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 96 e versioni successive .

    Le promesse sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.

Eventi

onAbortRequested

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

Assegnato quando viene richiesta l'interruzione di un'operazione con operationRequestId. L'operazione eseguita con operationRequestId deve essere immediatamente arrestata e successCallback di questa richiesta di interruzione deve essere eseguita. Se l'interruzione non riesce, è 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

    • 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,
)

Aumentato quando viene richiesto l'impostazione di un nuovo strumento di controllo 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

onCloseFileRequested

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

Sollevato all'apertura di un file aperto in precedenza con openRequestId viene richiesta la chiusura.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (options: CloseFileRequestedOptions, 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

onConfigureRequested

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

Sollevato quando viene richiesta una finestra di dialogo di configurazione per fileSystemId. Se viene gestita, l'opzione manfiest 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

    • 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,
)

Aumentato 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

    • 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,
)

Viene richiesto durante la creazione di una directory. Se la directory di destinazione esiste già, l'operazione non deve riuscire e verrà restituito l'errore EXISTS. Se recursive è true, è necessario creare tutte le directory mancanti nel percorso della directory.

Parametri

onCreateFileRequested

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

Aumentato durante 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

onDeleteEntryRequested

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

Aumentato quando viene richiesta l'eliminazione di una voce. Se recursive è true e la voce è una directory, anche tutte le voci all'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,
)

Aumentato quando si esegue un'azione per un insieme di file o directory. 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,
)

Aumentato quando viene richiesto un elenco di azioni per un insieme di file o directory all'indirizzo entryPaths. Tutte le azioni restituite devono essere applicabili a ciascuna voce. Se non sono presenti azioni di questo tipo, 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,
)

Aumentato 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,
)

Viene sollevato quando viene visualizzata una finestra di dialogo per il montaggio di un nuovo file system. Se l'estensione/l'app è un gestore di file, questo evento non deve essere gestito. È invece necessario gestire app.runtime.onLaunched per montare nuovi file system quando viene aperto 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,
)

Aumentato quando viene richiesta lo spostamento 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: MoveEntryRequestedOptions, 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

onOpenFileRequested

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

Aumentato quando viene richiesta l'apertura di un file all'indirizzo 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,
)

Aumentato quando vengono richiesti i contenuti di una directory all'indirizzo directoryPath. I risultati devono essere restituiti in blocchi richiamando successCallback più volte. In caso di errore, è necessario chiamare errorCallback.

Parametri

onReadFileRequested

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

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

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • successCallback

      funzione

      Il parametro successCallback ha il seguente aspetto: 

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

      • dati

        ArrayBuffer

      • hasMore

        booleano

    • 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 l'osservatore 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 di troncare 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

    • 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 quando viene richiesto lo smontaggio del file system con l'identificatore fileSystemId. Nella risposta, il metodo API unmount deve essere chiamato insieme a successCallback. Se lo smontaggio non è possibile (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

    • 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,
)

Vengono sollevati durante 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

    • successCallback

      funzione

      Il parametro successCallback ha il seguente aspetto: 

      () => void

    • errorCallback

      funzione

      Il parametro errorCallback ha il seguente aspetto: 

      (error: ProviderError) => void