Interface: ProgressOptions

Defined in: packages/extension-api/src/extension-api.d.ts:1247

Value-object describing where and how progress should show.

Properties

cancellable?

optional cancellable: boolean

Defined in: packages/extension-api/src/extension-api.d.ts:1265

Controls if a cancel button should show to allow the user to cancel the long running operation. Note that currently only ProgressLocation.Notification is supporting to show a cancel button.

---

details?

optional details: object

Defined in: packages/extension-api/src/extension-api.d.ts:1289

You may specify a navigation object, making the task having a navigate action that the user can trigger.

routeArgs

routeArgs: string[]

The arguments to provide the route

routeId

routeId: string

The routeId used in navigation.register

Example

import { window, type ProgressLocation } from '@podman-desktop/api';

await window.withProgress<string>(
    {
      location: ProgressLocation.TASK_WIDGET,
      title: 'My task',
      details: {
        routeId: 'dummy-route-id',
        routeArgs: ['hello', 'world'],
      }
    },
    async () => {
      return 'dummy result';
    },
  );

---

location

location: ProgressLocation

Defined in: packages/extension-api/src/extension-api.d.ts:1251

The location at which progress should show.

---

title?

optional title: string

Defined in: packages/extension-api/src/extension-api.d.ts:1257

A human-readable string which will be used to describe the operation.