download ![Build Status](https://camo.githubusercontent.com/5a79d3a029c2428962623ad5e19f27f7ed822a877562530616020b5a44cb0f3a/68747470733a2f2f7472617669732d63692e6f72672f6b657676612f646f776e6c6f61642e7376673f6272616e63683d6d6173746572)
Download and extract files
See download-cli for the command-line version.
Install
$ npm install download
Usage
const fs = require('fs');
const download = require('download');
(async () => {
await download('http://unicorn.com/foo.jpg', 'dist');
fs.writeFileSync('dist/foo.jpg', await download('http://unicorn.com/foo.jpg'));
download('unicorn.com/foo.jpg').pipe(fs.createWriteStream('dist/foo.jpg'));
await Promise.all([
'unicorn.com/foo.jpg',
'cats.com/dancing.gif'
].map(url => download(url, 'dist')));
})();
Proxies
To work with proxies, read the got documentation
.
API
download(url, destination?, options?)
Returns both a Promise<Buffer>
and a Duplex stream with additional events.
url
Type: string
URL to download.
destination
Type: string
Path to where your file will be written.
options
Type: Object
Same options as got
and decompress
in addition to the ones below.
extract
Type: boolean
Default: false
If set to true
, try extracting the file using decompress
.
filename
Type: string
Name of the saved file.