chrome.downloads

Descrição

Use a API chrome.downloads para iniciar, monitorar, manipular e pesquisar downloads de maneira programática.

Permissões

downloads

É necessário declarar a permissão "downloads" no manifesto de extensões para usar a API.

{
  "name": "My extension",
  ...
  "permissions": [
    "downloads"
  ],
}

Exemplos

Você encontra exemplos simples de uso da API chrome.downloads no diretório examples/api/downloads. Para ver outros exemplos e receber ajuda na visualização do código-fonte, consulte Amostras.

Tipos

BooleanDelta

Propriedades

  • atuais

    booleano opcional

  • anterior

    booleano opcional

DangerType

arquivo

O nome do arquivo do download é suspeito.

url

O URL do download é conhecido por ser malicioso.

conteúdo

O arquivo baixado é conhecido por ser malicioso.

incomuns

O URL do download não costuma ser transferido com frequência e pode ser perigoso.

anfitrião

O download veio de um host conhecido por distribuir binários maliciosos e provavelmente é perigoso.

indesejado

O download é possivelmente indesejado ou não seguro. Por exemplo, ele pode fazer mudanças nas configurações do navegador ou do computador.

seguro

O download não apresenta nenhum perigo conhecido para o computador do usuário.

aceito

O usuário aceitou o download perigoso.

Tipo enumerado

"url"

"host"

"asyncScanning"

"asyncLocalPasswordScanning"

"passwordProtected"

"blockedTooLarge"

"sensitiveContentWarning"

"sensitiveContentBlock"

"promptForScanning"

"promptForLocalPasswordScanning"

"accountCompromise"
.

"blockedScanFailed"

DoubleDelta

Propriedades

  • atuais

    número opcional

  • anterior

    número opcional

DownloadDelta

Propriedades

  • canResume

    BooleanDelta opcional

    A mudança em canResume, se houver.

  • perigo

    StringDelta opcional

    A mudança em danger, se houver.

  • endTime

    StringDelta opcional

    A mudança em endTime, se houver.

  • error

    StringDelta opcional

    A mudança em error, se houver.

  • existe

    BooleanDelta opcional

    A mudança em exists, se houver.

  • fileSize

    DoubleDelta (opcional)

    A mudança em fileSize, se houver.

  • filename

    StringDelta opcional

    A mudança em filename, se houver.

  • finalUrl

    StringDelta opcional

    Chrome 54 ou mais recente

    A mudança em finalUrl, se houver.

  • id

    number

    O id do DownloadItem que mudou.

  • mímica

    StringDelta opcional

    A mudança em mime, se houver.

  • pausado

    BooleanDelta opcional

    A mudança em paused, se houver.

  • startTime

    StringDelta opcional

    A mudança em startTime, se houver.

  • state

    StringDelta opcional

    A mudança em state, se houver.

  • totalBytes

    DoubleDelta (opcional)

    A mudança em totalBytes, se houver.

  • url

    StringDelta opcional

    A mudança em url, se houver.

DownloadItem

