wonderful-fetch

Site | NPM Module | GitHub Repo

wonderful-fetch is an easy wrapper for the `fetch` api that works in Node.js and the browser!

Wonderful Fetch Works in Node AND browser environments

Yes, this module works in both Node and browser environments, including compatibility with Webpack and Browserify!

Features

• Intuitive error handling
• Download files directly to drive

Install Wonderful Fetch

Install via npm

Install with npm if you plan to use wonderful-fetch in a Node project or in the browser.

npm install wonderful-fetch

If you plan to use wonderful-fetch in a browser environment, you will probably need to use Webpack, Browserify, or a similar service to compile it.

const wonderfulFetch = require('wonderful-fetch');
wonderfulFetch();

Install via CDN

Install with CDN if you plan to use Wonderful Fetch only in a browser environment.

<script src="https://cdn.jsdelivr.net/npm/wonderful-fetch@latest/dist/index.min.js"></script>
<script type="text/javascript">
  var wonderfulFetch = WonderfulFetch;
  wonderfulFetch();
</script>

Using Wonderful Fetch

After you have followed the install step, you can start using wonderful-fetch to make requests to any URL

wonderfulFetch(url, options)

Make a request to the supplied url with options.

This library returns a Promise that will resolve if the status code is in the 200 - 299 range and will reject if the status code is outside that range or if the download of the file fails.

options

The options for wonderfulFetch(url, options) are as follows.

• url string: The URL of the resource
  • Acceptable Values: any
  • Default: null
• options object: Advanced options
  • method string: The type of request
    • Acceptable Values: get, post, delete, patch
    • Default: get
  • json boolean: Will parse the response as JSON
    • Acceptable Values: true, false
    • Default: false
  • timeout number: The request will automatically timeout after this
    • Acceptable Values: any
    • Default: 60000
  • tries number: The amount of attempts to the URL. Enter -1 for infinity.
    • Acceptable Values: any
    • Default: 1
  • cacheBreaker boolean, any: Will append ?cb={currentTime} to the URL if true or whatever value you specify.
    • Acceptable Values: true, false, any
    • Default: true
  • download string: Will download the response to this path
    • Acceptable Values: any
    • Default: null

Examples

wonderfulFetch('https://httpbin.org/status/200', {method: 'get'});

Extending Capabilities

For a more in-depth documentation of this library and the Wonderful Fetch service, please visit the official Wonderful Fetch website.

What Can Wonderful Fetch do?

Wonderful Fetch is a free fetch api that helps you make requests in Node.js or the browser.

Final Words

If you are still having difficulty, we would love for you to post a question to [the Wonderful Fetch issues page](https://github.com/itw-creative-works/Wonderful Fetch/issues). It is much easier to answer questions that include your code and relevant files! So if you can provide them, we'd be extremely grateful (and more likely to help you find the answer!)

Projects Using this Library

Somiibo: A Social Media Bot with an open-source module library.
JekyllUp: A website devoted to sharing the best Jekyll themes.
Slapform: A backend processor for your HTML forms on static sites.
SoundGrail Music App: A resource for producers, musicians, and DJs.
Hammock Report: An API for exploring and listing backyard products.

Ask us to have your project listed! :)