chrome.downloads

refresh date: 2026-09-25 robots: noindex

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 assistenza nella visualizzazione del codice sorgente, consulta Esempi.

Tipi

BooleanDelta

Proprietà

  • attuali

    boolean facoltativo

  • indietro

    boolean facoltativo

DangerType

Enum

"file"
Il nome file del download è sospetto.

"url"
L'URL del download è noto per essere dannoso.

"content"
Il file scaricato è noto per essere dannoso.

"uncommon"
L'URL del download non viene scaricato comunemente e potrebbe essere pericoloso.

"host"
Il download proviene da un host noto per la distribuzione di file binari dannosi ed è probabilmente pericoloso.

"unwanted"
Il download è potenzialmente indesiderato o non sicuro. Ad esempio, potrebbe apportare modifiche alle impostazioni del browser o del computer.

"safe"
Il download non presenta pericoli noti per il computer dell'utente.

"accepted"
L'utente ha accettato il download pericoloso.

"allowlistedByPolicy"
Valori relativi all'azienda.

"asyncScanning"

"asyncLocalPasswordScanning"

"passwordProtected"

"blockedTooLarge"

"sensitiveContentWarning"

"sensitiveContentBlock"

"deepScannedFailed"

"deepScannedSafe"

"deepScannedOpenedDangerous"

"promptForScanning"

"promptForLocalPasswordScanning"

"accountCompromise"

"blockedScanFailed"

"forceSaveToGdrive"
Da utilizzare con l'estensione Browser aziendale sicuro. Se necessario, Chrome bloccherà il download sul disco e scaricherà il file direttamente su Google Drive.

"forceSaveToOnedrive"
Da utilizzare con l'estensione Browser aziendale sicuro. Se necessario, Chrome bloccherà il download sul disco e scaricherà il file direttamente su OneDrive.

DoubleDelta

Proprietà

  • attuali

    number optional

  • indietro

    number optional

DownloadDelta

Proprietà

  • canResume

    BooleanDelta facoltativo

    La variazione di canResume, se presente.

  • pericolo

    StringDelta facoltativo

    La variazione di danger, se presente.

  • endTime

    StringDelta facoltativo

    La variazione di endTime, se presente.

  • errore

    StringDelta facoltativo

    La variazione di error, se presente.

  • esiste

    BooleanDelta facoltativo

    La variazione di exists, se presente.

  • fileSize

    DoubleDelta facoltativo

    La variazione di fileSize, se presente.

  • nome file

    StringDelta facoltativo

    La variazione di filename, se presente.

  • finalUrl

    StringDelta facoltativo

    Chrome 54 e versioni successive

    La variazione di finalUrl, se presente.

  • id

    numero

    Il id della DownloadItem che è stata modificata.

  • mimo

    StringDelta facoltativo

    La variazione di mime, se presente.

  • in pausa

    BooleanDelta facoltativo

    La variazione di paused, se presente.

  • startTime

    StringDelta facoltativo

    La variazione di startTime, se presente.

  • stato

    StringDelta facoltativo

    La variazione di state, se presente.

  • totalBytes

    DoubleDelta facoltativo

    La variazione di totalBytes, se presente.

  • url

    StringDelta facoltativo

    La variazione di url, se presente.

DownloadItem

