axios-queue-js

library1.1.6jsnpmunverified

axios-queue-js is a lightweight TypeScript wrapper around axios that queues HTTP requests, limiting concurrency to improve performance and prevent connection overload. Current stable version is 1.1.6. It works in both Node.js and browser environments. The library allows developers to replace axios directly with no code changes, or customize queue size and axios client via the AxiosQueueManager class. Key differentiator: it solves the problem of too many concurrent requests (e.g., 1000 requests failing with vanilla axios) by queuing them, achieving up to 478x more requests in only 3x the time. Requires axios >= 0.21.4 as a peer dependency. Release cadence appears to be active but low frequency.

devops

npm install axios-queue-js

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · AXIOS-QUEUE-JS

axios-queue-js

devopsjavascriptv1.1.6

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.

default (axios)

✓ import axios from 'axios-queue-js';

✗ import { axios } from 'axios-queue-js';

Default export is an axios-like instance with built-in queuing. Named export 'axios' does not exist.

AxiosQueueManager

✓ import { AxiosQueueManager } from 'axios-queue-js';

✗ const AxiosQueueManager = require('axios-queue-js');

Named export for creating custom queue managers. CommonJS users should use require with destructuring.

default (CommonJS)

✓ const { default: axios } = require('axios-queue-js');

✗ const axios = require('axios-queue-js');

CommonJS require returns the module object; default export is under .default.

AxiosQueueManager (CommonJS)

✓ const { AxiosQueueManager } = require('axios-queue-js');

Direct destructuring works for named exports.

This example demonstrates replacing axios with axios-queue-js to automatically queue GET requests with default concurrency settings.

import axios from 'axios-queue-js'; async function main() { try { const response = await axios.get('https://jsonplaceholder.typicode.com/todos/1'); console.log('Response:', response.data); } catch (error) { console.error('Error:', error); } } main();

Debug

Known issues

gotchaDefault export is not a native axios instance but a queue-wrapper. Methods like axios.CancelToken or axios.interceptors are not directly available on the default export.

fix

Use AxiosQueueManager with a custom axios client to access interceptors: new AxiosQueueManager({ client: axios.create() }).

affects: >=1.0.0

gotchaWhen using CommonJS, require('axios-queue-js') returns an object with a default property for the queue-enabled axios. Using const axios = require('axios-queue-js') will give an object, not a function.

fix

Use const { default: axios } = require('axios-queue-js');

affects: >=1.0.0

deprecatedNo deprecation warnings at this version, but the library has low maintenance activity. Check for compatibility with future axios versions.

fix

Pin axios version to >=0.21.4 and test before upgrading.

affects: =1.1.6

Errors

Common errors & fixes

Cannot find module 'axios-queue-js' or its corresponding type declarations.

Package not installed or TypeScript cannot resolve types.

fix

Run npm install axios-queue-js and ensure tsconfig.json includes node module resolution.

TypeError: axios.get is not a function

CommonJS require returns the module object instead of the default export.

fix

Use const { default: axios } = require('axios-queue-js');

Cannot read properties of undefined (reading 'get')

AxiosQueueManager or client not properly initialized.

fix

Ensure new AxiosQueueManager() is called with valid options, e.g., new AxiosQueueManager({ queueSize: 10 }).

Upgrade

Version history

1.1.6latest on npm

Audit

Dependencies

axiosrequiredpeer dependency; the library wraps axios instances to queue requests

Agent activity

12 hits · last 30 days

node

OpenAI (training)

Resources

githubssh://git@github.com/AndersonSMed/axios-queue-js ↗

packageaxios-queue-js ↗

homepagehttps://github.com/AndersonSMed/axios-queue-js#readme ↗