Propriedades

  • byExtensionId

    string opcional

    O identificador da extensão que iniciou este download, se ele tiver sido iniciado por uma extensão. Não muda depois de definido.

  • byExtensionName

    string opcional

    O nome localizado da extensão que iniciou este download, se ele tiver sido iniciado por uma extensão. Isso pode mudar se a extensão mudar o nome ou a localidade do usuário.

  • bytesReceived

    number

    Número de bytes recebidos até o momento do host, sem considerar a compactação de arquivos.

  • canResume

    boolean

    Verdadeiro se o download estiver em andamento e pausado ou se for interrompido e puder ser retomado a partir de onde foi interrompido.

  • perigo

    DangerType

    Indica se esse download é considerado seguro ou suspeito.

  • endTime

    string opcional

    A hora em que o download terminou no formato ISO 8601. Pode ser transmitido diretamente para o construtor de data: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.endTime) console.log(new Date(item.endTime))})}).

  • error

    InterruptReason opcional

    Por que o download foi interrompido. Vários tipos de erros HTTP podem ser agrupados em um dos erros que começam com SERVER_. Os erros relacionados à rede começam com NETWORK_, os erros relacionados ao processo de gravação do arquivo no sistema de arquivos começam com FILE_ e as interrupções iniciadas pelo usuário começam com USER_.

  • estimatedEndTime

    string opcional

    Tempo estimado em que o download será concluído no formato ISO 8601. Pode ser transmitido diretamente para o construtor de data: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.estimatedEndTime) console.log(new Date(item.estimatedEndTime))})}).

  • existe

    boolean

    Se o arquivo transferido por download ainda existe. Estas informações podem estar desatualizadas porque o Chrome não verifica automaticamente a remoção de arquivos. Chame search() para acionar a verificação da existência do arquivo. Quando a verificação de existência for concluída, se o arquivo tiver sido excluído, um evento onChanged será disparado. Observe que search() não espera a conclusão da verificação de existência antes de retornar. Por isso, os resultados de search() podem não refletir com precisão o sistema de arquivos. Além disso, search() pode ser chamado com a frequência necessária, mas não verificará a existência do arquivo com mais frequência do que uma vez a cada 10 segundos.

  • fileSize

    number

    Número de bytes em todo o arquivo pós-descompactação, ou -1, se for desconhecido.

  • filename

    string

    Caminho local absoluto.

  • finalUrl

    string

    Chrome 54 ou mais recente

    O URL absoluto do qual este download está sendo feito, depois de todos os redirecionamentos.

  • id

    number

    Um identificador que é persistente em todas as sessões do navegador.

  • navegação anônima

    boolean

    Falso se este download estiver registrado no histórico; verdadeiro se não for registrado.

  • mímica

    string

    O tipo MIME do arquivo.

  • pausado

    boolean

    Verdadeiro se o download parou de ler dados do host, mas manteve a conexão aberta.

  • referrer

    string

    URL absoluto.

  • startTime

    string

    A hora em que o download começou no formato ISO 8601. Pode ser transmitido diretamente para o construtor de data: chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})}).

  • state

    Estado

    Indica se o download está progredindo, é interrompido ou concluído.

  • totalBytes

    number

    Número de bytes em todo o arquivo, sem considerar a compactação, ou -1, se for desconhecido.

  • url

    string

    O URL absoluto a partir do qual o download foi iniciado, antes de qualquer redirecionamento.

DownloadOptions

Propriedades

  • body

    string opcional

    Corpo da postagem.

  • conflictAction

    FilenameConflictAction opcional

    A ação a ser realizada se filename já existir.

  • filename

    string opcional

    Um caminho de arquivo relativo ao diretório Downloads para conter o arquivo baixado, possivelmente contendo subdiretórios. Caminhos absolutos, vazios e que contêm referências anteriores ".." vão causar um erro. O onDeterminingFilename permite sugerir um nome de arquivo depois que o tipo MIME e um nome de arquivo provisório forem determinados.

  • headers

    HeaderNameValuePair[] opcional

    Cabeçalhos HTTP extras a serem enviados com a solicitação se o URL usar o protocolo HTTP[s]. Cada cabeçalho é representado como um dicionário contendo as chaves name e value ou binaryValue, restritas àquelas permitidas por XMLHttpRequest.

  • method

    HttpMethod opcional

    O método HTTP a ser usado se o URL usar o protocolo HTTP[S].

  • saveAs

    booleano opcional

    Use um seletor de arquivos para permitir que o usuário selecione um nome de arquivo, independentemente de filename estar definido ou já existir.

  • url

    string

    O URL para download.

DownloadQuery

