Socket
Socket
Sign inDemoInstall

download

Package Overview
Dependencies
93
Maintainers
4
Versions
70
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    download

Download and extract files


Version published
Weekly downloads
2.2M
increased by4.76%
Maintainers
4
Install size
1.62 MB
Created
Weekly downloads
 

Package description

What is download?

The 'download' npm package is a utility that allows you to download files over HTTP or HTTPS. It is a high-level function that abstracts away the complexity of making HTTP requests and handling streams, making it easier to download files.

What are download's main functionalities?

Downloading files

This feature allows you to download files from a given URL and save them to a specified directory. The function returns a promise that resolves when the download is complete.

const download = require('download');

download('https://example.com/somefile.png', 'dist').then(() => {
    console.log('File downloaded!');
});

Downloading and extracting archives

This feature enables the downloading of archive files like ZIP or TAR and automatically extracts them to a specified directory.

const download = require('download');

download('https://example.com/somearchive.zip', 'dist', { extract: true }).then(() => {
    console.log('Archive downloaded and extracted!');
});

Downloading files with options

This feature allows you to pass custom options such as headers, query parameters, and more, providing additional control over the HTTP request.

const download = require('download');

const options = {
    headers: { 'User-Agent': 'my-custom-agent' }
};

download('https://example.com/somefile.png', 'dist', options).then(() => {
    console.log('File downloaded with custom headers!');
});

Other packages similar to download

Readme

Source

download Build Status

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.

Keywords

FAQs

Last updated on 02 Apr 2020

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc