Packages

listr2

11.4.0 · 17 Oct 2026MIT36.4M / weekRepositorynpmAtom feed

Your version

11.0.0

major21 Jul 2026Where it was published

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
    default collectErrors: [secure] it is null instead of an empty array;
    guard reads with listr.errors?.length or 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.