Skip to content

Clarify series cancellation behavior - #2084

Open
ryanchou1994 wants to merge 1 commit into
caolan:masterfrom
ryanchou1994:docs/clarify-series-cancellation
Open

ryanchou1994 wants to merge 1 commit into
caolan:masterfrom
ryanchou1994:docs/clarify-series-cancellation

Conversation

@ryanchou1994

Copy link
Copy Markdown

callback(false) is an intentional cancellation signal, but the series API documentation only described error and success completion. That made cancellation look like a silent failure when the final callback did not run.

Clarify the common-pitfalls section and the series API docs so they state that:

  • callback(false) cancels the flow, skips the remaining work, and does not invoke the final callback.
  • callback(null) reports success and allows the flow to continue.

The generated v3 documentation is updated from the same sources. npm test passes with 690 tests on macOS and Linux.

Closes #2035

Copilot AI lite review requested due to automatic review settings September 15, 2026 04:29

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

async.series silently cancels when callback(false) is used

2 participants