Registry / devops / axios-extensions

axios-extensions

library4.0.0jsnpmunverified

Composable Axios adapter enhancers for cache, throttle, and retry. Current stable version is 4.0.0, with monthly releases and active maintenance. Key differentiators: composable pipeline design, TypeScript support, per-request overrides via module augmentation, and lightweight with no framework lock-in. Supports Node >=18 and axios >=1.0.0.

devops

npm install axios-extensions

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · AXIOS-EXTENSIONS

axios-extensions

devopsjavascriptv4.0.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

cacheAdapterEnhancer

✓ import { cacheAdapterEnhancer } from 'axios-extensions'

✗ const { cacheAdapterEnhancer } = require('axios-extensions')

ESM-only since v4.0.0; all exports are named.

throttleAdapterEnhancer

✓ import { throttleAdapterEnhancer } from 'axios-extensions'

✗ import throttleAdapterEnhancer from 'axios-extensions'

Must use named import; default export does not exist.

retryAdapterEnhancer

✓ import { retryAdapterEnhancer } from 'axios-extensions'

✗ import { retry } from 'axios-extensions'

The correct name is retryAdapterEnhancer; common mistake.

Shows how to compose all three enhancers (cache, throttle, retry) into a single Axios adapter and use per-request overrides.

import axios from 'axios'; import { cacheAdapterEnhancer, throttleAdapterEnhancer, retryAdapterEnhancer, } from 'axios-extensions'; const adapter = retryAdapterEnhancer( throttleAdapterEnhancer( cacheAdapterEnhancer(axios.defaults.adapter!), { threshold: 1000 }, ), { times: 2 }, ); export const http = axios.create({ baseURL: '/api', adapter, }); // Per-request overrides: await http.get('/users', { forceUpdate: true, threshold: 3000, retryTimes: 3, });

Debug

Known issues

breakingv4.0.0 drops CommonJS support; package is now ESM-only.

fix

Switch to ESM projects or use dynamic import() in CJS. Alternatively, stay on v3.x which supports both CJS and ESM.

affects: >=4.0.0

breakingv4.0.0 requires Node >=18 and axios >=1.0.0.

fix

Update Node to >=18 and axios to >=1.0.0.

affects: >=4.0.0

deprecatedAll imports must be named; default export was removed in v4.0.0.

fix

Use named imports: import { cacheAdapterEnhancer, throttleAdapterEnhancer, retryAdapterEnhancer } from 'axios-extensions'.

affects: >=4.0.0

gotchaaxios v0.19.0 is not supported due to a custom config issue in Axios core (axios/axios#2207).

fix

Use axios v0.19.1+ or v1.x.

affects: >=0.0.0

Errors

Common errors & fixes

ERR_REQUIRE_ESM: require() of ES Module not supported

Package is ESM-only in v4.0.0; require() cannot be used.

fix

Use import or dynamic import(). Example: import { cacheAdapterEnhancer } from 'axios-extensions'

Module not found: Error: Can't resolve 'axios-extensions'

Package not installed or import path incorrect.

fix

Run npm install axios-extensions and verify the import is: import { cacheAdapterEnhancer } from 'axios-extensions'

TypeError: axios.defaults.adapter is undefined

Axios adapter not set; may occur in SSR or test environments.

fix

Pass a custom adapter or mock. Example: const mockAdapter = (config) => axios.defaults.adapter(config)

Upgrade

Version history

4.0.0latest on npm

Audit

Dependencies

axiosrequiredPeer dependency; the package enhances Axios adapters

Agent activity

9 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/kuitos/axios-extensions ↗

packageaxios-extensions ↗

homepagehttps://github.com/kuitos/axios-extensions ↗