listr2

Appearance

Documentation / listr2 / ListrOptions

Interface: ListrOptions<Ctx> ​

Options to set the behavior of Listr.

Extended by ​

Type Parameters ​

• Ctx = ListrContext

Properties ​

ctx? ​

optional ctx: Ctx

Inject a context through this options wrapper.

Default Value ​

{}

See ​

https://listr2.kilic.dev/listr/context.html

Defined in ​

packages/listr2/src/interfaces/listr.interface.ts:24

concurrent? ​

optional concurrent: number | boolean

Concurrency limits how many tasks will be running in parallel.

  • false will only run a single task at a time.
  • true will set it to Infinity to run all the tasks in parallel.
  • Given a number it will limit the concurrency to that number.

Default Value ​

false

Defined in ​

packages/listr2/src/interfaces/listr.interface.ts:34

exitOnError? ​

optional exitOnError: boolean

Determine the default behavior of exiting on errors.

  • true will exit the current Listr whenever it encounters an error.
  • false will continue the execution of current Listr if it encounters an error.

Default Value ​

true

Defined in ​

packages/listr2/src/interfaces/listr.interface.ts:43

exitAfterRollback? ​

optional exitAfterRollback: boolean

Determine the behavior of exiting after rollback actions.

This is independent of exitOnError, since failure of a rollback can be a more critical operation comparing to failing a single task.

  • true will stop the execution whenever a rollback happens.
  • false will continue after successfully recovering from a rollback.

Default Value ​

true

Defined in ​

packages/listr2/src/interfaces/listr.interface.ts:55

collectErrors? ​

optional collectErrors: false | "minimal" | "full"

Collects errors inside the Listr.errors.

  • false will collect no errors.
  • minimal will only collect the error message and the location.
  • full will clone the current context and task in to the error instance.

Default Value ​

false

See ​

https://listr2.kilic.dev/task/error-handling.html#collected-errors

Defined in ​

packages/listr2/src/interfaces/listr.interface.ts:66

registerSignalListeners? ​

optional registerSignalListeners: boolean

Listr will track SIGINIT signal to update the renderer one last time before failing, therefore it needs to register exit listeners.

Default Value ​

ts
true

Defined in ​

packages/listr2/src/interfaces/listr.interface.ts:73

fallbackRendererCondition? ​

optional fallbackRendererCondition: boolean | () => boolean

Determine the certain condition required to use the fallback renderer.

Default Value ​

ts
handled internally

Defined in ​

packages/listr2/src/interfaces/listr.interface.ts:79

silentRendererCondition? ​

optional silentRendererCondition: boolean | () => boolean

Determine the certain condition required to use the silent renderer.

Default Value ​

ts
handled internally

Defined in ​

packages/listr2/src/interfaces/listr.interface.ts:85

forceTTY? ​

optional forceTTY: boolean

Forces TTY stdout even though your current output may not be compatible.

Default Value ​

false

Defined in ​

packages/listr2/src/interfaces/listr.interface.ts:91

forceUnicode? ​

optional forceUnicode: boolean

Forces unicode icons even though your current output may not be compatible.

Default Value ​

false

Defined in ​

packages/listr2/src/interfaces/listr.interface.ts:97