Propriedades

  • bytesReceived

    número opcional

    Número de bytes recebidos até o momento do host, sem considerar a compactação de arquivos.

  • perigo

    DangerType opcional

    Indica se esse download é considerado seguro ou suspeito.

  • endTime

    string opcional

    A hora em que o download terminou no formato ISO 8601.

  • endedAfter

    string opcional

    Limita os resultados a DownloadItem que terminavam após o ms especificado no formato ISO 8601

  • endedBefore

    string opcional

    Limita os resultados a DownloadItem que terminaram antes do ms especificado no formato ISO 8601.

  • error

    InterruptReason opcional

    O motivo de um download ser interrompido.

  • existe

    booleano opcional

    Se o arquivo transferido por download existe.

  • fileSize

    número opcional

    Número de bytes em todo o arquivo pós-descompactação, ou -1, se for desconhecido.

  • filename

    string opcional

    Caminho local absoluto.

  • filenameRegex

    string opcional

    Limita os resultados a DownloadItem, em que filename corresponde à expressão regular em questão.

  • finalUrl

    string opcional

    Chrome 54 ou mais recente

    O URL absoluto do qual este download está sendo feito, depois de todos os redirecionamentos.

  • finalUrlRegex

    string opcional

    Chrome 54 ou mais recente

    Limita os resultados a DownloadItem, em que finalUrl corresponde à expressão regular em questão.

  • id

    número opcional

    O id do DownloadItem a ser consultado.

  • limite

    número opcional

    O número máximo de DownloadItem correspondentes retornadas. O valor padrão é 1000. Defina como 0 para retornar todos os DownloadItem correspondentes. Consulte search para saber como paginar os resultados.

  • mímica

    string opcional

    O tipo MIME do arquivo.

  • orderBy

    string[] opcional

    Defina os elementos dessa matriz como as propriedades DownloadItem para classificar os resultados da pesquisa. Por exemplo, definir orderBy=['startTime'] classifica as DownloadItem pelo horário de início em ordem crescente. Para especificar a ordem decrescente, adicione um hífen ao prefixo: '-startTime'.

  • pausado

    booleano opcional

    Verdadeiro se o download parou de ler dados do host, mas manteve a conexão aberta.

  • consulta

    string[] opcional

    Esta matriz de termos de pesquisa limita os resultados a DownloadItem, em que filename, url ou finalUrl contêm todos os termos de pesquisa que não começam com um traço "-" e nenhum dos termos de pesquisa que começam com um traço.

  • startTime

    string opcional

    A hora em que o download começou no formato ISO 8601.

  • startedAfter

    string opcional

    Limita os resultados a DownloadItem iniciados após o ms especificado no formato ISO 8601.

  • startedBefore

    string opcional

    Limita os resultados a DownloadItem iniciados antes do ms especificado no formato ISO 8601.

  • state

    Estado opcional

    Indica se o download está progredindo, é interrompido ou concluído.

  • totalBytes

    número opcional

    Número de bytes em todo o arquivo, sem considerar a compactação, ou -1, se for desconhecido.

  • totalBytesGreater

    número opcional

    Limita os resultados a DownloadItem, em que totalBytes é maior que o número inteiro fornecido.

  • totalBytesLess

    número opcional

    Limita os resultados a DownloadItem, em que totalBytes é menor que o número inteiro fornecido.

  • url

    string opcional

    O URL absoluto a partir do qual o download foi iniciado, antes de qualquer redirecionamento.

  • urlRegex

    string opcional

    Limita os resultados a DownloadItem, em que url corresponde à expressão regular em questão.

FilenameConflictAction

unique

Para evitar a duplicação, o filename é mudado para incluir um contador antes da extensão do nome de arquivo.

substituir

O arquivo atual será substituído pelo novo.

prompt

O usuário verá uma caixa de diálogo seletora de arquivos.

Tipo enumerado

FilenameSuggestion

Propriedades

  • conflictAction

    FilenameConflictAction opcional

    A ação a ser realizada se filename já existir.

  • filename

    string

    O novo destino DownloadItem.filename do DownloadItem, como um caminho relativo ao diretório Downloads padrão do usuário, possivelmente contendo subdiretórios. Caminhos absolutos, vazios e que contêm referências anteriores ".." serão ignorados. O filename será ignorado se houver algum listener onDeterminingFilename registrado por alguma extensão.

GetFileIconOptions

Propriedades

  • tamanho

     opcional

    O tamanho do ícone retornado. O ícone será quadrado, com as dimensões de tamanho * tamanho de pixels. O tamanho padrão e maior do ícone é 32 x 32 pixels. Os únicos tamanhos compatíveis são 16 e 32. Será um erro especificar qualquer outro tamanho.

HeaderNameValuePair

Propriedades

  • name

    string

    Nome do cabeçalho HTTP.

  • valor

    string

    Valor do cabeçalho HTTP.

HttpMethod

Tipo enumerado

InterruptReason

Tipo enumerado

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

"NETWORK_INVALID_REQUEST"

"SERVER_FAILED"

"SERVER_NO_RANGE"

"SERVER_BAD_CONTENT"

"SERVER_UNAUTHORIZED"

"SERVER_CERT_PROBLEM"

"SERVER_FORBIDDEN"

"SERVER_UNREACHABLE"

"SERVER_CROSS_ORIGIN_REDIRECT"

"USER_CANCELED"

"USER_SHUTDOWN"

State

in_progress

O download está recebendo dados do servidor no momento.

interrompido

Um erro interrompeu a conexão com o host do arquivo.

concluído

O download foi concluído.

Tipo enumerado

StringDelta

Propriedades

  • atuais

    string opcional

  • anterior

    string opcional

UiOptions

Chrome 105 ou mais recente

Propriedades

  • ativado

    boolean

    Ative ou desative a interface de download.

Métodos

acceptDanger()

Promessa 
chrome.downloads.acceptDanger(
  downloadId: number,
  callback?: function,
)

