# axios-better-stacktrace > Axios plugin that provides better stack traces for axios errors Latest version **2.1.7** (published 2024-07-26) · MIT license · 0 weekly downloads ## Install ```sh npm install axios-better-stacktrace pnpm add axios-better-stacktrace yarn add axios-better-stacktrace bun add axios-better-stacktrace ``` ## Health **Score 30/100 (F)** — status: abandoned. Positive: has types; esm support; no vulnerabilities; high quality score. Warnings: low downloads. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 2.1.7 | | Published | 2024-07-26 | | First published | 2020-12-03 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Dependencies | 0 | | Unpacked size | 39.3 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 52 | | Author | Svyatoslav Sobol | | Maintainers | svsool | | Keywords | axios, axios-plugin, plugin, stacktrace, stack, trace, error | ## Links - npm: https://www.npmjs.com/package/axios-better-stacktrace - Repository: https://github.com/svsool/axios-better-stacktrace - Homepage: https://github.com/svsool/axios-better-stacktrace#readme - Issues: https://github.com/svsool/axios-better-stacktrace/issues - npm.io page: https://npm.io/package/axios-better-stacktrace ## Alternatives - [@sentry/react-native](https://npm.io/package/@sentry/react-native.md) — 2.6M weekly downloads - [@ardatan/aggregate-error](https://npm.io/package/@ardatan/aggregate-error.md) — 708.1K weekly downloads - [custom-error-generator](https://npm.io/package/custom-error-generator.md) — 2.0K weekly downloads - [@technik-sde/prosemirror-recreate-transform](https://npm.io/package/@technik-sde/prosemirror-recreate-transform.md) — 1.5K weekly downloads - [@suchipi/error-utils](https://npm.io/package/@suchipi/error-utils.md) — 78 weekly downloads ## Recent versions - 2.1.7 (latest) — 2024-07-26 - 2.1.6 — 2023-11-19 - 2.1.5 — 2023-02-10 - 2.1.4 — 2023-02-10 - 2.1.3 — 2022-10-11 - 2.1.2 — 2021-12-12 - 2.1.1 — 2021-03-13 - 2.1.0 — 2021-03-10 - 2.0.2 — 2021-02-14 - 2.0.1 — 2021-02-14 - 2.0.0 — 2021-02-14 - 1.2.0 — 2021-02-07 - 1.1.0 — 2020-12-03 ## README # axios-better-stacktrace Axios plugin that provides better stack traces for axios errors. Check [this axios issue](https://github.com/axios/axios/issues/2387) for more details. [![npm](https://img.shields.io/npm/v/axios-better-stacktrace.svg?label=npm%20package)](https://www.npmjs.com/package/axios-better-stacktrace) [![npm](https://img.shields.io/npm/dt/axios-better-stacktrace.svg)](https://www.npmjs.com/package/axios-better-stacktrace) [![ci](https://github.com/svsool/axios-better-stacktrace/workflows/CI/badge.svg?branch=main)](https://github.com/svsool/axios-better-stacktrace/actions/workflows/ci.yml?query=branch%3Amain) [![npm](https://img.shields.io/npm/l/axios-better-stacktrace.svg)](https://choosealicense.com/licenses/mit) ## Installation NPM ```bash npm install axios-better-stacktrace ``` Yarn ```bash yarn add axios-better-stacktrace ``` ### Note It was tested with `axios 0.21.0`. ## Usage ```js // CommonJS // const axiosBetterStacktrace = require('axios-better-stacktrace').default; // ES6 import axiosBetterStacktrace from 'axios-better-stacktrace'; // use it before any other interceptors axiosBetterStacktrace(axiosAgent); // when using promises response error will get an enhanced stack trace automatically axiosAgent.get('https://npmjs.com//').catch(enhancedError => console.error(enhancedError)); // or using async/await (async () => { try { await axiosAgent.get('https://npmjs.com//'); } catch (enhancedError) { console.error(enhancedError); } })(); // or using a response interceptor and an error callback (e.g. could be useful with a logging middleware) axiosAgent.interceptors.response.use(response => response, enhancedError => { console.error(enhancedError); return result; }); // you can restore original agent behavior if needed const restoreAgent = axiosBetterStacktrace(axiosAgent); // some code here... restoreAgent && restoreAgent(); ``` See also [demo](./demo/index.ts). ## Options | Name | Type | Default | Description | | --- | --- | --- | --- | | errorMsg | `String` | `Axios Better Stacktrace` | Error message to show next to the original one in the output. | ## Example Default axios error without an `axios-better-stacktrace` plugin: ``` Error: Request failed with status code 404 at createError (./node_modules/axios/lib/core/createError.js:16:15) at settle (./node_modules/axios/lib/core/settle.js:17:12) at IncomingMessage.handleStreamEnd (./node_modules/axios/lib/adapters/http.js:244:11) at IncomingMessage.emit (node:events:388:22) at IncomingMessage.EventEmitter.emit (node:domain:470:12) at endReadableNT (node:internal/streams/readable:1294:12) at processTicksAndRejections (node:internal/process/task_queues:80:21) ``` Enhanced axios error with an `axios-better-stacktrace` plugin (run `yarn demo` to see): ``` Error: Request failed with status code 404 at createError (./node_modules/axios/lib/core/createError.js:16:15) at settle (./node_modules/axios/lib/core/settle.js:17:12) at IncomingMessage.handleStreamEnd (./node_modules/axios/lib/adapters/http.js:244:11) at IncomingMessage.emit (node:events:388:22) at IncomingMessage.EventEmitter.emit (node:domain:470:12) at endReadableNT (node:internal/streams/readable:1294:12) at processTicksAndRejections (node:internal/process/task_queues:80:21) Error: Axios Better Stacktrace at Function.axiosBetterStacktraceMethodProxy [as get] (./src/axiosBetterStacktrace.ts:167:15) at getNpmPage (./demo/index.ts:10:35) <---- this is what usually useful to know for further debugging and this plugin adds 🙂 at ./demo/index.ts:13:9 at step (./demo/index.ts:33:23) at Object.next (./demo/index.ts:14:53) at ./demo/index.ts:8:71 at new Promise () at __awaiter (./demo/index.ts:4:12) at ./demo/index.ts:12:2 at Object. (./demo/index.ts:16:3) ``` --- _Source: https://npm.io/package/axios-better-stacktrace · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._