Questa autorizzazione attiva un avviso
Descrizione
Utilizza l'API chrome.downloads
per avviare, monitorare, manipolare e cercare i download in modo programmatico.
Autorizzazioni
downloads
Manifest
Per utilizzare questa API, devi dichiarare l'autorizzazione "downloads"
nel manifest dell'estensione.
{
"name": "My extension",
...
"permissions": [
"downloads"
],
...
}
Esempi
Puoi trovare semplici esempi di utilizzo dell'API chrome.downloads
nella directory examples/api/downloads. Per altri esempi e per ricevere assistenza per la visualizzazione del codice sorgente, consulta la pagina Esempi.
Tipi
BooleanDelta
Proprietà
-
attuale
booleano facoltativo
-
indietro
booleano facoltativo
DangerType
file
Il nome file del download è sospetto.
url
È noto che l'URL del download è dannoso.
content
Il file scaricato è noto per essere dannoso.
non comune
L'URL del download non viene scaricato comunemente e potrebbe essere pericoloso.
organizzatore
Il download proveniva da un host noto per distribuire file binari dannosi ed è probabilmente pericoloso.
indesiderato
Il download è potenzialmente indesiderato o non sicuro. ad esempio potrebbero apportare modifiche alle impostazioni del browser o del computer.
sicuro
Il download non presenta alcun pericolo noto per il computer dell'utente.
accettata
L'utente ha accettato il download pericoloso.
Enum
"file"
"url"
"host"
"asyncScanning"
"asyncLocalPasswordScanning"
"passwordProtected"
"sensitiveContentBlock"
"promptForScanning"
"promptForLocalPasswordScanning"
DoubleDelta
Proprietà
-
attuale
numero facoltativo
-
indietro
numero facoltativo
DownloadDelta
Proprietà
-
canResume
BooleanDelta facoltativo
La modifica in
canResume
, se presente. -
pericolo
StringDelta facoltativo
La modifica in
danger
, se presente. -
endTime
StringDelta facoltativo
La modifica in
endTime
, se presente. -
errore
StringDelta facoltativo
La modifica in
error
, se presente. -
esiste
BooleanDelta facoltativo
La modifica in
exists
, se presente. -
fileSize
DoubleDelta facoltativo
La modifica in
fileSize
, se presente. -
filename
StringDelta facoltativo
La modifica in
filename
, se presente. -
finalUrl
StringDelta facoltativo
Chrome 54 e versioni successiveLa modifica in
finalUrl
, se presente. -
id
numero
Valore
id
diDownloadItem
modificato. -
mimo
StringDelta facoltativo
La modifica in
mime
, se presente. -
in pausa
BooleanDelta facoltativo
La modifica in
paused
, se presente. -
startTime
StringDelta facoltativo
La modifica in
startTime
, se presente. -
state
StringDelta facoltativo
La modifica in
state
, se presente. -
totalBytes
DoubleDelta facoltativo
La modifica in
totalBytes
, se presente. -
url
StringDelta facoltativo
La modifica in
url
, se presente.
DownloadItem
Proprietà
-
byExtensionId
stringa facoltativo
L'identificatore dell'estensione che ha avviato il download se il download è stato avviato da un'estensione. Una volta impostata, non cambia.
-
byExtensionName
stringa facoltativo
Il nome localizzato dell'estensione che ha avviato il download se questo download è stato avviato da un'estensione. Può cambiare se l'estensione cambia il nome o se l'utente cambia le impostazioni internazionali.
-
bytesReceived
numero
Numero di byte ricevuti finora dall'host, senza considerare la compressione dei file.
-
canResume
boolean
True se il download è in corso e in pausa oppure se è stato interrotto e può essere ripreso dal punto in cui era stato interrotto.
-
pericolo
Indica se il download è considerato sicuro o noto come sospetto.
-
endTime
stringa facoltativo
L'ora di fine del download in formato ISO 8601. Può essere passato direttamente al costruttore della data:
chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.endTime) console.log(new Date(item.endTime))})})
-
errore
InterruptReason facoltativo
Il motivo dell'interruzione del download. Diversi tipi di errori HTTP possono essere raggruppati in uno degli errori che iniziano con
SERVER_
. Gli errori relativi alla rete iniziano conNETWORK_
, gli errori relativi alla procedura di scrittura del file nel file system iniziano conFILE_
e le interruzioni avviate dall'utente iniziano conUSER_
. -
estimatedEndTime
stringa facoltativo
Tempo stimato per il completamento del download in formato ISO 8601. Può essere passato direttamente al costruttore della data:
chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.estimatedEndTime) console.log(new Date(item.estimatedEndTime))})})
-
esiste
boolean
Se il file scaricato esiste ancora. Queste informazioni potrebbero non essere aggiornate perché Chrome non controlla automaticamente la rimozione dei file. Chiama
search
() per attivare il controllo dell'esistenza del file. Al termine del controllo dell'esistenza, se il file è stato eliminato, viene attivato un eventoonChanged
. Tieni presente chesearch
() non attende il completamento del controllo dell'esistenza prima di tornare, quindi i risultati disearch
() potrebbero non riflettere accuratamente il file system. Inoltre, la funzionesearch
() può essere chiamata tutte le volte che è necessario, ma non verifica l'esistenza del file più spesso di una volta ogni 10 secondi. -
fileSize
numero
Numero di byte nell'intero file dopo la decompressione o -1 se sconosciuto.
-
filename
stringa
Percorso locale assoluto.
-
finalUrl
stringa
Chrome 54 e versioni successiveL'URL assoluto da cui viene eseguito questo download, dopo tutti i reindirizzamenti.
-
id
numero
Un identificatore persistente tra le sessioni del browser.
-
in incognito
boolean
Falso se il download viene registrato nella cronologia, vero se non viene registrato.
-
mimo
stringa
Il tipo MIME del file.
-
in pausa
boolean
True se il download ha interrotto la lettura dei dati dall'host, ma ha mantenuto aperta la connessione.
-
referrer
stringa
URL assoluto.
-
startTime
stringa
L'ora in cui è iniziato il download in formato ISO 8601. Può essere passato direttamente al costruttore della data:
chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})})
-
state
Indica se il download è in corso, interrotto o completato.
-
totalBytes
numero
Numero di byte nell'intero file, senza considerare la compressione o -1 se sconosciuto.
-
url
stringa
L'URL assoluto da cui è stato avviato il download prima di qualsiasi reindirizzamento.
DownloadOptions
Proprietà
-
body
stringa facoltativo
Corpo del post.
-
conflictAction
FilenameConflictAction facoltativo
L'azione da eseguire se
filename
esiste già. -
filename
stringa facoltativo
Un percorso file relativo alla directory Download per contenere il file scaricato, possibilmente contenente sottodirectory. I percorsi assoluti, quelli vuoti e quelli contenenti riferimenti a ritroso ".." causano un errore.
onDeterminingFilename
consente di suggerire un nome file dopo aver determinato il tipo MIME del file e un nome file provvisorio. -
headers
HeaderNameValuePair[] facoltativo
Intestazioni HTTP aggiuntive da inviare con la richiesta se l'URL utilizza il protocollo HTTP[s]. Ogni intestazione è rappresentata come un dizionario contenente le chiavi
name
evalue
obinaryValue
, limitate a quelle consentite da XMLHttpRequest. -
method
HttpMethod facoltativo
Il metodo HTTP da utilizzare se l'URL utilizza il protocollo HTTP[S].
-
saveAs
booleano facoltativo
Utilizza un selettore file per consentire all'utente di selezionare un nome file indipendentemente dal fatto che
filename
sia impostato o già esistente. -
url
stringa
L'URL da scaricare.
DownloadQuery
Proprietà
-
bytesReceived
numero facoltativo
Numero di byte ricevuti finora dall'host, senza considerare la compressione dei file.
-
pericolo
DangerType facoltativo
Indica se il download è considerato sicuro o noto come sospetto.
-
endTime
stringa facoltativo
L'ora di fine del download in formato ISO 8601.
-
endedAfter
stringa facoltativo
Limita i risultati a
DownloadItem
terminati dopo il ms specificato in formato ISO 8601 -
endedBefore
stringa facoltativo
Limita i risultati a
DownloadItem
terminati prima del ms specificato in formato ISO 8601. -
errore
InterruptReason facoltativo
Perché un download è stato interrotto.
-
esiste
booleano facoltativo
Se il file scaricato esiste.
-
fileSize
numero facoltativo
Numero di byte nell'intero file dopo la decompressione o -1 se sconosciuto.
-
filename
stringa facoltativo
Percorso locale assoluto.
-
filenameRegex
stringa facoltativo
Limita i risultati a
DownloadItem
il cuifilename
corrisponde all'espressione regolare specificata. -
finalUrl
stringa facoltativo
Chrome 54 e versioni successiveL'URL assoluto da cui viene eseguito questo download, dopo tutti i reindirizzamenti.
-
finalUrlRegex
stringa facoltativo
Chrome 54 e versioni successiveLimita i risultati a
DownloadItem
il cuifinalUrl
corrisponde all'espressione regolare specificata. -
id
numero facoltativo
Il
id
diDownloadItem
su cui eseguire la query. -
limite
numero facoltativo
Il numero massimo di
DownloadItem
corrispondenti restituiti. Il valore predefinito è 1000. Impostalo su 0 per restituire tutti gli elementiDownloadItem
corrispondenti. Per informazioni su come sfogliare i risultati, visita la paginasearch
. -
mimo
stringa facoltativo
Il tipo MIME del file.
-
orderBy
string[] facoltativo
Imposta gli elementi di questo array sulle proprietà
DownloadItem
per ordinare i risultati di ricerca. Ad esempio, se impostiorderBy=['startTime']
, i campiDownloadItem
vengono ordinati in base all'ora di inizio in ordine crescente. Per specificare l'ordine decrescente, fai precedere da un trattino: "-startTime". -
in pausa
booleano facoltativo
True se il download ha interrotto la lettura dei dati dall'host, ma ha mantenuto aperta la connessione.
-
query
string[] facoltativo
Questo array di termini di ricerca limita i risultati a
DownloadItem
i cuifilename
,url
ofinalUrl
contengono tutti i termini di ricerca che non iniziano con un trattino "-" e nessuno di quelli che iniziano con un trattino. -
startTime
stringa facoltativo
L'ora in cui è iniziato il download in formato ISO 8601.
-
startedAfter
stringa facoltativo
Limita i risultati a
DownloadItem
che sono iniziati dopo il ms specificato in formato ISO 8601. -
startedBefore
stringa facoltativo
Limita i risultati a
DownloadItem
che sono iniziati prima del ms specificato in formato ISO 8601. -
state
Stato facoltativo
Indica se il download è in corso, interrotto o completato.
-
totalBytes
numero facoltativo
Numero di byte nell'intero file, senza considerare la compressione o -1 se sconosciuto.
-
totalBytesGreater
numero facoltativo
Limita i risultati a
DownloadItem
il cuitotalBytes
è maggiore del numero intero specificato. -
totalBytesLess
numero facoltativo
Limita i risultati a
DownloadItem
il cuitotalBytes
è inferiore al numero intero specificato. -
url
stringa facoltativo
L'URL assoluto da cui è stato avviato il download prima di qualsiasi reindirizzamento.
-
urlRegex
stringa facoltativo
Limita i risultati a
DownloadItem
il cuiurl
corrisponde all'espressione regolare specificata.
FilenameConflictAction
uniformare
Per evitare duplicati, filename
viene modificato in modo da includere un contatore prima dell'estensione del nome file.
Sovrascrittura
Il file esistente verrà sovrascritto con il nuovo file.
richiesta
All'utente verrà visualizzata una finestra di dialogo di selezione file.
Enum
"uniquify"
"prompt"
FilenameSuggestion
Proprietà
-
conflictAction
FilenameConflictAction facoltativo
L'azione da eseguire se
filename
esiste già. -
filename
stringa
La nuova destinazione
DownloadItem.filename
dell'DownloadItem
, come percorso relativo alla directory Download predefinita dell'utente, che potrebbe contenere sottodirectory. I percorsi assoluti, quelli vuoti e quelli contenenti riferimenti a ritroso ".." verranno ignorati.filename
viene ignorato se esistono listeneronDeterminingFilename
registrati da qualsiasi estensione.
GetFileIconOptions
Proprietà
-
dimensioni
facoltativo
Le dimensioni dell'icona restituita. L'icona sarà quadrata e avrà dimensioni x pixel. La dimensione predefinita e la più grande dell'icona è 32 x 32 pixel. Le uniche dimensioni supportate sono 16 e 32. Specificare qualsiasi altra dimensione è un errore.
HeaderNameValuePair
Proprietà
-
nome
stringa
Nome dell'intestazione HTTP.
-
valore
stringa
Valore dell'intestazione HTTP.
HttpMethod
Enum
InterruptReason
Enum
"FILE_FAILED"
"FILE_ACCESS_DENIED"
"FILE_NO_SPACE"
"FILE_TOO_LARGE"
"FILE_VIRUS_INFECTED"
"FILE_TRANSIENT_ERROR"
"FILE_BLOCKED"
"FILE_SECURITY_CHECK_FAILED"
"FILE_TOO_SHORT"
"FILE_HASH_MISMATCH"
"FILE_SAME_AS_SOURCE"
"NETWORK_FAILED"
"NETWORK_TIMEOUT"
"NETWORK_DISCONNECTED"
"NETWORK_SERVER_DOWN"
"NETWORK_INVALID_REQUEST"
"SERVER_FAILED"
"SERVER_NO_RANGE"
"SERVER_BAD_CONTENT"
"SERVER_UNAUTHORIZED"
"SERVER_CERT_PROBLEM"
"SERVER_UNREACHABLE"
"SERVER_CONTENT_LENGTH_MISMATCH"
"SERVER_CROSS_ORIGIN_REDIRECT"
"USER_CANCELED"
"USER_SHUTDOWN"
State
in_progress
Il download sta ricevendo dati dal server.
interrotta
Un errore ha interrotto la connessione con l'host dei file.
completata/e
Download completato.
Enum
StringDelta
Proprietà
-
attuale
stringa facoltativo
-
indietro
stringa facoltativo
UiOptions
Proprietà
-
abilitata
boolean
Attiva o disattiva l'interfaccia utente di download.
Metodi
acceptDanger()
chrome.downloads.acceptDanger(
downloadId: number,
callback?: function,
)
Chiedi all'utente di accettare un download pericoloso. Può essere chiamato solo da un contesto visibile (scheda, finestra o popup di azione pagina/browser). Non accetta automaticamente download pericolosi. Se il download viene accettato, viene attivato un evento onChanged
, altrimenti non succede nulla. Quando tutti i dati vengono recuperati in un file temporaneo e il download non è pericoloso o il pericolo è stato accettato, il file temporaneo viene rinominato con il nome file di destinazione, state
diventa "completato" e onChanged
si attiva.
Parametri
-
downloadId
numero
L'identificatore di
DownloadItem
. -
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
cancel()
chrome.downloads.cancel(
downloadId: number,
callback?: function,
)
Annulla un download. Quando callback
viene eseguito, il download viene annullato, completato, interrotto o non esiste più.
Parametri
-
downloadId
numero
L'ID del download da annullare.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
download()
chrome.downloads.download(
options: DownloadOptions,
callback?: function,
)
Scaricare un URL. Se l'URL utilizza il protocollo HTTP[S], la richiesta includerà tutti i cookie attualmente impostati per il suo nome host. Se filename
e saveAs
sono specificati entrambi, viene visualizzata la finestra di dialogo Salva con nome, precompilata con il valore filename
specificato. Se il download è stato avviato correttamente, callback
verrà chiamato con il nuovo downloadId
di DownloadItem
. Se si è verificato un errore durante l'avvio del download, callback
verrà chiamato con downloadId=undefined
e runtime.lastError
conterrà una stringa descrittiva. Non è garantito che le stringhe di errore rimangano compatibili con le versioni precedenti tra le release. Le estensioni non devono analizzarlo.
Parametri
-
opzioni del modello.
Che cosa scaricare e come.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(downloadId: number) => void
-
downloadId
numero
-
Ritorni
-
Promessa<numero>
Chrome 96 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
erase()
chrome.downloads.erase(
query: DownloadQuery,
callback?: function,
)
Cancella i contenuti di DownloadItem
corrispondenti dalla cronologia senza eliminare il file scaricato. Verrà attivato un evento onErased
per ogni DownloadItem
corrispondente a query
, dopodiché verrà chiamato callback
.
Parametri
-
query
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(erasedIds: number[]) => void
-
erasedIds
numero[]
-
Ritorni
-
Promessa<number[]>
Chrome 96 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
getFileIcon()
chrome.downloads.getFileIcon(
downloadId: number,
options?: GetFileIconOptions,
callback?: function,
)
Recupera un'icona per il download specificato. Per i nuovi download, le icone dei file sono disponibili dopo la ricezione dell'evento onCreated
. L'immagine restituita da questa funzione mentre è in corso un download potrebbe essere diversa dall'immagine restituita al termine del download. Il recupero delle icone avviene eseguendo una query sul sistema operativo o sul toolkit sottostante, a seconda della piattaforma. Pertanto, l'icona restituita dipenderà da una serie di fattori, tra cui lo stato del download, la piattaforma, i tipi di file registrati e il tema visivo. Se non è possibile individuare l'icona di un file, runtime.lastError
conterrà un messaggio di errore.
Parametri
-
downloadId
numero
L'identificatore del download.
-
opzioni del modello.
GetFileIconOptions facoltativo
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(iconURL?: string) => void
-
iconURL
stringa facoltativo
-
Ritorni
-
Promise<string | undefined>
Chrome 96 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
open()
chrome.downloads.open(
downloadId: number,
callback?: function,
)
Apre ora il file scaricato se la proprietà DownloadItem
è completa; in caso contrario, restituisce un errore tramite runtime.lastError
. Questo metodo richiede l'autorizzazione "downloads.open"
oltre all'autorizzazione "downloads"
. Un evento onChanged
viene attivato quando l'elemento viene aperto per la prima volta. Questo metodo può essere chiamato solo in risposta a un gesto dell'utente.
Parametri
-
downloadId
numero
L'identificatore del file scaricato.
-
callback
funzione facoltativa
Chrome 123 e versioni successiveIl parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 123 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
pause()
chrome.downloads.pause(
downloadId: number,
callback?: function,
)
Sospendi il download. Se la richiesta ha esito positivo, il download è in pausa. In caso contrario, runtime.lastError
contiene un messaggio di errore. La richiesta avrà esito negativo se il download non è attivo.
Parametri
-
downloadId
numero
L'ID del download da mettere in pausa.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
removeFile()
chrome.downloads.removeFile(
downloadId: number,
callback?: function,
)
Rimuovi il file scaricato se esiste e la DownloadItem
è completa; in caso contrario, restituisci un errore tramite runtime.lastError
.
Parametri
-
downloadId
numero
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
resume()
chrome.downloads.resume(
downloadId: number,
callback?: function,
)
Riprendere un download messo in pausa. Se la richiesta ha esito positivo, il download è in corso e riattivato. In caso contrario, runtime.lastError
contiene un messaggio di errore. La richiesta avrà esito negativo se il download non è attivo.
Parametri
-
downloadId
numero
L'ID del download da riprendere.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Chrome 96 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
search()
chrome.downloads.search(
query: DownloadQuery,
callback?: function,
)
Trova DownloadItem
. Imposta query
sull'oggetto vuoto per ottenere tutti i DownloadItem
. Per ottenere una DownloadItem
specifica, imposta solo il campo id
. Per sfogliare un numero elevato di elementi, imposta orderBy: ['-startTime']
, imposta limit
sul numero di elementi per pagina e imposta startedAfter
sul startTime
dell'ultimo elemento dell'ultima pagina.
Parametri
-
query
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:(results: DownloadItem[]) => void
-
risultati
-
Ritorni
-
Promise<DownloadItem[]>
Chrome 96 e versioni successiveLe promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
setShelfEnabled()
chrome.downloads.setShelfEnabled(
enabled: boolean,
)
Usa invece setUiOptions
.
Attiva o disattiva la barra grigia nella parte inferiore di ogni finestra associata al profilo del browser corrente. La barra delle app verrà disattivata finché è stata disattivata da almeno un'estensione. Se attivi lo scaffale mentre almeno un'altra estensione è disattivata, verrà restituito un errore tramite runtime.lastError
. Richiede l'autorizzazione "downloads.shelf"
oltre all'autorizzazione "downloads"
.
Parametri
-
abilitata
boolean
setUiOptions()
chrome.downloads.setUiOptions(
options: UiOptions,
callback?: function,
)
Modifica l'interfaccia utente di download di ogni finestra associata al profilo del browser corrente. Se per almeno un'estensione è stato impostato UiOptions.enabled
su false, l'interfaccia utente di download sarà nascosta. Se imposti UiOptions.enabled
su true quando almeno un'altra estensione è disattivata, verrà restituito un errore tramite runtime.lastError
. Richiede l'autorizzazione "downloads.ui"
oltre all'autorizzazione "downloads"
.
Parametri
-
opzioni del modello.
Incapsulare una modifica all'interfaccia utente di download.
-
callback
funzione facoltativa
Il parametro
callback
ha il seguente aspetto:() => void
Ritorni
-
Promise<void>
Le promesse sono supportate solo per Manifest V3 e versioni successive; altre piattaforme devono utilizzare i callback.
show()
chrome.downloads.show(
downloadId: number,
)
Mostra il file scaricato nella relativa cartella in un gestore di file.
Parametri
-
downloadId
numero
L'identificatore del file scaricato.
showDefaultFolder()
chrome.downloads.showDefaultFolder()
Mostra la cartella predefinita Download in un gestore di file.
Eventi
onChanged
chrome.downloads.onChanged.addListener(
callback: function,
)
Quando una delle proprietà di DownloadItem
ad eccezione di bytesReceived
e estimatedEndTime
cambia, questo evento viene attivato con downloadId
e un oggetto contenente le proprietà modificate.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(downloadDelta: DownloadDelta) => void
-
downloadDelta
-
onCreated
chrome.downloads.onCreated.addListener(
callback: function,
)
Questo evento viene attivato con l'oggetto DownloadItem
all'inizio di un download.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(downloadItem: DownloadItem) => void
-
downloadItem
-
onDeterminingFilename
chrome.downloads.onDeterminingFilename.addListener(
callback: function,
)
Durante il processo di determinazione del nome dei file, le estensioni avranno la possibilità di ignorare l'elemento DownloadItem.filename
di destinazione. Ogni estensione non può registrare più di un listener per questo evento. Ogni listener deve chiamare suggest
esattamente una volta, in modo sincrono o asincrono. Se il listener chiama suggest
in modo asincrono, deve restituire true
. Se il listener non chiama suggest
in modo sincrono né restituisce true
, suggest
verrà chiamato automaticamente. Il comando DownloadItem
non verrà completato finché tutti gli ascoltatori non avranno chiamato suggest
. I listener possono chiamare suggest
senza argomenti per consentire al download di utilizzare downloadItem.filename
per il nome file o passare un oggetto suggestion
a suggest
per sostituire il nome file di destinazione. Se più estensioni eseguono l'override del nome file, vince l'ultima estensione installata il cui listener passa un oggetto suggestion
a suggest
. Per evitare confusione in merito all'estensione che vincerà, gli utenti non devono installare estensioni che potrebbero essere in conflitto. Se il download viene avviato da download
e il nome file di destinazione è noto prima che il tipo MIME e il nome file provvisorio siano stati determinati, passa filename
a download
.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(downloadItem: DownloadItem, suggest: function) => void
-
downloadItem
-
suggest
funzione
Il parametro
suggest
ha il seguente aspetto:(suggestion?: FilenameSuggestion) => void
-
suggerimento
FilenameSuggestion facoltativo
-
-
onErased
chrome.downloads.onErased.addListener(
callback: function,
)
Si attiva con downloadId
quando un download viene cancellato dalla cronologia.
Parametri
-
callback
funzione
Il parametro
callback
ha il seguente aspetto:(downloadId: number) => void
-
downloadId
numero
-