Peça que o usuário aceite um download perigoso. Só pode ser chamado de um contexto visível (guia, janela ou pop-up de ação da página/navegador). Não aceita downloads perigosos automaticamente. Se o download for aceito, um evento onChanged será disparado. Caso contrário, nada acontecerá. Quando todos os dados forem buscados em um arquivo temporário e o download não for perigoso ou o perigo for aceito, o arquivo temporário será renomeado como o nome de arquivo de destino, o state vai mudar para "concluído" e a onChanged será acionada.

Parâmetros

  • downloadId

    number

    O identificador para DownloadItem.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 96 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

cancel()

Promessa 
chrome.downloads.cancel(
  downloadId: number,
  callback?: function,
)

Cancelar um download. Quando callback é executado, o download é cancelado, concluído, interrompido ou não existe mais.

Parâmetros

  • downloadId

    number

    O ID do download a ser cancelado.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 96 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

download()

Promessa 
chrome.downloads.download(
  options: DownloadOptions,
  callback?: function,
)

Fazer o download de um URL. Se o URL usar o protocolo HTTP[S], a solicitação incluirá todos os cookies definidos atualmente para o nome do host. Se filename e saveAs forem especificados, a caixa de diálogo "Salvar como" vai aparecer já preenchida com o filename especificado. Se o download for iniciado, o callback vai ser chamado com o downloadId do novo DownloadItem. Se ocorrer um erro ao iniciar o download, callback será chamado com downloadId=undefined e runtime.lastError conterá uma string descritiva. Não há garantia de que as strings de erro permaneçam compatíveis com versões anteriores entre as versões. As extensões não podem analisá-lo.

Parâmetros

  • do modelo.

    DownloadOptions

    O que fazer e como fazer o download.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (downloadId: number)=>void

    • downloadId

      number

Retorna

  • Prometer<número>

    Chrome 96 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

erase()

Promessa 
chrome.downloads.erase(
  query: DownloadQuery,
  callback?: function,
)

Limpar a correspondência de DownloadItem do histórico sem excluir o arquivo transferido por download. Um evento onErased será disparado para cada DownloadItem que corresponder a query. Em seguida, callback será chamado.

Parâmetros

  • consulta

    DownloadQuery

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (erasedIds: number[])=>void

    • erasedIds

      Número[]

Retorna

  • Prometer<número[]>

    Chrome 96 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

getFileIcon()

Promessa 
chrome.downloads.getFileIcon(
  downloadId: number,
  options?: GetFileIconOptions,
  callback?: function,
)

Recuperar um ícone para o download especificado. Para novos downloads, os ícones de arquivo ficam disponíveis após o recebimento do evento onCreated. A imagem retornada por essa função enquanto um download está em andamento pode ser diferente da imagem retornada após a conclusão do download. A recuperação do ícone é feita consultando o sistema operacional ou o toolkit subjacente, dependendo da plataforma. Portanto, o ícone retornado depende de vários fatores, incluindo o estado do download, a plataforma, os tipos de arquivos registrados e o tema visual. Se não for possível determinar um ícone de arquivo, runtime.lastError exibirá uma mensagem de erro.

Parâmetros

  • downloadId

    number

    O identificador do download.

  • do modelo.

    GetFileIconOptions opcional

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (iconURL?: string)=>void

    • iconURL

      string opcional

Retorna

  • Promessa<string|indefinida>

    Chrome 96 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

open()

Promessa 
chrome.downloads.open(
  downloadId: number,
  callback?: function,
)

Abre o arquivo transferido por download agora se a DownloadItem estiver concluída. Caso contrário, retorna um erro pelo runtime.lastError. Esse método requer as permissões "downloads.open" e "downloads". Um evento onChanged é disparado quando o item é aberto pela primeira vez. Esse método só pode ser chamado em resposta a um gesto do usuário.

Parâmetros

  • downloadId

    number

    O identificador do arquivo transferido por download.

  • callback

    função optional

    Chrome 123 ou mais recente

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 123 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

pause()

Promessa 
chrome.downloads.pause(
  downloadId: number,
  callback?: function,
)

Pausar o download. Se a solicitação for bem-sucedida, o download ficará pausado. Caso contrário, runtime.lastError vai mostrar uma mensagem de erro. A solicitação falhará se o download não estiver ativo.

Parâmetros

  • downloadId

    number

    O ID do download a ser pausado.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 96 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

removeFile()

Promessa 
chrome.downloads.removeFile(
  downloadId: number,
  callback?: function,
)

