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 recenteA mudança em
finalUrl
, se houver. -
id
number
O
id
doDownloadItem
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
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 comNETWORK_
, os erros relacionados ao processo de gravação do arquivo no sistema de arquivos começam comFILE_
e as interrupções iniciadas pelo usuário começam comUSER_
. -
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 eventoonChanged
será disparado. Observe quesearch
() não espera a conclusão da verificação de existência antes de retornar. Por isso, os resultados desearch
() 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 recenteO 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
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
evalue
oubinaryValue
, 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 quefilename
corresponde à expressão regular em questão. -
finalUrl
string opcional
Chrome 54 ou mais recenteO URL absoluto do qual este download está sendo feito, depois de todos os redirecionamentos.
-
finalUrlRegex
string opcional
Chrome 54 ou mais recenteLimita os resultados a
DownloadItem
, em quefinalUrl
corresponde à expressão regular em questão. -
id
número opcional
O
id
doDownloadItem
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 osDownloadItem
correspondentes. Consultesearch
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, definirorderBy=['startTime']
classifica asDownloadItem
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 quefilename
,url
oufinalUrl
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 quetotalBytes
é maior que o número inteiro fornecido. -
totalBytesLess
número opcional
Limita os resultados a
DownloadItem
, em quetotalBytes
é 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 queurl
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
doDownloadItem
, 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. Ofilename
será ignorado se houver algum listeneronDeterminingFilename
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
-
nome
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
Propriedades
-
ativado
boolean
Ative ou desative a interface de download.
Métodos
acceptDanger()
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 recentePromessas 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()
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 recentePromessas 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()
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.
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 recentePromessas 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()
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
-
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 recentePromessas 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()
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
-
Promise<string | undefined>
Chrome 96 ou mais recentePromessas 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()
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 recenteO parâmetro
callback
tem esta aparência:() => void
Retorna
-
Promise<void>
Chrome 123 ou mais recentePromessas 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()
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 recentePromessas 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()
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 recentePromessas 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()
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 recentePromessas 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.
search()
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
-
consulta
-
callback
função optional
O parâmetro
callback
tem esta aparência:(results: DownloadItem[]) => void
-
resultados
-
Retorna
-
Promise<DownloadItem[]>
Chrome 96 ou mais recentePromessas 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()
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()
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.
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
-
callback
função
O parâmetro
callback
tem esta aparência:(downloadDelta: DownloadDelta) => void
-
downloadDelta
-
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
-
downloadItem
-
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
-
callback
função
O parâmetro
callback
tem esta aparência:(downloadItem: DownloadItem, suggest: function) => void
-
downloadItem
-
suggest
função
O parâmetro
suggest
tem esta aparência:(suggestion?: FilenameSuggestion) => void
-
sugestão
FilenameSuggestion opcional
-
-
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
-