Proprietà

  • byExtensionId

    stringa facoltativa

    L'identificatore dell'estensione che ha avviato il download, se il download è stato avviato da un'estensione. Non cambia una volta impostato.

  • byExtensionName

    stringa facoltativa

    Il nome localizzato dell'estensione che ha avviato il download, se il download è stato avviato da un'estensione. Può cambiare se l'estensione cambia 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

    booleano

    True se il download è in corso e in pausa oppure se è interrotto e può essere ripreso dal punto in cui è stato interrotto.

  • pericolo

    DangerType

    Indicazione che specifica se il download è considerato sicuro o se è noto per essere sospetto.

  • endTime

    stringa facoltativa

    L'ora in cui è terminato il download nel formato ISO 8601. Può essere passato direttamente al costruttore Date: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.endTime) console.log(new Date(item.endTime))})})

  • errore

    InterruptReason facoltativo

    Motivi 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 con NETWORK_, quelli relativi al processo di scrittura del file nel file system iniziano con FILE_ e le interruzioni avviate dall'utente iniziano con USER_.

  • estimatedEndTime

    stringa facoltativa

    Ora stimata in cui il download verrà completato nel formato ISO 8601. Può essere passato direttamente al costruttore Date: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.estimatedEndTime) console.log(new Date(item.estimatedEndTime))})})

  • esiste

    booleano

    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, verrà attivato un evento onChanged. Tieni presente che search() non attende il completamento del controllo di esistenza prima di restituire i risultati, pertanto i risultati di search() potrebbero non riflettere accuratamente il file system. Inoltre, search() può essere chiamato tutte le volte che è necessario, ma non verificherà l'esistenza del file più di una volta ogni 10 secondi.

  • fileSize

    numero

    Numero di byte nell'intero file dopo la decompressione o -1 se sconosciuto.

  • nome file

    stringa

    Percorso locale assoluto.

  • finalUrl

    stringa

    Chrome 54 e versioni successive

    L'URL assoluto da cui viene eseguito il download, dopo tutti i reindirizzamenti.

  • id

    numero

    Un identificatore persistente tra le sessioni del browser.

  • incognito

    booleano

    False se questo download viene registrato nella cronologia, true se non viene registrato.

  • mimo

    stringa

    Il tipo MIME del file.

  • in pausa

    booleano

    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 di inizio del download nel formato ISO 8601. Può essere passato direttamente al costruttore Date: chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})})

  • stato

    Stato

    Indica se il download è in corso, interrotto o completato.

  • totalBytes

    numero

    Numero di byte nell'intero file, senza considerare la compressione del file, o -1 se sconosciuto.

  • url

    stringa

    L'URL assoluto da cui è stato avviato il download, prima di eventuali reindirizzamenti.

DownloadOptions

Proprietà

  • corpo

    stringa facoltativa

    Corpo del post.

  • conflictAction

    FilenameConflictAction facoltativo

    L'azione da eseguire se filename esiste già.

  • nome file

    stringa facoltativa

    Un percorso file relativo alla directory Download che contiene il file scaricato, eventualmente contenente sottodirectory. I percorsi assoluti, i percorsi vuoti e i percorsi contenenti riferimenti precedenti ".." causeranno un errore. onDeterminingFilename consente di suggerire un nome file dopo aver determinato il tipo MIME del file e un nome file provvisorio.

  • header

    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 e value o binaryValue, limitate a quelle consentite da XMLHttpRequest.

  • method

    HttpMethod facoltativo

    Il metodo HTTP da utilizzare se l'URL utilizza il protocollo HTTP[S].

  • saveAs

    boolean facoltativo

    Utilizza un selettore file per consentire all'utente di selezionare un nome file indipendentemente dal fatto che filename sia impostato o esista già.

  • url

    stringa

    L'URL da scaricare.

DownloadQuery

Proprietà

  • bytesReceived

    number optional

    Numero di byte ricevuti finora dall'host, senza considerare la compressione dei file.

  • pericolo

    DangerType facoltativo

    Indicazione che specifica se il download è considerato sicuro o se è noto per essere sospetto.

  • endTime

    stringa facoltativa

    L'ora in cui è terminato il download nel formato ISO 8601.

  • endedAfter

    stringa facoltativa

    Limita i risultati a DownloadItem che sono terminati dopo i millisecondi specificati nel formato ISO 8601

  • endedBefore

    stringa facoltativa

    Limita i risultati a DownloadItem che sono terminati prima dei millisecondi specificati nel formato ISO 8601.

  • errore

    InterruptReason facoltativo

    Motivi dell'interruzione di un download.

  • esiste

    boolean facoltativo

    Se il file scaricato esiste.

  • fileSize

    number optional

    Numero di byte nell'intero file dopo la decompressione o -1 se sconosciuto.

  • nome file

    stringa facoltativa

    Percorso locale assoluto.

  • filenameRegex

    stringa facoltativa

    Limita i risultati a DownloadItem il cui filename corrisponde all'espressione regolare specificata.

  • finalUrl

    stringa facoltativa

    Chrome 54 e versioni successive

    L'URL assoluto da cui viene eseguito il download, dopo tutti i reindirizzamenti.

  • finalUrlRegex

    stringa facoltativa

    Chrome 54 e versioni successive

    Limita i risultati a DownloadItem il cui finalUrl corrisponde all'espressione regolare specificata.

  • id

    number optional

    id della DownloadItem su cui eseguire la query.

  • limite

    number optional

    Il numero massimo di DownloadItem corrispondenti restituite. Il valore predefinito è 1000. Imposta il valore su 0 per restituire tutti i DownloadItem corrispondenti. Consulta search per scoprire come scorrere i risultati.

  • mimo

    stringa facoltativa

    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, l'impostazione orderBy=['startTime'] ordina DownloadItem in base all'ora di inizio in ordine crescente. Per specificare l'ordine decrescente, aggiungi un trattino come prefisso: "-startTime".

  • in pausa

    boolean 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 cui filename o url o finalUrl contengono tutti i termini di ricerca che non iniziano con un trattino "-" e nessuno dei termini di ricerca che iniziano con un trattino.

  • startTime

    stringa facoltativa

    L'ora di inizio del download nel formato ISO 8601.

  • startedAfter

    stringa facoltativa

    Limita i risultati a DownloadItem che sono iniziati dopo i millisecondi specificati nel formato ISO 8601.

  • startedBefore

    stringa facoltativa

    Limita i risultati ai DownloadItem iniziati prima dei ms specificati nel formato ISO 8601.

  • stato

    Stato facoltativo

    Indica se il download è in corso, interrotto o completato.

  • totalBytes

    number optional

    Numero di byte nell'intero file, senza considerare la compressione del file, o -1 se sconosciuto.

  • totalBytesGreater

    number optional

    Limita i risultati a DownloadItem il cui totalBytes è maggiore del numero intero specificato.

  • totalBytesLess

    number optional

    Limita i risultati a DownloadItem il cui totalBytes è inferiore all'intero specificato.

  • url

    stringa facoltativa

    L'URL assoluto da cui è stato avviato il download, prima di eventuali reindirizzamenti.

  • urlRegex

    stringa facoltativa

    Limita i risultati a DownloadItem il cui url corrisponde all'espressione regolare specificata.

