> 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-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/extractiontimeout.md).

# extractionTimeout

## Detalhes

É emitido quando o widget não conclui a extração facial dentro do tempo configurado em [timeout](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/timeout.md).

**Evento:** `extractionTimeout`

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

### Sintaxe

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

### Objeto recebido

O payload útil é do tipo `SelphiExtractionTimeoutDetail` e está em `event.detail.detail`:

* `eventType` (`string`): Tipo de evento emitido.
* `timeoutResult` (`object`): Informações parciais da extração.
  * `livenessMoveDiagnosticStatus` (`string`): Estado do diagnóstico de liveness ativo.
  * `livenessMoveStabilizedStatus` (`string`): Estado de estabilização em liveness ativo.
  * `images` (`number`): Número de imagens capturadas antes do timeout.
* `code` (`string`): Código de erro associado.

## Descrição

Indica que a extração não foi concluída a tempo. Por padrão, o widget mostra uma tela de expiração ao usuário.

### Considerações

O payload útil está em `event.detail.detail` (ver [formato de eventos](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos.md#formato-de-los-eventos)).

Se `timeout` é `0`, este evento não se emite. A tela de expiração inclui um botão que dispara [timeoutErrorButtonClick](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/timeouterrorbuttonclick.md).

Este evento é emitido em cada tentativa expirada e não encerra o fluxo. Para limitar o número total de tentativas e detectar quando se esgotam, use [maxAttempts](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/maxattempts.md) junto com [maxAttemptsExceeded](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/maxattemptsexceeded.md).

***

## Exemplo

```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;
});
```