Skip to content

Yet another fetch is a backward compatible, dependency free, drop-in wrapper for fetch API

License

Notifications You must be signed in to change notification settings

chickencoding123/yafetch

Repository files navigation

Yet another fetch is a dependency free HTTP client wrapper for node.js and browser

npm License bundle size

Features

  • Plugins for various features such as retries, error handling, logging, parsing etc...
  • Defaults to fetch as HTTP client, but can be used with any HTTP client such as node-fetch
  • Automated parsing of request/response data
  • Global options
  • ... and more

How to use

npm i @yafetch/core --save
# or
yarn add @yafetch/core --save

Usage is mostly similar to fetch API:

import yafetch from '@yafetch/core'
const html = await yafetch('https://www.example.com') // as opposed to fetch('https://www.example.com')

yafetch automatically converts body to URLSearchParams for GET requests:

import yafetch from '@yafetch/core'
const html = await yafetch('https://www.example.com', { body: { name: 'john' } }) // will send https://www.example.com/?name=john

Plugins

The most powerful aspect of yafetch is its plugin system, allowing full control over the API calls. There are three types of plugins categorized by their execution order relative to the main API call, "before" and "after" plugins run before or after the API request while "wrap" plugins will wrap the API call itself. These wrap plugins also wrap each other allowing for communication between multiple plugins and advanced scenarios such as retries, error handling etc...

Custom HTTP client implementation

Yafetch you can provide an alternative proxy function to use instead when running in a non-browser environment such as node.js. To use this feature simply pass a fetchProxy in the options, from there it's up to you how the API call happens. See an example of this in tests under the core package.

Contribution

Please make sure to read the Contributing Guide before you work on this project.

License

MIT

About

Yet another fetch is a backward compatible, dependency free, drop-in wrapper for fetch API

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages