> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/extractiontimeout.md).

# extractionTimeout

## Details

Emitted when the widget does not complete facial extraction within the time configured in [timeout](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/timeout.md).

**Event:** `extractionTimeout`

**Type:** `FacephiSelphiWidgetCustomEvent<ExtractionTimeoutEvent>` | `CustomEvent<ExtractionTimeoutEvent>`

### Syntax

```typescript
selphi.addEventListener('extractionTimeout', onExtractionTimeout);
```

### Received object

The useful payload is of type `SelphiExtractionTimeoutDetail` and is in `event.detail.detail`:

* `eventType` (`string`): Type of emitted event.
* `timeoutResult` (`object`): Partial extraction information.
  * `livenessMoveDiagnosticStatus` (`string`): Active Liveness diagnostic status.
  * `livenessMoveStabilizedStatus` (`string`): Active Liveness stabilization status.
  * `images` (`number`): Number of images captured before the Timeout.
* `code` (`string`): Associated error code.

## Description

Indicates that extraction was not completed in time. By default, the widget shows an expiration view to the user.

### Considerations

The useful payload is in `event.detail.detail` (see [event format](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/eventos.md#formato-de-los-eventos)).

If `timeout` is `0`, this event is not emitted. The timeout screen includes a button that triggers [timeoutErrorButtonClick](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/timeouterrorbuttonclick.md).

This event is emitted on each expired attempt and does not close the flow. To limit the total number of attempts and detect when they are exhausted, use [maxAttempts](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/maxattempts.md) along with [maxAttemptsExceeded](/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/maxattemptsexceeded.md).

***

## Example

```jsx
<facephi-selphi-widget
    onExtractionTimeout={(event) => {
      const { timeoutResult } = event.detail.detail;
      console.log('Extraction timeout:', timeoutResult);
    }}
/>
```

```typescript
import { type SelphiExtractionTimeoutDetail } from '@facephi/sdk-web-wc';

selphi.addEventListener('extractionTimeout', (event) => {
  const detail: SelphiExtractionTimeoutDetail = event.detail.detail;
});
```