browser.downloads

Descripción

Usa la API de chrome.downloads para iniciar, supervisar, manipular y buscar descargas de forma programática.

Permisos

downloads

Debes declarar el permiso "downloads" en el manifiesto de la extensión para usar esta API.

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

Ejemplos

Puedes encontrar ejemplos sencillos de uso de la API de browser.downloads en el directorio examples/api/downloads. Para ver otros ejemplos y obtener ayuda para ver el código fuente, consulta Muestras.

Tipos

BooleanDelta

Propiedades

• actual

  booleano opcional

• anterior

  booleano opcional

DangerType

Enum

"file"
El nombre del archivo de la descarga es sospechoso.

"url"
Se sabe que la URL de la descarga es maliciosa.

"content"
Se sabe que el archivo descargado es malicioso.

"uncommon"
La URL de la descarga no se descarga con frecuencia y podría ser peligrosa.

"host"
La descarga provino de un host conocido por distribuir objetos binarios maliciosos y es probable que sea peligrosa.

"unwanted"
La descarga puede ser no deseada o no segura. Por ejemplo, podría realizar cambios en la configuración del navegador o de la computadora.

"safe"
La descarga no presenta ningún peligro conocido para la computadora del usuario.

"accepted"
El usuario aceptó la descarga peligrosa.

"allowlistedByPolicy"
Valores relacionados con la empresa.

"asyncScanning"

"asyncLocalPasswordScanning"

"passwordProtected"

"blockedTooLarge"

"sensitiveContentWarning"

"sensitiveContentBlock"

"deepScannedFailed"

"deepScannedSafe"

"deepScannedOpenedDangerous"

"promptForScanning"

"promptForLocalPasswordScanning"

"accountCompromise"

"blockedScanFailed"

"forceSaveToGdrive"
Para que lo use la extensión de Secure Enterprise Browser. Cuando sea necesario, Chrome bloqueará la descarga en el disco y descargará el archivo directamente en Google Drive.

"forceSaveToOnedrive"
Para usar con la extensión de Secure Enterprise Browser. Cuando sea necesario, Chrome bloqueará la descarga en el disco y descargará el archivo directamente en OneDrive.

DoubleDelta

Propiedades

• actual

  number opcional

• anterior

  number opcional

DownloadDelta

Propiedades

• canResume

  BooleanDelta opcional

  El cambio en canResume, si lo hay.

• peligro

  StringDelta opcional

  El cambio en danger, si lo hay.

• endTime

  StringDelta opcional

  El cambio en endTime, si lo hay.

• error

  StringDelta opcional

  El cambio en error, si lo hay.

• exists

  BooleanDelta opcional

  El cambio en exists, si lo hay.

• fileSize

  DoubleDelta opcional

  El cambio en fileSize, si lo hay.

• filename

  StringDelta opcional

  El cambio en filename, si lo hay.

• finalUrl

  StringDelta opcional

  Chrome 54 y versiones posteriores browser.* desde Chrome 148

  El cambio en finalUrl, si lo hay.

• id

  número

  Es el id del DownloadItem que cambió.

• mimo

  StringDelta opcional

  El cambio en mime, si lo hay.

• detenido

  BooleanDelta opcional

  El cambio en paused, si lo hay.

• startTime

  StringDelta opcional

  El cambio en startTime, si lo hay.

• state

  StringDelta opcional

  El cambio en state, si lo hay.

• totalBytes

  DoubleDelta opcional

  El cambio en totalBytes, si lo hay.

• url

  StringDelta opcional

  El cambio en url, si lo hay.

DownloadItem

Propiedades

• byExtensionId

  string opcional

  Es el identificador de la extensión que inició esta descarga, si la inició una extensión. No cambia una vez que se establece.

• byExtensionName

  string opcional

  Es el nombre localizado de la extensión que inició esta descarga, si es que la inició una extensión. Puede cambiar si la extensión cambia de nombre o si el usuario cambia de configuración regional.

• bytesReceived

  número

  Es la cantidad de bytes recibidos hasta el momento desde el host, sin tener en cuenta la compresión de archivos.

• canResume

  booleano

  Es verdadero si la descarga está en curso y en pausa, o bien si se interrumpe y se puede reanudar desde donde se interrumpió.

