zs-extract/README.md

# zs-extract

Zippyshare download data extractor

[![npm](https://img.shields.io/npm/v/zs-extract.svg)](https://npmjs.com/package/zs-extract)
[![node](https://img.shields.io/node/v/zs-extract.svg)](https://nodejs.org)

[![dependencies](https://david-dm.org/JrMasterModelBuilder/zs-extract.svg)](https://david-dm.org/JrMasterModelBuilder/zs-extract)
[![size](https://packagephobia.now.sh/badge?p=zs-extract)](https://packagephobia.now.sh/result?p=zs-extract)
[![downloads](https://img.shields.io/npm/dm/zs-extract.svg)](https://npmcharts.com/compare/zs-extract?minimal=true)

[![travis-ci](https://travis-ci.org/JrMasterModelBuilder/zs-extract.svg?branch=master)](https://travis-ci.org/JrMasterModelBuilder/zs-extract)


# Overview

This module simplifies extracting download info from a Zippyshare link. Instead of parsing their ever-changing JavaScript for the variables to compute the download URL, this module uses Node's VM functionality to safely emulate a browser in a sandboxed environment, making it much more resilient to changes in the obfuscated download link generation code.


# Usage

```js
import zsExtract from 'zs-extract';

const info = await zsExtract.extract('https://www109.zippyshare.com/v/EXfrFTJo/file.html');

console.log(info); // { download: 'https://www109.zippyshare.com/d/EXfrFTJo/816592/jmmb%20avatar.png', filename: 'jmmb avatar.png' }
```


# Bugs

If you find a bug or have compatibility issues, please open a ticket under issues section for this repository.


# License

Copyright (c) 2019-2020 JrMasterModelBuilder

Licensed under the Mozilla Public License, v. 2.0.

If this license does not work for you, feel free to contact me.