> 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/errortimeout.md).

# errorTimeout

The timeout expired on the terminal error view.

## Details

Emitted when [errorTimer](https://docs.facephi.com/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/errortimer.md) elapses after an error before extraction.

**Event:** `errorTimeout`

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

### Syntax

```typescript
selphi.addEventListener('errorTimeout', onErrorTimeout);
```

### Received object

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

* `eventType` (`string`): Type of event emitted.
* `exceptionType` (`string`): Type of exception that caused the timeout.
* `message` (`string`): Brief error description.
* `advancedTracking` (`Uint8Array`): Encoded advanced Tracking (optional).
* `livenessMoveResult` (`string`): Tokenized Active Liveness results (optional).

**Values `exceptionType`**:

| Value                        | Code      |
| ---------------------------- | --------- |
| `AndroidWebViewBehaviour`    | `SPI_227` |
| `UnknownInternalError`       | `SPI_235` |
| `CameraHardwareError`        | `SPI_204` |
| `PermissionsDenied`          | `SPI_242` |
| `CameraPermissionDenied`     | `SPI_201` |
| `MicrophonePermissionDenied` | `SPI_218` |
| `SettingsError`              | `SPI_219` |
| `BrowserApiNotCompatible`    | `SPI_220` |
| `SpoofingDetected`           | `SPI_221` |
| `ActiveLivenessError`        | `SPI_205` |
| `MaxAttemptsExceeded`        | `SPI_244` |
| `ErrorTimeout`               | `SPI_001` |
| `FaceNotFound`               | `SPI_222` |
| `EyesNotFound`               | `SPI_223` |
| `OccludedEyes`               | `SPI_237` |
| `OccludedMouth`              | `SPI_238` |
| `DarkLightError`             | `SPI_224` |
| `AngleExceeded`              | `SPI_225` |
| `TooManyFaces`               | `SPI_226` |

## Description

Marks the end of the timeout after a terminal exception. The widget closes, and you can implement recovery logic.

### Considerations

The payload is in `event.detail.detail` (see [event format](https://docs.facephi.com/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/eventos.md#formato-de-los-eventos)). SPI codes match the [results](https://docs.facephi.com/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/resultados.md#codigos-de-error).

If [interactable](https://docs.facephi.com/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/interactible.md) is `false`, this event is also emitted after other exceptions.

In IDV flows, this event is not forwarded when `exceptionType` is `MaxAttemptsExceeded`: that result is already reported by [maxAttemptsExceeded](https://docs.facephi.com/docs.facephi-en/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/maxattemptsexceeded.md), and handling it again would replace the attempts-exhausted screen with a generic error.

***

## Example

```jsx
<facephi-selphi-widget
    onErrorTimeout={(event) => {
      const { exceptionType, message } = event.detail.detail;
      console.error('Error timeout:', exceptionType, message);
    }}
/>
```

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

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