• peligro

  DangerType

  Indica si se cree que esta descarga es segura o se sabe que es sospechosa.

• endTime

  string opcional

  Es la hora en que finalizó la descarga en formato ISO 8601. Se puede pasar directamente al constructor de Date: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.endTime) console.log(new Date(item.endTime))})})

• error

  InterruptReason opcional

  Por qué se interrumpió la descarga Es posible que varios tipos de errores de HTTP se agrupen en uno de los errores que comienzan con SERVER_. Los errores relacionados con la red comienzan con NETWORK_, los errores relacionados con el proceso de escritura del archivo en el sistema de archivos comienzan con FILE_ y las interrupciones iniciadas por el usuario comienzan con USER_.

• estimatedEndTime

  string opcional

  Es la hora estimada en la que se completará la descarga en formato ISO 8601. Se puede pasar directamente al constructor de Date: chrome.downloads.search({}, function(items){items.forEach(function(item){if (item.estimatedEndTime) console.log(new Date(item.estimatedEndTime))})})

• exists

  booleano

  Indica si el archivo descargado aún existe. Es posible que esta información esté desactualizada porque Chrome no supervisa automáticamente la eliminación de archivos. Llama a search() para activar la verificación de la existencia del archivo. Cuando se complete la verificación de existencia, si se borró el archivo, se activará un evento onChanged. Ten en cuenta que search() no espera a que finalice la verificación de existencia antes de mostrar un resultado, por lo que es posible que los resultados de search() no reflejen con precisión el sistema de archivos. Además, se puede llamar a search() con la frecuencia que sea necesaria, pero no se verificará la existencia del archivo más de una vez cada 10 segundos.

• fileSize

  número

  Es la cantidad de bytes en todo el archivo después de la descompresión, o -1 si se desconoce.

• filename

  string

  Ruta de acceso local absoluta.

• finalUrl

  string

  Chrome 54 y versiones posteriores browser.* desde Chrome 148

  Es la URL absoluta desde la que se realiza esta descarga, después de todos los redireccionamientos.

• id

  número

  Es un identificador que persiste en todas las sesiones del navegador.

• incognito

  booleano

  Falso si esta descarga se registra en el historial; verdadero si no se registra.

• mimo

  string

  Es el tipo de MIME del archivo.

• detenido

  booleano

  Es verdadero si la descarga dejó de leer datos del host, pero mantuvo la conexión abierta.

• referente

  string

  URL absoluta.

• startTime

  string

  Es la hora en que comenzó la descarga en formato ISO 8601. Se puede pasar directamente al constructor de Date: chrome.downloads.search({}, function(items){items.forEach(function(item){console.log(new Date(item.startTime))})})

• state

  Estado

  Indica si la descarga está en curso, se interrumpió o se completó.

• totalBytes

  número

  Es la cantidad de bytes en todo el archivo, sin considerar la compresión de archivos, o -1 si se desconoce.

• url

  string

  Es la URL absoluta desde la que se inició esta descarga, antes de cualquier redireccionamiento.

DownloadOptions

Propiedades

• body

  string opcional

  Cuerpo de la publicación.

• conflictAction

  FilenameConflictAction opcional

  Es la acción que se debe realizar si filename ya existe.

• filename

  string opcional

  Es una ruta de acceso de archivo relativa al directorio de Descargas para contener el archivo descargado, que puede contener subdirectorios. Las rutas de acceso absolutas, las rutas de acceso vacías y las rutas de acceso que contienen referencias inversas ".." causarán un error. onDeterminingFilename permite sugerir un nombre de archivo después de que se hayan determinado el tipo de MIME del archivo y un nombre de archivo tentativo.

• encabezados

  HeaderNameValuePair[] opcional

  Son encabezados HTTP adicionales que se envían con la solicitud si la URL usa el protocolo HTTP[s]. Cada encabezado se representa como un diccionario que contiene las claves name y value o binaryValue, restringidas a las que permite XMLHttpRequest.

• método

  HttpMethod opcional

  Es el método HTTP que se usará si la URL utiliza el protocolo HTTP[S].

• saveAs

  booleano opcional

  Usa un selector de archivos para permitir que el usuario seleccione un nombre de archivo, independientemente de si filename está configurado o ya existe.

