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

# Events

The SelphID Widget emits events during its lifecycle.

## Event format

`facephi-selphid-widget` wraps the internal engine `facephi-selphid`. When the engine emits an event, the wrapper forwards it by passing the `CustomEvent` internal as `detail` of the external event. That is why the useful payload of the widget is in **`event.detail.detail`**, not in `event.detail`.

```typescript
// Structure of the event received in <facephi-selphid-widget>
widgetEvent = {
  detail: {          // Internal CustomEvent forwarded by the wrapper
    detail: { ... } // Real payload (ExtractionFinishDetail, etc.)
  }
};

const payload = widgetEvent.detail.detail;
```

***

## Usage example

```jsx
<facephi-selphid-widget
    onExtractionFinish={(event) => {
      const payload = event.detail.detail;
      console.log('SELPHID RESULT:', payload);
    }}
/>
```

## Events emitted by SelphID Widget

### Extraction results

* [extractionFinish](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/eventos/extractionfinish.md): The document extraction has completed successfully.

### User interaction

* [timeoutErrorButtonClick](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/eventos/timeouterrorbuttonclick.md): The user pressed the button in case of timeout or error.
* [userCancel](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/eventos/usercancel.md): The user cancelled the process.

### Timers

* [extractionTimeout](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/eventos/extractiontimeout.md): The capture time limit was reached.
* [moduleLoaded](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/eventos/moduleloaded.md): The Widget has finished loading.

### Error handling

* [errorTimeout](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/eventos/errortimeout.md): Time expired on the terminal error view.
* [exceptionCaptured](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/eventos/exceptioncaptured.md): An exception occurred during execution.
* [maxAttemptsExceeded](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/eventos/maxattemptsexceeded.md): The allowed capture attempts were exhausted.

### Extraction process

* [trackStatus](/docs.facephi-en/sdks/sdk-web/componentes/selphid-documentos/eventos/trackstatus.md): Internal state change during capture.