download-in-browser

0.2.0 • Public • Published

download-in-browser

Travis NPM

download-in-browser allows you to initiate a file download from your browser's current window and then respond using a Promise.

Installation

npm install download-in-browser

Usage

Download

Download a file by URL, with an optional fileName param. It will make an XMLHttpRequest GET request in order to grab the response headers from the URL.

After receiving the headers, the download function will abort the request (so as to not begin streaming the download) and respond with a Promise that will be resolved or rejected with the following properties from the XMLHttpRequest object, depending on the response status,

{
  status: xhr.status,
  statusText: xhr.statusText
}

At the same time the Promise is dispatched and if the GET request was successful, an invisible link will be created and then followed, initiating the download.

Example,

const download = require("download-in-browser")
 
download("https://github.com/ezekg/download-in-browser/blob/master/README.md", "readme.md")
  .then((data) => console.log(`${data.statusText}: Download has started...`))
  .catch((err) => console.log(`${err.statusText}: Download failed to start`))

License

MIT © Ezekiel Gabrielse

Readme

Keywords

Package Sidebar

Install

npm i download-in-browser

Weekly Downloads

114

Version

0.2.0

License

MIT

Unpacked Size

35.8 kB

Total Files

7

Last publish

Collaborators

  • ezekg