FilenameConflictAction

uniquify

Per evitare duplicazioni, il filename viene modificato in modo da includere un contatore prima dell'estensione del nome file.

sovrascrivere

Il file esistente verrà sovrascritto con il nuovo file.

prompt

All'utente verrà mostrata una finestra di dialogo per la selezione dei file.

Enum

"uniquify"

"overwrite"

"prompt"

FilenameSuggestion

Proprietà

  • conflictAction

    FilenameConflictAction facoltativo

    L'azione da eseguire se filename esiste già.

  • nome file

    stringa

    La nuova destinazione DownloadItem.filename di DownloadItem, come percorso relativo alla directory Download predefinita dell'utente, che potrebbe contenere sottodirectory. I percorsi assoluti, i percorsi vuoti e i percorsi contenenti riferimenti precedenti ".." verranno ignorati. filename viene ignorato se sono presenti listener onDeterminingFilename registrati da estensioni.

GetFileIconOptions

Proprietà

  • dimensioni

    number optional

    Le dimensioni dell'icona restituita in pixel indipendenti dalla densità (DIP). Deve essere 16 o 32 (il valore predefinito è 32). Sui display con DPI elevato, l'immagine restituita viene ridimensionata in base al fattore di scalabilità del dispositivo (ad es. 64 x 64 px per la dimensione 32 su un display 2x). Le chiamate dai service worker in background vengono eseguite per impostazione predefinita con una scala 1x.

HeaderNameValuePair

Proprietà

  • nome

    stringa

    Nome dell'intestazione HTTP.

  • valore

    stringa

    Valore dell'intestazione HTTP.

HttpMethod

Enum

"GET"

"POST"

InterruptReason

Enum

"FILE_FAILED"

"FILE_ACCESS_DENIED"

"FILE_NO_SPACE"

"FILE_NAME_TOO_LONG"

"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_FORBIDDEN"

"SERVER_UNREACHABLE"

"SERVER_CONTENT_LENGTH_MISMATCH"

"SERVER_CROSS_ORIGIN_REDIRECT"

"USER_CANCELED"

"USER_SHUTDOWN"

"CRASH"

State

in_progress

Il download sta ricevendo dati dal server.

interrotto

Un errore ha interrotto la connessione con l'host del file.

complete

Il download è stato completato correttamente.

Enum

"in_progress"

"interrupted"

"complete"

StringDelta

Proprietà

  • attuali

    stringa facoltativa

  • indietro

    stringa facoltativa

UiOptions

Chrome 105 e versioni successive

Proprietà

  • attivato

    booleano

    Attiva o disattiva la UI di download.

Metodi

acceptDanger()

Promise 
chrome.downloads.acceptDanger(
  downloadId: number,
  callback?: function,
): Promise<void>

