sequentialize 5.0.0
Install from the command line:
Learn more about npm packages
$ npm install @escapace/sequentialize@5.0.0
Install via package.json:
"@escapace/sequentialize": "5.0.0"
About this version
Wrap async functions to queue multiple calls for sequential execution.
pnpm add @escapace/sequentializeimport { sequentialize } from '@escapace/sequentialize'
const wrapper = sequentialize()
// Original async function
const fetchData = async (id: string) => {
const response = await fetch(`/api/data/${id}`)
return response.json()
}
// Wrapped function executes sequentially
const sequentialFetch = wrapper(fetchData)
// These calls will execute one after another, not concurrently
void sequentialFetch('1') // executes first
void sequentialFetch('2') // waits for first to complete
void sequentialFetch('3') // waits for second to completeThe sequentialize function returns a wrapper that maintains an internal queue of promises. Each wrapped function call:
- Waits for all previous calls to complete
- Executes the original function
- Resolves its promise
- Allows the next queued call to proceed
Functions execute in first-in-first-out (FIFO) order regardless of their individual completion times.
When a sequentialized function fails, all subsequent functions in the queue will fail with the same error due to the promise chain dependency:
const wrapper = sequentialize()
const mayFail = wrapper(async (shouldFail: boolean) => {
if (shouldFail) throw new Error('Failed')
return 'Success'
})
void mayFail(false).catch(() => console.log('Call 1 failed')) // does not catch
void mayFail(true).catch(() => console.log('Call 2 failed')) // logs "Call 2 failed"
void mayFail(false).catch(() => console.log('Call 3 failed')) // logs "Call 3 failed"Returns a wrapper function that converts async functions to sequential execution.
Returns: <T>(fn: T) => T - A function that wraps async functions
