chrome.fileSystemProvider

Descrizione

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

Autorizzazioni

fileSystemProvider

Disponibilità

Solo ChromeOS

Manifest

Per utilizzare l'API File System Provider, devi dichiarare l'autorizzazione e la sezione "fileSystemProvider" 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
Se la configurazione tramite onConfigureRequested è supportata. Per impostazione predefinita: false.
multiple_mounts (booleano) - facoltativo
Se sono supportati più file system montati. Per impostazione predefinita: false.
watchable (booleano) - facoltativo
Se è supportata l'impostazione di osservatori e la notifica delle modifiche. Per impostazione predefinita: false.
source (enumerazione di "file", "device" o "network") - obbligatorio
Origine dei dati per i file system montati.

L'app File utilizza le informazioni riportate sopra per visualizzare correttamente gli elementi UI correlati. Ad esempio, se configurable è impostato su true, verrà visualizzata una voce di menu per la configurazione dei volumi. Allo stesso modo, se multiple_mounts è impostato su true, l'app File consentirà di aggiungere più di un punto di montaggio dalla UI. Se watchable è false, verrà visualizzato un pulsante di aggiornamento. Tieni presente che, se possibile, devi aggiungere il supporto per i watcher, in modo che le modifiche al file system possano essere riflesse 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. 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 possono fornire i contenuti del file system da un'origine 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 fornitore deve essere un'app pacchettizzata, 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 solo per le app pacchettizzate.
"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 per impostare le credenziali corrette. La gestione di questo evento è facoltativa.

Ciclo di vita

I file system forniti, una volta montati, vengono memorizzati da Chrome e rimontati automaticamente dopo il riavvio. Pertanto, una volta che un file system viene montato da un'estensione di fornitura, rimarrà tale finché l'estensione non viene scaricata o chiama il metodo unmount.

Tipi

AbortRequestedOptions

Proprietà

  • fileSystemId

    stringa

    L'identificatore del file system correlato a questa operazione.

  • operationRequestId

    numero

    Un ID della richiesta da interrompere.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

Action

Chrome 45+

Proprietà

  • id

    stringa

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

  • titolo

    stringa facoltativa

    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 correlato a questa operazione.

  • ricorsivo

    booleano

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

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

Change

Proprietà

  • changeType

    ChangeType

    Il tipo di modifica apportata alla voce.

  • cloudFileInfo

    CloudFileInfo facoltativo

    Chrome 125+

    Informazioni relative al file se supportato da un file system cloud.

  • entryPath

    stringa

    Il percorso della voce modificata.

ChangeType

Tipo di modifica rilevata nella directory osservata.

Enum

"CHANGED"

"DELETED"

CloseFileRequestedOptions

Proprietà

  • fileSystemId

    stringa

    L'identificatore del file system correlato a questa operazione.

  • openRequestId

    numero

    Un ID richiesta utilizzato per aprire il file.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

CloudFileInfo

Chrome 125+

Proprietà

  • versionTag

    stringa facoltativa

    Un tag che rappresenta la versione del file.

CloudIdentifier

Chrome 117+

Proprietà

  • id

    stringa

    L'identificatore del fornitore per il file/la directory specificato.

  • providerName

    stringa

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

CommonActionId

Chrome 45+

