Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/davidedantonio/fastify-axios
Add axios http client to your fastify instance
https://github.com/davidedantonio/fastify-axios
axios axios-plugin fastify fastify-plugin nodejs nodejs-library nodejs-modules
Last synced: 4 days ago
JSON representation
Add axios http client to your fastify instance
- Host: GitHub
- URL: https://github.com/davidedantonio/fastify-axios
- Owner: davidedantonio
- License: mit
- Created: 2019-10-03T06:10:56.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-10-22T05:05:34.000Z (3 months ago)
- Last Synced: 2024-10-23T07:24:12.368Z (3 months ago)
- Topics: axios, axios-plugin, fastify, fastify-plugin, nodejs, nodejs-library, nodejs-modules
- Language: JavaScript
- Homepage:
- Size: 1010 KB
- Stars: 39
- Watchers: 2
- Forks: 4
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# fastify-axios
[](http://standardjs.com/) [](https://codecov.io/gh/davidedantonio/fastify-axios)
A plugin for Fastify that adds support for sending requests via [`axios`](https://github.com/axios/axios), a promise based HTTP(s) client for node.js and browser.
Under the hood `axios` http client is used, the options passed to register will be used as the default arguments while creating the axios http client.
## Install
```
npm install fastify-axios
```
## Default usage
Just add it to the project generated via [`fastify-cli`](https://github.com/fastify/fastify-cli) or with `register` in you application as below.
You can access the `axios` instance via fastify.axios, which can be used to send HTTP(s) requests via methods `GET`, `POST`, `PUT`, `DELETE` etc. Here a simple example
```javascript
"use strict";
module.exports = async function (fastify, opts) {
fastify.register(require("fastify-axios"));
// request via axios.get
const { data, status } = await fastify.axios.get("https://nodejs.org/en/");
console.log("body size: %d", data.length);
console.log("status: %d", status);
};
```
Alternatively you can specify default args to your axios instance. You can take a look at the default parameters here [https://github.com/axios/axios](https://github.com/axios/axios#request-config):
```javascript
"use strict";
module.exports = async function (fastify, opts) {
fastify.register(require("fastify-axios"), {
baseURL: "https://nodejs.org",
});
// request via axios.get to https://nodejs.org/en/
const { data, status } = await fastify.axios.get("/en/");
console.log("body size: %d", data.length);
console.log("status: %d", status);
};
```
## Add more clients
It's possibile to add more than one `axios` client to your fastify instance. Here's how:
```javascript
"use strict";
module.exports = async function (fastify, opts) {
fastify.register(require("fastify-axios"), {
clients: {
v1: {
baseURL: "https://v1.api.com",
headers: {
Authorization: "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJxyz",
},
},
v2: {
baseURL: "https://v2.api.com",
headers: {
Authorization: "Bearer UtOkO3UI9lPY1h3h9ygTn8pD0Va2pFDcWCNbSKlf2HE",
},
},
},
});
// Now you can use the apis in the following way
const { dataV1, statusV1 } = await fastify.axios.v1.get("/ping");
const { dataV2, statusV2 } = await fastify.axios.v2.get("/ping");
// do something with dataV1 and dataV2
};
```
## License
Licensed under [MIT](./LICENSE)