• url

  string

  Es la URL que se descargará.

DownloadQuery

Propiedades

• bytesReceived

  number opcional

  Es la cantidad de bytes recibidos hasta el momento desde el host, sin tener en cuenta la compresión de archivos.

• peligro

  DangerType opcional

  Indica si se cree que esta descarga es segura o se sabe que es sospechosa.

• endTime

  string opcional

  Es la hora en que finalizó la descarga en formato ISO 8601.

• endedAfter

  string opcional

  Limita los resultados a DownloadItem que finalizaron después de los ms indicados en formato ISO 8601

• endedBefore

  string opcional

  Limita los resultados a DownloadItem que finalizaron antes de los milisegundos indicados en formato ISO 8601.

• error

  InterruptReason opcional

  Por qué se interrumpió una descarga

• exists

  booleano opcional

  Si el archivo descargado existe

• fileSize

  number opcional

  Es la cantidad de bytes en todo el archivo después de la descompresión, o -1 si se desconoce.

• filename

  string opcional

  Ruta de acceso local absoluta.

• filenameRegex

  string opcional

  Limita los resultados a DownloadItem cuyo filename coincida con la expresión regular determinada.

• finalUrl

  string opcional

  Chrome 54 y versiones posteriores browser.* desde Chrome 148

  Es la URL absoluta desde la que se realiza esta descarga, después de todos los redireccionamientos.

• finalUrlRegex

  string opcional

  Chrome 54 y versiones posteriores browser.* desde Chrome 148

  Limita los resultados a DownloadItem cuyo finalUrl coincida con la expresión regular determinada.

• id

  number opcional

  El id del DownloadItem que se consultará.

• límite

  number opcional

  Es la cantidad máxima de DownloadItem coincidentes que se devuelven. La configuración predeterminada es 1,000. Establece el valor en 0 para que se devuelvan todos los DownloadItem que coincidan. Consulta search para obtener información sobre cómo desplazarte por los resultados.

• mimo

  string opcional

  Es el tipo de MIME del archivo.

• orderBy

  string[] opcional

  Establece los elementos de este array en propiedades DownloadItem para ordenar los resultados de la búsqueda. Por ejemplo, si configuras orderBy=['startTime'], se ordenan los DownloadItem por su hora de inicio en orden ascendente. Para especificar el orden descendente, agrega un guion como prefijo: '-startTime'.

• detenido

  booleano opcional

  Es verdadero si la descarga dejó de leer datos del host, pero mantuvo la conexión abierta.

• consulta

  string[] opcional

  Este array de términos de búsqueda limita los resultados a DownloadItem cuyos filename, url o finalUrl contienen todos los términos de búsqueda que no comienzan con un guion "-" y ninguno de los términos de búsqueda que sí comienzan con un guion.

• startTime

  string opcional

  Es la hora en que comenzó la descarga en formato ISO 8601.

• startedAfter

  string opcional

  Limita los resultados a DownloadItem que comenzaron después de los ms dados en formato ISO 8601.

• startedBefore

  string opcional

  Limita los resultados a DownloadItem que comenzaron antes de los ms indicados en formato ISO 8601.

• state

  State opcional

  Indica si la descarga está en curso, se interrumpió o se completó.

• totalBytes

  number opcional

  Es la cantidad de bytes en todo el archivo, sin considerar la compresión de archivos, o -1 si se desconoce.

• totalBytesGreater

  number opcional

  Limita los resultados a DownloadItem cuyo totalBytes sea mayor que el número entero proporcionado.

• totalBytesLess

  number opcional

  Limita los resultados a DownloadItem cuyo totalBytes sea menor que el número entero proporcionado.

• url

  string opcional

  Es la URL absoluta desde la que se inició esta descarga, antes de cualquier redireccionamiento.

• urlRegex

  string opcional

  Limita los resultados a DownloadItem cuyo url coincida con la expresión regular determinada.

FilenameConflictAction

uniquify

Para evitar la duplicación, se cambia el filename para incluir un contador antes de la extensión del nombre de archivo.

reemplazar

El archivo existente se reemplazará por el nuevo.

instrucción

Se le mostrará al usuario un diálogo de selección de archivos.

Enum

"uniquify"

"overwrite"

"prompt"

FilenameSuggestion