Elenco delle azioni comuni. "SHARE" serve per condividere file con altre persone. "SAVE_FOR_OFFLINE" per il blocco (salvataggio per l'accesso offline). "OFFLINE_NOT_NECESSARY" per indicare che il file non deve più essere archiviato per l'accesso offline. Utilizzato da onGetActionsRequested e onExecuteActionRequested.

Enum

"SAVE_FOR_OFFLINE"

"OFFLINE_NOT_NECESSARY"

"CONDIVIDI"

ConfigureRequestedOptions

Chrome 44+

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 correlato 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 correlato a questa operazione.

  • ricorsivo

    booleano

    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 correlato 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 correlato a questa operazione.

  • ricorsivo

    booleano

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

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

EntryMetadata

Proprietà

  • cloudFileInfo

    CloudFileInfo facoltativo

    Chrome 125+

    Informazioni che identificano un file specifico nel file system cloud sottostante. Deve essere fornito se richiesto in options e il file è supportato da Cloud Storage.

  • cloudIdentifier

    CloudIdentifier facoltativo

    Chrome 117+

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

  • isDirectory

    booleano facoltativo

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

  • mimeType

    stringa facoltativa

    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 facoltativa

    Nome di questa voce (non il nome del percorso completo). Non deve contenere "/". Per la radice deve essere vuoto. Deve essere fornito se richiesto in options.

  • dimensioni

    number (facoltativo)

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

  • miniatura

    stringa facoltativa

    Immagine in miniatura come URI di dati in formato PNG, JPEG o WEBP, di dimensioni non superiori a 32 KB. Facoltativo, ma può essere fornito solo se richiesto esplicitamente dall'evento onGetMetadataRequested.

ExecuteActionRequestedOptions

Chrome 45+

Proprietà

  • actionId

    stringa

    L'identificatore dell'azione da eseguire.

  • entryPaths

    string[]

    Chrome 47+

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

  • fileSystemId

    stringa

    L'identificatore del file system correlato 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 possono essere aperti contemporaneamente. Se è 0, non è limitato.

  • supportsNotifyTag

    booleano facoltativo

    Chrome 45+

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

  • spettatori

    Watcher[]

    Chrome 45+

    Elenco degli utenti che seguono il canale.

  • scrivibile

    booleano

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

GetActionsRequestedOptions

Chrome 45+

Proprietà

  • entryPaths

    string[]

    Chrome 47+

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

  • fileSystemId

    stringa

    L'identificatore del file system correlato a questa operazione.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

GetMetadataRequestedOptions

Proprietà

  • cloudFileInfo

    booleano

    Chrome 125+

    Impostato su true se viene richiesto il valore cloudFileInfo.

  • cloudIdentifier

    booleano

    Chrome 117+

    Impostato 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 correlato a questa operazione.

  • isDirectory

    booleano

    Chrome 49+

    Impostato su true se viene richiesto il valore is_directory.

  • mimeType

    booleano

    Chrome 49+

    Impostato su true se viene richiesto il valore mimeType.

  • modificationTime

    booleano

    Chrome 49+

    Impostato su true se viene richiesto il valore modificationTime.

  • nome

    booleano

    Chrome 49+

    Impostato su true se viene richiesto il valore name.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

  • dimensioni

    booleano

    Chrome 49+

    Impostato su true se viene richiesto il valore size.

  • miniatura

    booleano

    Impostato su true se viene richiesto il valore thumbnail.

MountOptions

Proprietà

  • displayName

    stringa

    Un nome leggibile per il file system.

  • fileSystemId

    stringa

    La stringa identificatore del file system. Deve essere univoco per ogni estensione.

  • openedFilesLimit

    number (facoltativo)

    Il numero massimo di file che possono essere aperti contemporaneamente. Se non specificato o 0, non è limitato.

  • persistente

    booleano facoltativo

    Chrome 64+

    Indica se il framework deve ripristinare il file system alla successiva sessione di accesso. Il valore predefinito è true.

  • supportsNotifyTag

    booleano facoltativo

    Chrome 45+

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

  • scrivibile

    booleano facoltativo

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

MoveEntryRequestedOptions

Proprietà

  • fileSystemId

    stringa

    L'identificatore del file system correlato 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 di modifica apportata alla voce osservata. Se è ELIMINATO, la voce osservata verrà rimossa automaticamente dall'elenco delle voci osservate.

  • modifiche

    Change[] optional

    Elenco delle modifiche alle voci all'interno della directory osservata (inclusa 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 facoltativa

    Tag per 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 apportate 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 da utilizzare per le richieste consecutive di lettura/scrittura e chiusura.

OpenFileMode

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

Enum

"READ"

"WRITE"

OpenFileRequestedOptions

Proprietà

  • filePath

    stringa

    Il percorso del file da aprire.

  • fileSystemId

    stringa

    L'identificatore del file system correlato 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 dalle richieste di lettura/scrittura e chiusura consecutive.

ProviderError

Codici di errore utilizzati per fornire estensioni in risposta alle richieste, nonché in caso di errori durante la chiamata ai metodi dell'API. Per ottenere risultati ottimali, devi utilizzare "OK".

Enum

"Ok"

"FAILED"

"IN_USE"

"EXISTS"

"NOT_FOUND"

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"INVALID_OPERATION"

"SECURITY"

"INTERROMPI"

"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 correlato a questa operazione.

  • isDirectory

    booleano

    Chrome 49+

    Impostato su true se viene richiesto il valore is_directory.

  • mimeType

    booleano

    Chrome 49+

    Impostato su true se viene richiesto il valore mimeType.

  • modificationTime

    booleano

    Chrome 49+

    Impostato su true se viene richiesto il valore modificationTime.

  • nome

    booleano

    Chrome 49+

    Impostato su true se viene richiesto il valore name.

  • requestId

    numero

    L'identificatore univoco di questa richiesta.

  • dimensioni

    booleano

    Chrome 49+

    Impostato su true se viene richiesto il valore size.

  • miniatura

    booleano

    Chrome 49+

    Impostato su true se viene richiesto il valore thumbnail.

ReadFileRequestedOptions

Proprietà

  • fileSystemId

    stringa

    L'identificatore del file system correlato a questa operazione.

  • lunghezza

    numero

    Numero di byte da restituire.

  • offset

    numero

    Posizione nel 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 correlato a questa operazione.

  • ricorsivo

    booleano

    Modalità dello spettatore.

  • 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 correlato a questa operazione.

  • lunghezza

    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 facoltativa

    Tag utilizzato dall'ultima notifica per l'osservatore.

  • ricorsivo

    booleano

    Indica se la visualizzazione deve includere tutte le voci secondarie in modo ricorsivo. Può essere true solo per le directory.

WriteFileRequestedOptions

Proprietà

  • dati

    ArrayBuffer

    Buffer di byte da scrivere nel file.

  • fileSystemId

    stringa

    L'identificatore del file system correlato a questa operazione.

  • offset

    numero

    Posizione 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 di questa richiesta.

Metodi

get()

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

Restituisce informazioni su un file system con il fileSystemId passato.

Parametri

  • fileSystemId

    stringa

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (fileSystem: FileSystemInfo) => void

Resi

  • Promise<FileSystemInfo>

    Chrome 96+

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

getAll()

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

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+

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

mount()

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

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

A seconda del tipo di file system da montare, l'opzione source deve essere impostata in modo appropriato.

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

  • Promise<void>

    Chrome 96+

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

notify()

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

Notifica le modifiche nella directory monitorata alle ore observedPath in modalità recursive. Se il file system è 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 l'utilizzo, l'opzione 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 di fornitura viene avviata 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 come "123". Non può essere una stringa vuota.

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

Tieni presente che se viene rimossa una directory principale, vengono rimossi anche tutti i relativi elementi secondari e, se vengono monitorati, l'API deve essere informata del fatto. Inoltre, se una directory viene rinominata, tutte le voci discendenti vengono effettivamente rimosse, in quanto non sono più presenti voci nei percorsi originali.

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

Parametri

  • opzioni

    NotifyOptions

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96+

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

unmount()

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

Smonta un file system con il fileSystemId specificato. Deve essere chiamato dopo l'invocazione di onUnmountRequested. Inoltre, l'estensione di fornitura può decidere di eseguire lo smontaggio se non richiesto (ad esempio in caso di perdita di connessione o di 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

  • Promise<void>

    Chrome 96+

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

Eventi

onAbortRequested

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

Generato quando viene richiesto l'interruzione di un'operazione con operationRequestId. L'operazione eseguita con operationRequestId deve essere interrotta immediatamente e deve essere eseguita successCallback di questa richiesta di interruzione. Se l'interruzione non va a buon fine, deve essere chiamato errorCallback. Tieni presente che i callback dell'operazione interrotta non devono essere chiamati, in quanto verranno ignorati. Nonostante la chiamata a 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+ 
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

Generato quando viene richiesta l'impostazione di un nuovo watcher di directory. Se si verifica un errore, deve essere chiamato 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,
)

Generato quando viene richiesta la chiusura di un file precedentemente aperto con openRequestId.

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+ 
chrome.fileSystemProvider.onConfigureRequested.addListener(
  callback: function,
)

Generato quando viene richiesta la visualizzazione di una finestra di dialogo di configurazione per fileSystemId. Se viene gestito, l'opzione del manifest 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,
)

