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

# extractionTimeout

## Detalles

Se emite cuando el widget no puede extraer el documento dentro del tiempo configurado en [captureTimeout](/sdks/sdk-web/componentes/selphid-documentos/propiedades/capturetimeout.md) y [captureRetries](/sdks/sdk-web/componentes/selphid-documentos/propiedades/captureretries.md).

**Evento:** `extractionTimeout`

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

### Sintaxis

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

### Objeto recibido

El payload útil es de tipo `SelphidExtractionTimeoutDetail` y está en `event.detail.detail`:

* `eventType` (`string`): Tipo de evento emitido.
* `message` (`string`): Descripción breve del timeout.
* `documentPresent` (`boolean`): Indica si se detectó un documento durante el intento.
* `code` (`string`): Código de error asociado.

## Descripción

Indica que no se completó la captura del documento a tiempo. Por defecto, el widget muestra una vista de expiración al usuario.

### Consideraciones

El payload útil está en `event.detail.detail` (ver [formato de eventos](/sdks/sdk-web/componentes/selphid-documentos/eventos.md#formato-de-los-eventos)).

Si `captureTimeout` o `captureRetries` es `0`, este evento no se emite. La pantalla de timeout incluye un botón que dispara [timeoutErrorButtonClick](/sdks/sdk-web/componentes/selphid-documentos/eventos/timeouterrorbuttonclick.md).

Este evento se emite en cada intento expirado y no cierra el flujo. Para limitar el número total de intentos y detectar cuándo se agotan, usa [maxAttempts](/sdks/sdk-web/componentes/selphid-documentos/propiedades/maxattempts.md) junto con [maxAttemptsExceeded](/sdks/sdk-web/componentes/selphid-documentos/eventos/maxattemptsexceeded.md).

***

## Ejemplo

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