Remova o arquivo transferido por download se ele existir e a DownloadItem estiver concluída. Caso contrário, retorne um erro usando runtime.lastError.

Parâmetros

  • downloadId

    number

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 96 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

resume()

Promessa 
chrome.downloads.resume(
  downloadId: number,
  callback?: function,
)

Retome um download pausado. Se a solicitação for bem-sucedida, o download estará em andamento e foi retomado. Caso contrário, runtime.lastError vai mostrar uma mensagem de erro. A solicitação falhará se o download não estiver ativo.

Parâmetros

  • downloadId

    number

    O ID do download a ser retomado.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Chrome 96 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

Promessa 
chrome.downloads.search(
  query: DownloadQuery,
  callback?: function,
)

Localize DownloadItem. Defina query como o objeto vazio para acessar todos os DownloadItem. Para conferir um DownloadItem específico, defina apenas o campo id. Para percorrer um grande número de itens, defina orderBy: ['-startTime'], defina limit como o número de itens por página e startedAfter como o startTime do último item da última página.

Parâmetros

Retorna

  • Promise<DownloadItem[]>

    Chrome 96 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

setShelfEnabled()

Descontinuado desde o Chrome 117
chrome.downloads.setShelfEnabled(
  enabled: boolean,
)

Use setUiOptions.

Ativar ou desativar a estante cinza na parte inferior de todas as janelas associadas ao perfil atual do navegador. A estante ficará desativada enquanto pelo menos uma extensão a tiver desativado. Se você ativar a estante enquanto pelo menos uma outra extensão estiver desativada, um erro será retornado por runtime.lastError. Requer a permissão "downloads.shelf", além da permissão "downloads".

Parâmetros

  • ativado

    boolean

setUiOptions()

Promessa Chrome 105 ou mais recente 
chrome.downloads.setUiOptions(
  options: UiOptions,
  callback?: function,
)

Altere a interface de download de todas as janelas associadas ao perfil atual do navegador. Se pelo menos uma extensão tiver definido UiOptions.enabled como "false", a interface de download vai ficar oculta. Se UiOptions.enabled for definido como verdadeiro enquanto pelo menos uma outra extensão estiver desativada, um erro será retornado pelo runtime.lastError. Requer a permissão "downloads.ui", além da permissão "downloads".

Parâmetros

  • do modelo.

    UiOptions

    Encapsular uma alteração na interface de download.

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    ()=>void

Retorna

  • Promise<void>

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

show()

chrome.downloads.show(
  downloadId: number,
)

Mostre o arquivo baixado na pasta correspondente em um gerenciador de arquivos.

Parâmetros

  • downloadId

    number

    O identificador do arquivo transferido por download.

showDefaultFolder()

chrome.downloads.showDefaultFolder()

Mostrar a pasta "Downloads" padrão em um gerenciador de arquivos.

Eventos

onChanged

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

Quando qualquer uma das propriedades de DownloadItem, exceto bytesReceived e estimatedEndTime, muda, esse evento é disparado com downloadId e um objeto que contém as propriedades alteradas.

Parâmetros

onCreated

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

Esse evento é disparado com o objeto DownloadItem quando um download começa.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (downloadItem: DownloadItem)=>void

onDeterminingFilename

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

Durante o processo de determinação do nome de arquivo, as extensões podem substituir o DownloadItem.filename de destino. Cada extensão não pode registrar mais de um listener para esse evento. Cada listener precisa chamar suggest exatamente uma vez, de forma síncrona ou assíncrona. Se o listener chamar suggest de forma assíncrona, ele precisará retornar true. Se o listener não chamar suggest de forma síncrona nem retornar true, suggest será chamado automaticamente. O DownloadItem não será concluído até que todos os listeners tenham chamado suggest. Os listeners podem chamar suggest sem nenhum argumento para permitir que o download use downloadItem.filename como nome de arquivo ou transmitir um objeto suggestion para suggest a fim de substituir o nome de arquivo de destino. Se mais de uma extensão substituir o nome do arquivo, a última extensão instalada cujo listener transmite um objeto suggestion para suggest vence. Para evitar confusão sobre qual extensão vencerá, os usuários não devem instalar extensões que possam entrar em conflito. Se o download for iniciado por download, e o nome do arquivo de destino for conhecido antes da determinação do tipo MIME e do nome de arquivo provisório, transmita filename para download.

Parâmetros

onErased

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

Ativa com o downloadId quando um download é apagado do histórico.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (downloadId: number)=>void

    • downloadId

      number