listr2
11.4.0 · 17 Oct 2026MIT36.4M / weekRepositorynpmAtom feed
11.4.0 is the newest release of 11.x.
In short
3 breaking3 new2 faster5 fixed
- breaking
lib: Listr.errors is now
ListrError | null. With the - breaking
lib: on interruption, tasks without a rollback are now marked as
- breaking
lib: collectErrors no longer accepts 'minimal' or 'full', use
Release note
The section about listr2 of a note shared by several packages.
listr2 11.0.0 (2026-07-21)
Bug Fixes
lib: preserve OSC-8 hyperlinks in cleanseAnsi (#776) (4f6fc87), closes #768
lib: return null from Listr.errors when collection is disabled
renderer: derive wrap width from configured output stream
renderer: serialize the cancelled state in the test renderer
renderer: stop leaking output listeners on finalized tasks (1278eb5), closes #772
Features
lib: replace eventemitter3 with Node built-in EventEmitter
lib: reset a task's streamed output when set to null
lib: run rollback on interruption and add a cancelled task state
Performance Improvements
lib: drop rfdc and simplify collectErrors to a boolean
renderer: render task list with partial updates via log-update v8
Breaking changes
- breaking
lib: Listr.errors is now
ListrError | null. With the
defaultcollectErrors: [secure]it isnullinstead of an empty array;
guard reads withlistr.errors?.lengthor an explicit null check.
refs K-715
- breaking
lib: on interruption, tasks without a rollback are now marked as
CANCELLED instead of FAILED, and the process exits only after in-flight
rollbacks have settled. Custom renderers that switch on the task state must
handle ListrTaskState.CANCELLED.
refs K-703
- breaking
lib: collectErrors no longer accepts 'minimal' or 'full', use
true for the previous 'minimal' behavior. ListrError.ctx is removed and the
context is no longer cloned into collected errors. The cloneObject utility
export and the rfdc dependency are removed.