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

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

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

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.

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

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) => void

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) => void

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) => void

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) => void

    • downloadId

      número