Propiedades

• conflictAction

  FilenameConflictAction opcional

  Es la acción que se debe realizar si filename ya existe.

• filename

  string

  El nuevo destino DownloadItem.filename de DownloadItem, como una ruta de acceso relativa al directorio de descargas predeterminado del usuario, que puede contener subdirectorios. Se ignorarán las rutas de acceso absolutas, las rutas de acceso vacías y las rutas de acceso que contengan referencias inversas "..". filename se ignora si hay objetos de escucha onDeterminingFilename registrados por alguna extensión.

GetFileIconOptions

Propiedades

• tamaño

  number opcional

  Es el tamaño del ícono que se muestra en píxeles independientes de la densidad (DIP). Debe ser 16 o 32 (el valor predeterminado es 32). En las pantallas con valores altos de DPI, la imagen que se muestra se ajusta según el factor de escala del dispositivo (p.ej., 64 x 64 px para el tamaño 32 en una pantalla de 2x). Las llamadas de los service workers en segundo plano se establecen de forma predeterminada en una escala de 1x.

HeaderNameValuePair

Propiedades

• nombre

  string

  Es el nombre del encabezado HTTP.

• valor

  string

  Es el valor del encabezado 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

La descarga está recibiendo datos del servidor.

interrumpida

Se produjo un error que interrumpió la conexión con el host del archivo.

complete

La descarga se completó correctamente.

Enum

"in_progress"

"interrupted"

"complete"

StringDelta

Propiedades

• actual

  string opcional

• anterior

  string opcional

UiOptions

Chrome 105 y versiones posteriores browser.* desde Chrome 148

Propiedades

• habilitado

  booleano

  Habilita o inhabilita la IU de descarga.

Métodos

acceptDanger()

browser.downloads.acceptDanger(
  downloadId: number,
): Promise<void>

Solicita al usuario que acepte una descarga peligrosa. Solo se puede llamar desde un contexto visible (pestaña, ventana o ventana emergente de acción de página o navegador). No acepta automáticamente descargas peligrosas. Si se acepta la descarga, se activará un evento onChanged; de lo contrario, no sucederá nada. Cuando todos los datos se recuperan en un archivo temporal y la descarga no es peligrosa o se aceptó el peligro, se cambia el nombre del archivo temporal al nombre de archivo de destino, el state cambia a "complete" y se activa onChanged.

Parámetros

• downloadId

  número

  Es el identificador de DownloadItem.

Muestra

• Promise<void>

  Chrome 96 y versiones posteriores browser.* desde Chrome 148

  Devuelve una promesa que se resuelve cuando se cierra el diálogo de mensaje de peligro.

cancel()

browser.downloads.cancel(
  downloadId: number,
): Promise<void>

Cancelar una descarga Cuando se ejecuta callback, la descarga se cancela, se completa, se interrumpe o ya no existe.

Parámetros

• downloadId

  número

  Es el ID de la descarga que se cancelará.

Muestra

• Promise<void>

  Chrome 96 y versiones posteriores browser.* desde Chrome 148

  Devuelve una promesa que se resuelve cuando se completa la solicitud de cancelación.

download()

browser.downloads.download(
  options: DownloadOptions,
): Promise<number>

Descargar una URL Si la URL usa el protocolo HTTP[S], la solicitud incluirá todas las cookies configuradas actualmente para su nombre de host. Si se especifican filename y saveAs, se mostrará el cuadro de diálogo Guardar como, completado previamente con el filename especificado. Si la descarga se inició correctamente, se llamará a callback con el downloadId del nuevo DownloadItem. Si se produjo un error al iniciar la descarga, se llamará a callback con downloadId=undefined y runtime.lastError contendrá una cadena descriptiva. No se garantiza que las cadenas de error sigan siendo retrocompatibles entre las versiones. Las extensiones no deben analizarlo.

Parámetros

• opciones

  DownloadOptions

  Qué descargar y cómo hacerlo

Muestra

• Promise<number>

  Chrome 96 y versiones posteriores browser.* desde Chrome 148

  Devuelve una promesa que se resuelve con el ID del nuevo DownloadItem.

erase()

browser.downloads.erase(
  query: DownloadQuery,
): Promise<number[]>

