Retry v3.4.0+

Introduction

If you want to retry a task that had failed a couple of times more, you can use the retry property in the Task.

This is related to the discussions on issue #303: "Feature Request: Retry on Error".

Thanks metasean for bringing this up!

Usage

Please refer to examples section for more detailed and further examples.

task = new Listr<Ctx>(
  [
    [
      {
        title: 'Some type errors',
        task: async (_, task): Promise<void> => {
          await delay(1000)
          task.output = 'test'

          await delay(1000)
          throw new Error('This type can not be assigned to type with, oh noes')
        },
        retry: 3
      }
    ]
  ],
  {
    concurrent: false,
    exitOnError: true
  }
)

try {
  const context = await task.run()
  logger.success(`Context: ${JSON.stringify(context)}`)
} catch (e) {
  logger.fail(e)
}

Details of the Retry Event

Retrying is self-aware and you can access from the task if it is retrying via task.isRetrying(). It will either return an object of count: number, withError: any where count will be 0 for not repeating tasks, and withError is the last encountered error if retrying.

Access the Retry count

await new Listr(
  [
    {
      title: 'Some thing with errors',
      task: async (_, task): Promise<void> => {
        const retry = task.isRetrying()
        if (retry.count > 0) {
          task.title = 'This means I am retrying.'
          task.output = `I am self aware that I am retrying for the ${retry.count}th time.`
        }

        await delay(1000)
        throw new Error('This type can not be assigned to type with, oh noes')
      },
      retry: 3
    }
  ],
  { exitOnError: false }
).run()

Access the Last Error Message

await new Listr(
  [
    {
      title: 'Some thing with errors',
      task: async (_, task): Promise<void> => {
        const retry = task.isRetrying()
        if (retry.count > 0) {
          if ((retry.error = new Error('Something'))) {
            task.title = 'I will process the task further.'
          }
        }

        await delay(1000)
        throw new Error('This type can not be assigned to type with, oh noes')
      },
      retry: 3
    }
  ],
  { exitOnError: false }
).run()

Renderer

Default Renderer

When rollback is activated the default renderer will change the spinner color to orange.

When retrying, the task title will be reset to the original task title and the output will be cleared if it is not written to the bottom bar.

/**
 * suffix retry messages with [RETRY-${COUNT}] when retry is enabled for a task
 *
 * @default true
 */
suffixRetries?: boolean