> 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/selphid-documentos/eventos/extractiontimeout.md).

# extractionTimeout

O tempo limite de captura foi atingido.

## Detalhes

É emitido quando o widget não consegue extrair o documento dentro do tempo configurado em [captureTimeout](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/propiedades/capturetimeout.md) e [captureRetries](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/propiedades/captureretries.md).

**Evento:** `extractionTimeout`

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

### Sintaxe

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

### Objeto recebido

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

* `eventType` (`string`): Tipo de evento emitido.
* `message` (`string`): Descrição breve do timeout.
* `documentPresent` (`boolean`): Indica se um documento foi detectado durante a tentativa.
* `code` (`string`): Código de erro associado.

## Descrição

Indica que a captura do documento não foi concluída a tempo. Por padrão, o widget exibe uma tela de expiração para o usuário.

Com [`codeReader`](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/propiedades/codereader.md) no modo `mandatory`, o mesmo evento é emitido se o limite de tempo de leitura do código se esgotar. Nesse caso, a nova tentativa iniciada em [timeoutErrorButtonClick](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/timeouterrorbuttonclick.md) **retoma a leitura do código**, e não a captura do documento.

### Considerações

O payload útil está em `event.detail.detail` (consulte [formato dos eventos](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos.md#formato-de-los-eventos)).

Se `captureTimeout` ou `captureRetries` for `0`, a tela de timeout inclui um botão que dispara [timeoutErrorButtonClick](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/timeouterrorbuttonclick.md).

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

***

## Exemplo

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

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

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