Borra las coincidencias de DownloadItem del historial sin borrar el archivo descargado. Se activará un evento onErased para cada DownloadItem que coincida con query y, luego, se llamará a callback.

Parámetros

• consulta

  DownloadQuery

Muestra

• Promise<number[]>

  Chrome 96 y versiones posteriores browser.* desde Chrome 148

getFileIcon()

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

Recupera un ícono para la descarga especificada. En el caso de las descargas nuevas, los íconos de archivo están disponibles después de que se determina el nombre de archivo de destino de la descarga (por ejemplo, cuando se activa onChanged con un cambio de filename). Si se intenta recuperar el ícono antes de que se determine el nombre del archivo, se producirá un error a través de runtime.lastError. La imagen que devuelve esta función mientras se realiza una descarga puede ser diferente de la que se devuelve una vez que se completa la descarga. La recuperación de íconos se realiza consultando el sistema operativo o el kit de herramientas subyacente, según la plataforma. Por lo tanto, el ícono que se devuelve dependerá de varios factores, como el estado de la descarga, la plataforma, los tipos de archivos registrados y el tema visual. Si no se puede determinar el ícono de un archivo, runtime.lastError contendrá un mensaje de error.

Parámetros

• downloadId

  número

  Es el identificador de la descarga.

• opciones

  GetFileIconOptions opcional

Muestra

• Promise<string | undefined>

  Chrome 96 y versiones posteriores browser.* desde Chrome 148

  Devuelve una promesa que se resuelve con una URL a una imagen que representa la descarga.

open()

browser.downloads.open(
  downloadId: number,
): Promise<void>

Abre el archivo descargado ahora si se completó la DownloadItem; de lo contrario, devuelve un error a través de runtime.lastError. Este método requiere el permiso "downloads.open", además del permiso "downloads". Se activa un evento onChanged cuando se abre el elemento por primera vez. Solo se puede llamar a este método en respuesta a un gesto del usuario.

Parámetros

• downloadId

  número

  Es el identificador del archivo descargado.

Muestra

• Promise<void>

  Chrome 123 y versiones posteriores browser.* desde Chrome 148

pause()

browser.downloads.pause(
  downloadId: number,
): Promise<void>

Pausar la descarga Si la solicitud se realizó correctamente, la descarga se encuentra en estado de pausa. De lo contrario, runtime.lastError contiene un mensaje de error. La solicitud fallará si la descarga no está activa.

Parámetros

• downloadId

  número

  Es el ID de la descarga que se pausará.

Muestra

• Promise<void>

  Chrome 96 y versiones posteriores browser.* desde Chrome 148

  Devuelve una promesa que se resuelve cuando se completa la solicitud de pausa.

removeFile()

browser.downloads.removeFile(
  downloadId: number,
): Promise<void>

Quita el archivo descargado si existe y se completó la DownloadItem; de lo contrario, devuelve un error a través de runtime.lastError.

Parámetros

• downloadId

  número

Muestra

• Promise<void>

  Chrome 96 y versiones posteriores browser.* desde Chrome 148

resume()

browser.downloads.resume(
  downloadId: number,
): Promise<void>

Reanuda una descarga pausada. Si la solicitud se realizó correctamente, la descarga estará en curso y se reanudará. De lo contrario, runtime.lastError contiene un mensaje de error. La solicitud fallará si la descarga no está activa.

Parámetros

• downloadId

  número

  Es el ID de la descarga que se reanudará.

Muestra

• Promise<void>

  Chrome 96 y versiones posteriores browser.* desde Chrome 148

  Devuelve una promesa que se resuelve cuando se completa la solicitud de reanudación.

search()

browser.downloads.search(
  query: DownloadQuery,
): Promise<DownloadItem[]>

Busca DownloadItem. Establece query en el objeto vacío para obtener todos los DownloadItem. Para obtener un DownloadItem específico, establece solo el campo id. Para paginar una gran cantidad de elementos, establece orderBy: ['-startTime'], establece limit en la cantidad de elementos por página y establece startedAfter en el startTime del último elemento de la última página.

Parámetros

• consulta

  DownloadQuery

Muestra

• Promise<DownloadItem[]>

  Chrome 96 y versiones posteriores browser.* desde Chrome 148

setShelfEnabled()

Obsoleto desde Chrome 117

