wretch
A tiny wrapper built around fetch with an intuitive syntax.
MIT License
Bot releases are hidden (Show)
2.8.1 (2024-03-07)
π Bug fix(es)
export const apiClient = wretch('https://localhost:3000')
.addon(QueryStringAddon)
.resolve((chain) => {
return chain.unauthorized((_error, request) => {
// request type used to be wrong (missing .query() from the addon)
// and it would clash with what was expected by the callback definition
// now the type should be correct β¨
return request
.fetch()
.unauthorized((error) => {
throw error;
})
.json();
});
});
β¬οΈ Version update(s)
- Bump follow-redirects from 1.15.1 to 1.15.4 (04fada6)
wretch
- 2.8.0
Published by elbywan 10 months ago
2.8.0 (2023-12-30)
π New feature(s)
const fetcher = wretch("https://jsonplaceholder.typicode.com").addon({
// resolver can now be a function and to re-use the previously defined methods of the response chain:
resolver: (chain) => ['res', 'json', 'text', 'blob', 'formData', 'arrayBuffer'].reduce((acc, method) => ({
...acc,
// overrides .json, .text⦠methods to chain .then & .catch
[method](cb) {
return chain[method](cb)
.then(ret => (console.log('[hook] ok')))
.catch(error => {
console.error('[hook] error', error.response.url, error.response.status)
throw error
});
}
}), {})
});
(async function () {
await fetcher.get("/todos/1").json(console.log);
console.log("-----");
// { userId: 1, id: 1, title: 'delectus aut autem', completed: false }
// [hook] ok
// -----
await fetcher.get("/bad-route").notFound(error => {
console.log('handled error :)')
}).text(console.log);
console.log("-----");
// handled error :)
// [hook] ok
// -----
await fetcher.get("/bad-route").text(console.log).catch(() => console.log('unhandled error :('));
// [hook] error https://jsonplaceholder.typicode.com/bad-route 404
// unhandled error :(
})()
wretch
- 2.7.1
Published by elbywan 11 months ago
2.7.1 (2023-11-19)
π Bug fix(es)
const headers1 = new Headers({ "hello": "world" });
const headers2 = new Headers({ "bonjour": "le monde" });
const headers3 = { "hola": "mundo " };
const headers4 = [["hallo", "welt"]]
let w = wretch().headers(headers1);
console.log(w._options.headers);
// Object { hello: "world" }
w = w.headers(headers2);
console.log(w._options.headers);
// Object { hello: "world", bonjour: "le monde" }
w = w.headers(headers3);
console.log(w._options.headers);
// Object { hello: "world", bonjour: "le monde", hola: "mundo " }
w = w.headers(headers4);
console.log(w._options.headers);
// Object { hello: "world", bonjour: "le monde", hola: "mundo ", hallo: "welt" }
β¬οΈ Version update(s)
wretch
- 2.7.0
Published by elbywan about 1 year ago
2.7.0 (2023-09-12)
π New feature(s)
<head>
<script type="module">
import wretch from 'https://cdn.skypack.dev/wretch';
import FormDataAddon from 'https://cdn.skypack.dev/wretch/addons/formData';
const fileInput = document.querySelector("#myfiles");
fileInput.addEventListener("change", () => {
wretch("/post-files")
.addon(FormDataAddon)
.formData({ files: fileInput.files })
.post()
.text(console.log)
});
</script>
</head>
<body>
<input id="myfiles" multiple type="file" />
</body>
π Documentation update(s)
wretch
- 2.6.0
Published by elbywan over 1 year ago
2.6.0 (2023-06-28)
β¬οΈ Version update(s)
- Bump engine.io and socket.io (3ef1738)
- Bump socket.io-parser from 4.2.2 to 4.2.3 (b42aa0f)
- Upgrade dependencies (b183cf7)
π New feature(s)
wretch(url)
.catcher(404, err => redirect("/routes/notfound", err.message))
.catcher(500, err => flashMessage("internal.server.error"))
// this fallback will trigger for any error except if already caught by other means (like above for 404s and 505s)
.catcherFallback(err => {
log("Uncaught error:", err)
throw err
})
π Documentation update(s)
wretch
- 2.5.2
Published by elbywan over 1 year ago
wretch
- 2.5.0
Published by elbywan over 1 year ago
2.5.0 (2023-02-20)
π New feature(s)
Setting the error type as json manually using .errorType("json") should now not be necessary if the server responds with a Content-Type header set as application/json.
The response body will be deserialized and the error.json will be set accordingly.
β¬οΈ Version update(s)
wretch
- 2.3.2
Published by elbywan almost 2 years ago
2.3.2 (2023-01-11)
π Bug fix(es)
Allows defining global error catchers using resolvers:
const request = wretch(baseURL)
.errorType("json")
.resolve((response) => {
return (
response
.error("Error", (error) => {
console.log("global catch (Error class)");
})
.error("TypeError", (error) => {
console.log("global type error catch (TypeError class)");
})
);
});
await request
.get(`/carts/v3/${cartId}/payment/modes`)
// Will override the global catcher now thanks to this fix.
.notFound((error) => {
console.log("not found");
})
.json();
wretch
- 2.2.0
Published by elbywan almost 2 years ago
2.2.0 (2022-12-03)
π New feature(s)
Add progress addon (2bae524), closes #154
Wretch now accepts a callback to monitor download progress.
import ProgressAddon from "wretch/addons/progress"
wretch("some_url")
// Register the addon
.addon(ProgressAddon())
.get()
// Log the progress as a percentage of completion
.progress((loaded, total) => console.log(`${(loaded / total * 100).toFixed(0)}%`))
β¬οΈ Version update(s)
- Bump dependencies including outdated rollup plugins (bcbcdc5)
- Bump engine.io from 6.2.0 to 6.2.1 (6a93854)
- Bump fastify from 4.9.2 to 4.10.2 (8ae9122)
π¨ Code improvement(s)
- Add a prepare script (17b0a76)
π Bug fix(es)
- Fix a minor Wretch type issue in addons (23ba7b1)
Package Rankings
Top 1.36% on Npmjs.org