getfile-wo v8.1.0

download-wo (download without overwriting)

Download and extract files without overwriting by renaming them. Forked from https://github.com/kevva/download.

:warning: Not extensively tested !!

Install

$ npm install getfile-wo

Usage

const fs = require('fs');
const download = require('getfile-wo');

(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.

decode

Type: boolean Default: true

Enable URI decoding for more readable file name (e.g replaces "%20" with space).