browser.downloads.setShelfEnabled(
  enabled: boolean,
): void

En su lugar, usa setUiOptions.

Habilita o inhabilita la barra gris que aparece en la parte inferior de cada ventana asociada con el perfil actual del navegador. La biblioteca se inhabilitará siempre que al menos una extensión la haya inhabilitado. Si se habilita la biblioteca mientras al menos otra extensión la tiene inhabilitada, se mostrará un error a través de runtime.lastError. Requiere el permiso "downloads.shelf" además del permiso "downloads".

Parámetros

• habilitado

  booleano

setUiOptions()

Chrome 105 y versiones posteriores browser.* desde Chrome 148

browser.downloads.setUiOptions(
  options: UiOptions,
): Promise<void>

Cambia la IU de descarga de cada ventana asociada con el perfil del navegador actual. Siempre que al menos una extensión haya establecido UiOptions.enabled como falso, se ocultará la IU de descarga. Si se establece UiOptions.enabled como verdadero mientras al menos otra extensión lo inhabilitó, se mostrará un error a través de runtime.lastError. Requiere el permiso "downloads.ui" además del permiso "downloads".

Parámetros

• opciones

  UiOptions

  Encapsula un cambio en la IU de descarga.

Muestra

• Promise<void>

  Devuelve una promesa que se resuelve cuando se completa la actualización de la IU.

show()

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

Muestra el archivo descargado en su carpeta en un administrador de archivos.

Parámetros

• downloadId

  número

  Es el identificador del archivo descargado.

showDefaultFolder()

browser.downloads.showDefaultFolder(): void

Muestra la carpeta Descargas predeterminada en un administrador de archivos.

Eventos

onChanged

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

Cuando cambia cualquiera de las propiedades de un DownloadItem, excepto bytesReceived y estimatedEndTime, se activa este evento con el downloadId y un objeto que contiene las propiedades que cambiaron.

Parámetros

• callback

  función

  El parámetro callback se ve de la siguiente manera:

  (downloadDelta: DownloadDelta) =& gt;void

  • downloadDelta

    DownloadDelta

onCreated

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

Este evento se activa con el objeto DownloadItem cuando comienza una descarga.

Parámetros

• callback

  función

  El parámetro callback se ve de la siguiente manera:

  (downloadItem: DownloadItem) =& gt;void

  • downloadItem

    DownloadItem

onDeterminingFilename

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

Durante el proceso de determinación del nombre de archivo, las extensiones tendrán la oportunidad de anular el DownloadItem.filename de destino. Cada extensión no puede registrar más de un objeto de escucha para este evento. Cada objeto de escucha debe llamar a suggest exactamente una vez, ya sea de forma síncrona o asíncrona. Si el objeto de escucha llama a suggest de forma asíncrona, debe devolver true. Si el objeto de escucha no llama a suggest de forma síncrona ni devuelve true, se llamará a suggest automáticamente. El DownloadItem no se completará hasta que todos los objetos de escucha hayan llamado a suggest. Los objetos de escucha pueden llamar a suggest sin argumentos para permitir que la descarga use downloadItem.filename como nombre de archivo o pasar un objeto suggestion a suggest para anular el nombre de archivo de destino. Si más de una extensión anula el nombre de archivo, gana la última extensión instalada cuyo objeto de escucha pasa un objeto suggestion a suggest. Para evitar confusiones sobre qué extensión prevalecerá, los usuarios no deben instalar extensiones que puedan entrar en conflicto. Si la descarga se inicia con download y se conoce el nombre de archivo de destino antes de que se determinen el tipo de MIME y el nombre de archivo tentativo, pasa filename a download.

Parámetros

• callback

  función

  El parámetro callback se ve de la siguiente manera:

  (downloadItem: DownloadItem, suggest: function) =& gt;void

  • downloadItem

    DownloadItem

  • suggest

    función

    El parámetro suggest se ve de la siguiente manera:

    (suggestion?: FilenameSuggestion) =& gt;void

    • sugerencia

      FilenameSuggestion opcional

onErased

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

Se activa con el downloadId cuando se borra una descarga del historial.

Parámetros

• callback

  función

  El parámetro callback se ve de la siguiente manera:

  (downloadId: number) =& gt;void

  • downloadId

    número