Descrizione
Utilizza l'API chrome.fileSystemProvider
per creare file system accessibili dal gestore di file su ChromeOS.
Autorizzazioni
fileSystemProvider
Disponibilità
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 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
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
Il tipo di modifica apportata alla voce.
-
cloudFileInfo
Facoltativo CloudFileInfo
Chrome 125 e versioni successiveInformazioni 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
Proprietà
-
versionTag
stringa facoltativo
Un tag che rappresenta la versione del file.
CloudIdentifier
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
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
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
Chrome 125 e versioni successiveInformazioni 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 successiveRappresentazione 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
Proprietà
-
actionId
stringa
L'identificatore dell'azione da eseguire.
-
entryPaths
stringa[]
Chrome 47 e versioni successiveL'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
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 successiveIndica se il file system supporta il campo
tag
per l'osservazione delle directory. -
spettatoriChrome 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
Proprietà
-
entryPaths
stringa[]
Chrome 47 e versioni successiveElenco 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
Chrome 125 e versioni successiveImposta su
true
se viene richiesto il valore dicloudFileInfo
. -
cloudIdentifier
boolean
Chrome 117 e versioni successiveImposta su
true
se viene richiesto il valore dicloudIdentifier
. -
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 successiveImposta su
true
se viene richiesto il valore diis_directory
. -
mimeType
boolean
Chrome 49 e versioni successiveImposta su
true
se viene richiesto il valore dimimeType
. -
modificationTime
boolean
Chrome 49 e versioni successiveImposta su
true
se viene richiesto il valore dimodificationTime
. -
nome
boolean
Chrome 49 e versioni successiveImposta su
true
se viene richiesto il valore diname
. -
requestId
numero
L'identificatore univoco di questa richiesta.
-
dimensioni
boolean
Chrome 49 e versioni successiveImposta su
true
se viene richiesto il valore disize
. -
thumbnail
boolean
Imposta su
true
se viene richiesto il valore dithumbnail
.
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 successiveIndica se il framework deve riprendere il file system alla successiva sessione di accesso. True per impostazione predefinita.
-
supportsNotifyTag
booleano facoltativo
Chrome 45 e versioni successiveIndica 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
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à
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à
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 successiveImposta su
true
se viene richiesto il valore diis_directory
. -
mimeType
boolean
Chrome 49 e versioni successiveImposta su
true
se viene richiesto il valore dimimeType
. -
modificationTime
boolean
Chrome 49 e versioni successiveImposta su
true
se viene richiesto il valore dimodificationTime
. -
nome
boolean
Chrome 49 e versioni successiveImposta su
true
se viene richiesto il valore diname
. -
requestId
numero
L'identificatore univoco di questa richiesta.
-
dimensioni
boolean
Chrome 49 e versioni successiveImposta su
true
se viene richiesto il valore disize
. -
thumbnail
boolean
Chrome 49 e versioni successiveImposta su
true
se viene richiesto il valore dithumbnail
.
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à
-
dati
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()
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
-
fileSystem
-
Ritorni
-
Promise<FileSystemInfo>
Chrome 96 e versioni successiveLe 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()
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
-
fileSystems
-
Ritorni
-
Promise<FileSystemInfo[]>
Chrome 96 e versioni successiveLe 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()
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.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 96 e versioni successiveLe 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()
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.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 96 e versioni successiveLe 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()
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.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 96 e versioni successiveLe 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.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:() => void
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
onAddWatcherRequested
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.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:() => void
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
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.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:() => void
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
onConfigureRequested
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.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:() => void
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
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.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:() => void
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
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
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(options: CreateDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void
-
opzioni del modello.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:() => void
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
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.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:() => void
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
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
-
opzioni del modello.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:() => void
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
onExecuteActionRequested
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
-
opzioni del modello.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:() => void
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
onGetActionsRequested
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
-
opzioni del modello.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:(actions: Action[]) => void
-
di correzione
Azione[]
-
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
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
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(options: GetMetadataRequestedOptions, successCallback: function, errorCallback: function) => void
-
opzioni del modello.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:(metadata: EntryMetadata) => void
-
metadati
-
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
onMountRequested
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
-
errore
-
-
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.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:() => void
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
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
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(options: OpenFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
opzioni del modello.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:(metadata?: EntryMetadata) => void
-
metadati
EntryMetadata facoltativo
-
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
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
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(options: ReadDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void
-
opzioni del modello.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:(entries: EntryMetadata[], hasMore: boolean) => void
-
entries
-
hasMore
boolean
-
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
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.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:(data: ArrayBuffer, hasMore: boolean) => void
-
dati
ArrayBuffer
-
hasMore
boolean
-
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
onRemoveWatcherRequested
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
-
opzioni del modello.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:() => void
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
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.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:() => void
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
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.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:() => void
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-
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.
-
successCallback
funzione
Il parametro
successCallback
ha il seguente aspetto:() => void
-
errorCallback
funzione
Il parametro
errorCallback
ha il seguente aspetto:(error: ProviderError) => void
-
errore
-
-