Generato quando viene richiesta la copia di una voce (in modo ricorsivo se si tratta di una directory). Se si verifica un errore, deve essere chiamato 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,
)

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

Parametri

onCreateFileRequested

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

Generato quando viene richiesta la creazione di un file. Se il file esiste già, errorCallback deve essere chiamato 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,
)

Generato 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+ 
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
  callback: function,
)

Generato quando viene richiesta l'esecuzione di un'azione per un insieme di file o directory. Al termine dell'azione, deve essere chiamato 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+ 
chrome.fileSystemProvider.onGetActionsRequested.addListener(
  callback: function,
)

Generato quando viene richiesta una lista di azioni per un insieme di file o directory in entryPaths. Tutte le azioni restituite devono essere applicabili a ogni 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, deve essere chiamato 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,
)

Generato quando vengono richiesti i metadati di un file o di una directory in entryPath. I metadati devono essere restituiti con la chiamata successCallback. In caso di errore, deve essere chiamato errorCallback.

Parametri

onMountRequested

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

Generato quando viene richiesta la visualizzazione di una finestra di dialogo per il montaggio di un nuovo file system. Se l'estensione/app è un gestore di file, questo evento non deve essere gestito. Invece, app.runtime.onLaunched deve essere gestito per montare nuovi file system quando viene aperto un file. Per più supporti, l'opzione 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,
)

Generato quando viene richiesto lo spostamento di una voce (in modo ricorsivo se si tratta di una directory). Se si verifica un errore, deve essere chiamato 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,
)

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

Parametri

onReadDirectoryRequested

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

Generato quando vengono richiesti i contenuti di una directory in directoryPath. I risultati devono essere restituiti in blocchi chiamando più volte successCallback. In caso di errore, deve essere chiamato errorCallback.

Parametri

onReadFileRequested

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

Generato 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, deve essere chiamato 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+ 
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
  callback: function,
)

Generato quando il watcher deve essere rimosso. Se si verifica un errore, deve essere chiamato 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,
)

Generato quando viene richiesto il troncamento di un file alla lunghezza desiderata. Se si verifica un errore, deve essere chiamato 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,
)

Generato quando viene richiesto lo smontaggio per il 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 attesa), deve essere chiamato 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,
)

Generato 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

    • successCallback

      funzione

      Il parametro successCallback ha il seguente aspetto: 

      () => void

    • errorCallback

      funzione

      Il parametro errorCallback ha il seguente aspetto: 

      (error: ProviderError) => void