Registry / devops / axios-extra

axios-extra

JSON →
library0.0.8jsnpmunverified

Extends Axios with concurrency limits and automatic retry via ES6 Proxy. Wraps promise-queue-plus to provide maxConcurrent and retry options without adding new API surface – usage remains identical to Axios. Current stable version 0.0.8, no recent releases. Key differentiator: no extra methods, just augmented config. Requires Axios as peer dependency. Suited for Node.js or browser environments where Axios is already used and need simple rate limiting or retry logic.

npm install axios-extra
INSTALL
IMPORT
SIG · AXIOS-EXTRA
A
axios-extra
devopsjavascriptv0.0.8
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.

axios
import axios from 'axios-extra'
const axios = require('axios-extra')
Default export. ESM-compatible, but CJS require also works in Node.
create
import { create } from 'axios-extra'
const create = require('axios-extra/create')
Named export 'create' is available. Subpath import 'axios-extra/create' is deprecated but still works in CJS.
requestQueue
const { requestQueue } = axios.create({})
const q = axios.requestQueue
requestQueue is only available on instances created via .create(), not on the default axios export.

Shows creating an instance with maxConcurrent and retry, per-request queueOptions, and accessing the underlying queue control methods.

import axios from 'axios-extra'; const instance = axios.create({ maxConcurrent: 2, queueOptions: { retry: 3, retryIsJump: true } }); async function run() { try { const res = await instance.get('https://httpbin.org/get', { queueOptions: { retry: 5 } }); console.log(res.data); } catch (err) { console.error(err.message); } } run(); // Control queue const { start, stop, clear } = instance.requestQueue; stop(); console.log('Queue paused');
Debug
Known issues
gotchaES6 Proxy is required – axios-extra uses Proxy to intercept axios methods. Older browsers (IE11) and some JavaScript environments without Proxy support will fail.
fix
Ensure runtime supports ES6 Proxy or use a polyfill.
affects: >=0.0.0
gotcharequestQueue is only available on instances returned by .create(), not on the default import.
fix
Always create an instance with axios.create() to access requestQueue.
affects: >=0.0.0
deprecatedSubpath import 'axios-extra/create' is deprecated; use the named export 'create' from the main package.
fix
Replace require('axios-extra/create') with import { create } from 'axios-extra'.
affects: >=0.0.0
gotchaSetting maxConcurrent=0 effectively disables all requests (never executes). The queue will hold pending forever.
fix
Use maxConcurrent > 0. Use 1 for sequential or a higher number for concurrency.
affects: >=0.0.0
gotchaqueueOptions.retry still counts as a request for concurrency limiting – each retry occupies a slot.
fix
Account for retries when setting maxConcurrent to avoid unintended serialization.
affects: >=0.0.0
Errors
Common errors & fixes
TypeError: Cannot create proxy with a non-object as target or handler
Axios version mismatch or invalid axios instance passed to create.
fix
Ensure the argument to create() is a valid Axios instance (e.g., axios.create()). Use import axios from 'axios' to get a fresh instance.
Cannot read property 'requestQueue' of undefined
Trying to access requestQueue on the default axios export instead of a created instance.
fix
Use const instance = axios.create({}); instance.requestQueue.
Module not found: Can't resolve 'axios-extra/create'
Using deprecated subpath import with bundlers that don't support it.
fix
Change to import { create } from 'axios-extra'.
requestQueue is not a function
Treating requestQueue as a callable instead of an object.
fix
requestQueue is an object with methods like start, stop, clear – do not call it as a function.
Upgrade
Version history
0.0.8latest on npm
Audit
Dependencies
axiosrequiredPeer dependency – axios-extra wraps axios instances
Agent activity
13 hits · last 30 days
node
12
OpenAI (training)
1
Resources
axios-extra — npm install axios-extra · libregistry