Description

This module is an axios third-party module to log any axios request as a curl command in the console. It was originally posted as a suggestion on the axios repository, but since we believed it wasn't in the scope of axios to release such feature, we decided to make it as an independent module.

How it works

The module makes use of axios' interceptors to log the request as a cURL command. It also stores it in the response's config object. Therefore, the command can be seen in the app's console, as well as in the res.config.curlCommand property of the response.

Changing the logger

By default, axios-curlirize uses the console.log/error() functions. It is possible to change the logger by doing something similar to this:

1// when initiating your curlirize instance
2curlirize(axios, (result, err) => {
3  const { command } = result;
4  if (err) {
5    // use your logger here
6  } else {
7    // use your logger here
8  }
9});

How to use it

axios-curlirize is super easy to use. First you'll have to install it.

1npm i --save axios-curlirize@latest

Then all you have to do is import and instanciate curlirize in your app. Here's a sample:

1import axios from 'axios';
2import express from 'express';
3import curlirize from 'axios-curlirize';
4
5const app = express();
6
7// initializing axios-curlirize with your axios instance
8curlirize(axios);
9
10// creating dummy route
11app.post('/', (req, res) => {
12  res.send({ hello: 'world!' });
13});
14
15// starting server
16app.listen(7500, () => {
17  console.log('Dummy server started on port 7500');
18  /*
19             The output of this in the console will be :
20             curl -X POST -H "Content-Type:application/x-www-form-urlencoded" --data {"dummy":"data"} http://localhost:7500/
21        */
22  axios
23    .post('http://localhost:7500/', { dummy: 'data' })
24    .then(res => {
25      console.log('success');
26    })
27    .catch(err => {
28      console.log(err);
29    });
30});

Curilirize additional axios instance

To curlirize any other instances of axios (aside from the base one), please call the curlirize() method on that instance.

1const instance = axios.create({ baseURL: 'https://some-domain.com/api/', timeout: 1000, headers: {'X-Custom-Header': 'foobar'} });
2curlirize(instance);

Disable the logger

By default, all requests will be logged. But you can disable this behaviour unitarily by setting the curlirize option to false within the axios request.

1axios
2  .post('http://localhost:7500/', { dummy: 'data' }, {
3    curlirize: false
4  })
5  .then(res => {
6    console.log('success');
7  })
8  .catch(err => {
9    console.log(err);
10  });

Clear a request

1axios
2  .post('http://localhost:7500/', { dummy: 'data' })
3  .then(res => {
4    res.config.clearCurl();
5  })
6  .catch(err => {
7    console.log(err);
8  });