Function match

match<T, R>(result: TaskResult<T>, handlers: MatchHandlers<T, R>): R

Exhaustive pattern match on a TaskResult's status discriminant.

Each handler receives the variant narrowed to its status, so data, error, adcpError, deferred, and submitted are correctly typed without manual if (result.status === ...) guards.

Type Parameters

Parameters

result: TaskResult<T>
handlers: MatchHandlers<T, R>

Returns R

Example

const rendered = match(result, {
  completed: (r) => `OK: ${r.data.media_buy_id}`,
  failed: (r) => `Error: ${r.adcpError?.code ?? r.error}`,
  'governance-denied': (r) => `Denied: ${r.error}`,
  submitted: (r) => `Pending: ${r.metadata.taskId}`,
  'input-required': (r) => `Input: ${r.metadata.inputRequest?.question}`,
  working: (r) => `Working: ${r.metadata.taskId}`,
  deferred: (r) => `Deferred: ${r.deferred?.token}`,
});

Example: With `_` catchall, other arms become optional:

const label = match(result, {
  completed: (r) => `OK: ${r.data.media_buy_id}`,
  _: (r) => `${r.status}: ${r.metadata.taskId}`,
});

match<T, R>(result: TaskResult<T>, handlers: PartialMatchHandlers<T, R>): R

Exhaustive pattern match on a TaskResult's status discriminant.

Each handler receives the variant narrowed to its status, so data, error, adcpError, deferred, and submitted are correctly typed without manual if (result.status === ...) guards.

Type Parameters

Parameters

result: TaskResult<T>
handlers: PartialMatchHandlers<T, R>

Returns R

Example

const rendered = match(result, {
  completed: (r) => `OK: ${r.data.media_buy_id}`,
  failed: (r) => `Error: ${r.adcpError?.code ?? r.error}`,
  'governance-denied': (r) => `Denied: ${r.error}`,
  submitted: (r) => `Pending: ${r.metadata.taskId}`,
  'input-required': (r) => `Input: ${r.metadata.inputRequest?.question}`,
  working: (r) => `Working: ${r.metadata.taskId}`,
  deferred: (r) => `Deferred: ${r.deferred?.token}`,
});

Example: With `_` catchall, other arms become optional:

const label = match(result, {
  completed: (r) => `OK: ${r.data.media_buy_id}`,
  _: (r) => `${r.status}: ${r.metadata.taskId}`,
});

Function match

Type Parameters

Parameters

Returns R

Example

Example: With `_` catchall, other arms become optional:

Type Parameters

Parameters

Returns R

Example

Example: With `_` catchall, other arms become optional:

Settings