chrome.downloads

Descrizione

Utilizza l'API chrome.downloads per avviare, monitorare, manipolare e cercare i download in modo programmatico.

Autorizzazioni

downloads

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.

nuovi, di alta qualità, pertinenti e variegati

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.

accettato

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 successive

    La modifica in finalUrl, se presente.

  • id

    numero

    Valore id di DownloadItem 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

    DangerType

    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 con NETWORK_, gli errori relativi alla procedura di scrittura del file nel file system iniziano con FILE_ e le interruzioni avviate dall'utente iniziano con USER_.

  • 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 evento onChanged. Tieni presente che search() non attende il completamento del controllo dell'esistenza prima di tornare, quindi i risultati di search() potrebbero non riflettere accuratamente il file system. Inoltre, la funzione search() 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 successive

    L'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

    Stato

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

    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 cui filename corrisponde all'espressione regolare specificata.

  • finalUrl

    stringa facoltativo

    Chrome 54 e versioni successive

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

  • finalUrlRegex

    stringa facoltativo

    Chrome 54 e versioni successive

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

  • id

    numero facoltativo

    Il id di DownloadItem 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 elementi DownloadItem corrispondenti. Per informazioni su come sfogliare i risultati, visita la pagina search.

  • 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 imposti orderBy=['startTime'], i campi DownloadItem 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 cui filename, url o finalUrl 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 cui totalBytes è maggiore del numero intero specificato.

  • totalBytesLess

    numero facoltativo

    Limita i risultati a DownloadItem il cui totalBytes è 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 cui url 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 listener onDeterminingFilename 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

Chrome 105 e versioni successive

Proprietà

  • abilitata

    boolean

    Attiva o disattiva l'interfaccia utente di download.

Metodi

acceptDanger()

Promessa 
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 successive

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

cancel()

Promessa 
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 successive

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

download()

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

    DownloadOptions

    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 successive

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

erase()

Promessa 
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

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (erasedIds: number[])=>void

    • erasedIds

      numero[]

Ritorni

  • Promessa<number[]>

    Chrome 96 e versioni successive

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

getFileIcon()

Promessa 
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

  • Promessa<string|undefined>

    Chrome 96 e versioni successive

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

open()

Promessa 
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 successive

    Il parametro callback ha il seguente aspetto: 

    ()=>void

Ritorni

  • Promise<void>

    Chrome 123 e versioni successive

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

pause()

Promessa 
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 successive

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

removeFile()

Promessa 
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 successive

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

resume()

Promessa 
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 successive

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

Promessa 
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

Ritorni

  • Promise<DownloadItem[]>

    Chrome 96 e versioni successive

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

setShelfEnabled()

Obsoleto da Chrome 117
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()

Promessa Chrome 105 o versioni successive 
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.

    UiOptions

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

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

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

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

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