electron-dl-downloader

Electron app simple and easy to use download manager, support for multiple downloads

Why?

• Simple to use, few call parameters
• No electron window object is required
• Support for multiple downloads (Associate by url)
• Perfect compatibility with electron api

Install

1npm i electron-dl-downloader

Usage

1const Downloader = require('electron-dl-downloader');
2const dl = new Downloader({url:'https://xx.exe', filePath:'D:\\Downloads\\oo.exe'});
3//const dl = new Downloader({url:'https://xx.exe', directory:'D:\\Downloads'});
4//const dl = new Downloader({url:'https://xx.exe', directory:'D:\\Downloads', fileName:'oo.exe'});

1const item = await dl.download()
2const state = await dl.whenDone()
3
4if (state === Downloader.STATES.completed) {
5    console.log('Download successfully')
6} else {
7    console.log(`Download failed: ${state}`)
8}

Electron DownloadItem events and methods are also supported.
https://www.electronjs.org/docs/latest/api/download-item

1
2const item = await dl.download()
3
4item.on('updated', (event, state) => {
5    if (state === Downloader.STATES.interrupted) {
6        console.log('Download is interrupted but can be resumed')
7    } else if (state === Downloader.STATES.progressing) {
8        if (item.isPaused()) {
9            console.log('Download is paused')
10        } else {
11            console.log(`Received bytes: ${item.getReceivedBytes()}`)
12        }
13    }
14})
15
16item.pause()

API

It can only be used in the main process.

Class: Downloader

constructor()

constructor(params)

params: {
    url: string,
    filePath: string, //such as "D:\\Downloads\\oo.exe"
    directory: string, //such as "D:\\Downloads". default:Directory for a user's downloads.
    fileName: string, //such as "oo.exe". default:Electron downloadItem.getFilename()
    timeout: number,  //second. default 60 (Deprecated since v2.1.0)
    options: object //Electron downloadURL options
}

Instance Methods

download()

Starts a file download. Returns the DownloadItem of the download.

1download(): Promise<DownloadItem>

whenDone()

Wait for the "done" event for DownloadItem and returns state string

1whenDone(): Promise<string>

Instance Properties

url

Returns arg url

filePath

Returns arg filePath

Static Properties

STATES

Returns downloadItem state object