Skip to content

Documentation / listr2 / Listr

Class: Listr<Ctx, Renderer, FallbackRenderer>

Defined in: packages/listr2/src/listr.ts:26

Create a new task list with Listr.

See

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

Type Parameters

Ctx

Ctx = ListrContext

Renderer

Renderer extends ListrRendererValue = ListrPrimaryRendererValue

FallbackRenderer

FallbackRenderer extends ListrRendererValue = ListrSecondaryRendererValue

Constructors

Constructor

new Listr<Ctx, Renderer, FallbackRenderer>(task, options?, parentTask?): Listr<Ctx, Renderer, FallbackRenderer>

Defined in: packages/listr2/src/listr.ts:50

Parameters

task

ListrTask<Ctx, ListrGetRendererClassFromValue<Renderer>, ListrGetRendererClassFromValue<FallbackRenderer>> | ListrTask<Ctx, ListrGetRendererClassFromValue<Renderer>, ListrGetRendererClassFromValue<FallbackRenderer>>[]

options?

ListrBaseClassOptions<Ctx, Renderer, FallbackRenderer>

parentTask?

ListrTaskObject<any, ListrGetRendererClassFromValue<Renderer>, ListrGetRendererClassFromValue<FallbackRenderer>>

Returns

Listr<Ctx, Renderer, FallbackRenderer>

Properties

tasks

tasks: ListrTaskObject<Ctx, ListrGetRendererClassFromValue<Renderer>, ListrGetRendererClassFromValue<FallbackRenderer>>[] = []

Defined in: packages/listr2/src/listr.ts:31


errors

errors: ListrError<Ctx>[]

Defined in: packages/listr2/src/listr.ts:32


ctx

ctx: Ctx

Defined in: packages/listr2/src/listr.ts:33


events

events: ListrEventManager

Defined in: packages/listr2/src/listr.ts:34


path

path: string[] = []

Defined in: packages/listr2/src/listr.ts:35


rendererClass

rendererClass: typeof ListrRenderer

Defined in: packages/listr2/src/listr.ts:36


rendererClassOptions

rendererClassOptions: ListrGetRendererOptions<ListrGetRendererClassFromValue<Renderer> | ListrGetRendererClassFromValue<FallbackRenderer>>

Defined in: packages/listr2/src/listr.ts:37


rendererSelection

rendererSelection: ListrRendererSelection

Defined in: packages/listr2/src/listr.ts:38


boundSignalHandler

boundSignalHandler: () => void

Defined in: packages/listr2/src/listr.ts:39

Returns

void


signal

signal: AbortSignal

Defined in: packages/listr2/src/listr.ts:40


task

task: ListrTask<Ctx, ListrGetRendererClassFromValue<Renderer>, ListrGetRendererClassFromValue<FallbackRenderer>> | ListrTask<Ctx, ListrGetRendererClassFromValue<Renderer>, ListrGetRendererClassFromValue<FallbackRenderer>>[]

Defined in: packages/listr2/src/listr.ts:51


options?

optional options?: ListrBaseClassOptions<Ctx, Renderer, FallbackRenderer>

Defined in: packages/listr2/src/listr.ts:54


parentTask?

optional parentTask?: ListrTaskObject<any, ListrGetRendererClassFromValue<Renderer>, ListrGetRendererClassFromValue<FallbackRenderer>>

Defined in: packages/listr2/src/listr.ts:55

Methods

isRoot()

isRoot(): boolean

Defined in: packages/listr2/src/listr.ts:146

Whether this is the root task.

Returns

boolean


isSubtask()

isSubtask(): boolean

Defined in: packages/listr2/src/listr.ts:153

Whether this is a subtask of another task list.

Returns

boolean


add()

add(tasks): void

Defined in: packages/listr2/src/listr.ts:162

Add tasks to current task list.

Parameters

tasks

ListrTask<Ctx, ListrGetRendererClassFromValue<Renderer>, any> | ListrTask<Ctx, ListrGetRendererClassFromValue<Renderer>, any>[]

Returns

void

See

https://listr2.kilic.dev/task/task.html


run()

run(context?): Promise<Ctx>

Defined in: packages/listr2/src/listr.ts:171

Run the task list.

Parameters

context?

Ctx

Returns

Promise<Ctx>

See

https://listr2.kilic.dev/listr/listr.html#run-the-generated-task-list


cancel()

cancel(): void

Defined in: packages/listr2/src/listr.ts:241

Interrupt the running task list programmatically, as if it received a SIGINT.

In-flight tasks roll back or are marked as cancelled and the process exits with 127.

Returns

void