> 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

## Detalhes

É emitido quando o widget não consegue extrair o documento dentro do tempo configurado em [captureTimeout](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/propiedades/capturetimeout.md) e [captureRetries](/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.

### Considerações

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

Se `captureTimeout` ou `captureRetries` é `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/selphid-documentos/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/selphid-documentos/propiedades/maxattempts.md) junto com [maxAttemptsExceeded](/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;
});
```