v6.0.0
a fetch wrapper that supports interceptors, JSON body, retry, timeout and many many more ...
Repository
Current version released
2 years ago
Dependencies
std
deno-fetch-goody
This library offers a fetch wrapper that can:
- automatically add
Content-Type
header - directly use objects for
body
as json (see below) - send
form
,formData
,qs
(query string) easily from objects - accept a timeout option and abort when timeout is reached
- add
Accept
header with valueapplication/json, text/plain, */*
if not already set by you - set global headers when creating the wrapper
- set a
baseURL
when creating the wrapper - add
interceptors
when creating the wrapper or for individual requests
Deno v1.11+ is required.
usage
you can import wrapFetch
from mod.ts
file.
export { wrapFetch } from 'https://deno.land/x/fetch_goody@v6.0.0/mod.ts';
wrapFetch
// this simple
const wrappedfetch = wrapFetch();
Or
// you can also pass your own wrapped fetch function, allowing for wrapping fetch multiple times
const wrappedfetch = wrapFetch({ fetch: yourFetch });
You can also add global interceptors:
const wrappedfetch = wrapFetch({
interceptors: {
request(init: ExtendedRequest) {
// add some header before each request is sent
// for example add some headers from your cookie-jar
},
}
});
using the new wrappedfetch
// for sending a multipart/form-data body now you should use `formData`.
const resp1 = await wrappedfetch("url",{
form: {
'foo': 'bar'
}
}); // sets method to POST by default and converts object to application/x-www-form-urlencoded.
// or
const resp2 = await wrappedfetch("url",{
body: {
'foo': 'bar'
}
}); // is sent as json and corresponding header is set
// also if method is not defined for this, it will be set as POST
// other features:
// adding query string
const resp3 = await wrappedfetch("url",{
qs: {
'foo': 'bar'
}
}); // results to url being sent to be "url?foo=bar"
// adding interceptors where you can throw errors and other stuff
const resp4 = await wrappedfetch("url",{
interceptors: {
response(init: ExtendedRequest, response: Response) {
if (response.status > 200) {
throw new Error('yada');
}
},
}
});
test
fetch wrapper tests require network access to emulate server.
run with deno test --allow-net