Chiedi all'utente di accettare un download pericoloso. Può essere chiamata solo da un contesto visibile (scheda, finestra o popup di azione di pagina/browser). Non accetta automaticamente i download pericolosi. Se il download viene accettato, verrà attivato un evento onChanged, altrimenti non accadrà 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 "complete" e viene attivato onChanged.

Parametri

  • downloadId

    numero

    L'identificatore di DownloadItem.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Restituisce una Promise che si risolve quando la finestra di dialogo del prompt di pericolo si chiude.

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

cancel()

Promise 
chrome.downloads.cancel(
  downloadId: number,
  callback?: function,
): Promise<void>

Annullare un download. Quando viene eseguito callback, il download viene annullato, completato, interrotto o non esiste più.

Parametri

  • downloadId

    numero

    L'ID del download da annullare.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Restituisce una promessa che viene risolta quando la richiesta di annullamento viene completata.

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

download()

Promise 
chrome.downloads.download(
  options: DownloadOptions,
  callback?: function,
): Promise<number>

Scaricare un URL. Se l'URL utilizza il protocollo HTTP[S], la richiesta includerà tutti i cookie attualmente impostati per il relativo nome host. Se vengono specificati sia filename sia saveAs, verrà 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, verrà chiamato callback con downloadId=undefined e runtime.lastError conterrà una stringa descrittiva. Non è garantita la compatibilità con le versioni precedenti delle stringhe di errore tra le release. Le estensioni non devono analizzarlo.

Parametri

  • opzioni

    DownloadOptions

    Cosa scaricare e come.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (downloadId: number) => void

    • downloadId

      numero

Resi

  • Promise<number>

    Chrome 96 e versioni successive

    Restituisce una promessa che si risolve con l'ID del nuovo DownloadItem.

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

erase()

Promise 
chrome.downloads.erase(
  query: DownloadQuery,
  callback?: function,
): Promise<number[]>

Cancella DownloadItem corrispondente dalla cronologia senza eliminare il file scaricato. Verrà attivato un evento onErased per ogni DownloadItem che corrisponde a query, quindi verrà chiamato callback.

Parametri

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (erasedIds: number[]) => void

    • erasedIds

      number[]

Resi

  • Promise<number[]>

    Chrome 96 e versioni successive

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

getFileIcon()

Promise 
chrome.downloads.getFileIcon(
  downloadId: number,
  options?: GetFileIconOptions,
  callback?: function,
): Promise<string | undefined>

Recupera un'icona per il download specificato. Per i nuovi download, le icone dei file sono disponibili dopo che è stato determinato il nome file di destinazione del download (ad esempio, quando onChanged si attiva con una modifica di filename). Se tenti di recuperare l'icona prima che venga determinato il nome file, verrà generato un errore tramite runtime.lastError. L'immagine restituita da questa funzione durante un download potrebbe essere diversa da quella restituita al termine del download. Il recupero delle icone viene eseguito eseguendo una query sul sistema operativo o sul toolkit sottostante, a seconda della piattaforma. L'icona restituita dipenderà quindi 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 determinare l'icona di un file, runtime.lastError conterrà un messaggio di errore.

Parametri

  • downloadId

    numero

    L'identificatore del download.

  • opzioni

    GetFileIconOptions facoltativo

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    (iconURL?: string) => void

    • iconURL

      stringa facoltativa

Resi

  • Promise<string | undefined>

    Chrome 96 e versioni successive

    Restituisce una Promise che si risolve con un URL di un'immagine che rappresenta il download.

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

open()

Promise 
chrome.downloads.open(
  downloadId: number,
  callback?: function,
): Promise<void>

Apre il file scaricato ora se DownloadItem è completo; 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'attivazione dall'utente.

Parametri

  • downloadId

    numero

    L'identificatore del file scaricato.

  • callback

    funzione elemento facoltativo

    Chrome 123 e versioni successive

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 123 e versioni successive

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

pause()

Promise 
chrome.downloads.pause(
  downloadId: number,
  callback?: function,
): Promise<void>

Metti in pausa il download. Se la richiesta è andata a buon fine, il download è in stato di pausa. In caso contrario, runtime.lastError contiene un messaggio di errore. La richiesta non andrà a buon fine se il download non è attivo.

Parametri

  • downloadId

    numero

    L'ID del download da mettere in pausa.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Restituisce una Promise che viene risolta quando la richiesta di pausa viene completata.

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

removeFile()

Promise 
chrome.downloads.removeFile(
  downloadId: number,
  callback?: function,
): Promise<void>

Rimuovi il file scaricato se esiste e se DownloadItem è completo; in caso contrario, restituisci un errore tramite runtime.lastError.

Parametri

  • downloadId

    numero

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

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

resume()

Promise 
chrome.downloads.resume(
  downloadId: number,
  callback?: function,
): Promise<void>

Riprendere un download in pausa. Se la richiesta è andata a buon fine, il download è in corso e non è in pausa. In caso contrario, runtime.lastError contiene un messaggio di errore. La richiesta non andrà a buon fine se il download non è attivo.

Parametri

  • downloadId

    numero

    L'ID del download da riprendere.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Chrome 96 e versioni successive

    Restituisce una Promise che viene risolta quando la richiesta di ripresa viene completata.

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

Promise 
chrome.downloads.search(
  query: DownloadQuery,
  callback?: function,
): Promise<DownloadItem[]>

Trova DownloadItem. Imposta query sull'oggetto vuoto per ottenere tutti i DownloadItem. Per ottenere un DownloadItem specifico, imposta solo il campo id. Per scorrere un numero elevato di elementi, imposta orderBy: ['-startTime'], imposta limit sul numero di elementi per pagina e imposta startedAfter sul valore startTime dell'ultimo elemento dell'ultima pagina.

Parametri

Resi

  • Promise<DownloadItem[]>

    Chrome 96 e versioni successive

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

setShelfEnabled()

Ritirato da Chrome 117
chrome.downloads.setShelfEnabled(
  enabled: boolean,
): void

Utilizza invece setUiOptions.

Attiva o disattiva la sezione grigia nella parte inferiore di ogni finestra associata al profilo del browser corrente. La sezione verrà disattivata finché almeno un'estensione non l'avrà disattivata. L'attivazione della barra delle app mentre almeno un'altra estensione l'ha disattivata restituirà un errore tramite runtime.lastError. Richiede l'autorizzazione "downloads.shelf" oltre all'autorizzazione "downloads".

Parametri

  • attivato

    booleano

setUiOptions()

Promise Chrome 105+ 
chrome.downloads.setUiOptions(
  options: UiOptions,
  callback?: function,
): Promise<void>

Modifica l'interfaccia utente di download di ogni finestra associata al profilo del browser corrente. Finché almeno un'estensione ha impostato UiOptions.enabled su false, la UI di download verrà nascosta. Se imposti UiOptions.enabled su true mentre almeno un'altra estensione l'ha disattivata, verrà restituito un errore tramite runtime.lastError. Richiede l'autorizzazione "downloads.ui" oltre all'autorizzazione "downloads".

Parametri

  • opzioni

    UiOptions

    Incapsula una modifica all'UI di download.

  • callback

    funzione elemento facoltativo

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promise<void>

    Restituisce una promessa che viene risolta al termine dell'aggiornamento della UI.

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

show()

chrome.downloads.show(
  downloadId: number,
): void

Mostra il file scaricato nella relativa cartella in un gestore di file.

Parametri

  • downloadId

    numero

    L'identificatore del file scaricato.

showDefaultFolder()

chrome.downloads.showDefaultFolder(): void

Mostra la cartella Download predefinita in un gestore di file.

Eventi

onChanged

chrome.downloads.onChanged.addListener(
  callback: function,
)

Quando una delle proprietà di un DownloadItem cambia, ad eccezione di bytesReceived e estimatedEndTime, 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

onCreated

chrome.downloads.onCreated.addListener(
  callback: function,
)

Questo evento viene attivato con l'oggetto DownloadItem quando inizia un download.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (downloadItem: DownloadItem) => void

onDeterminingFilename

chrome.downloads.onDeterminingFilename.addListener(
  callback: function,
)

Durante il processo di determinazione del nome file, le estensioni avranno la possibilità di eseguire l'override del target DownloadItem.filename. 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. DownloadItem non verrà completato finché tutti i listener non avranno chiamato suggest. Gli ascoltatori possono chiamare suggest senza argomenti per consentire al download di utilizzare downloadItem.filename come nome file o passare un oggetto suggestion a suggest per eseguire l'override del nome file di destinazione. Se più di un'estensione esegue l'override del nome file, l'ultima estensione installata il cui listener passa un oggetto suggestion a suggest ha la priorità. Per evitare confusione su quale estensione avrà la precedenza, gli utenti non devono installare estensioni che potrebbero entrare in conflitto. Se il download viene avviato da download e il nome file di destinazione è noto prima che siano stati determinati il tipo MIME e il nome file provvisorio, passa filename a download.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (downloadItem: DownloadItem, suggest: function) => void

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