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

# Eventos

O SelphID Widget emite eventos durante seu fluxo de vida.

## Formato dos eventos

`facephi-selphid-widget` envolve o motor interno `facephi-selphid`. Quando o motor emite um evento, o wrapper o reencaminha passando o `CustomEvent` interno como `detail` do evento externo. Por isso, o payload útil do Widget está em **`event.detail.detail`**, não em `event.detail`.

```typescript
// Estructura do evento recebido em <facephi-selphid-widget>
widgetEvent = {
  detail: {          // CustomEvent interno reenviado por el wrapper
    detail: { ... } // Payload real (ExtractionFinishDetail, etc.)
  }
};

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

***

## Exemplo de uso

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

## Eventos emitidos por SelphID Widget

### Resultados da extração

* [extractionFinish](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/extractionfinish.md): A extração do documento foi concluída com sucesso.

### Interação do usuário

* [timeoutErrorButtonClick](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/timeouterrorbuttonclick.md): O usuário apertou o botão em Timeout ou erro.
* [userCancel](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/usercancel.md): O usuário cancelou o processo.

### Temporizadores

* [extractionTimeout](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/extractiontimeout.md): O limite de tempo de captura foi atingido.
* [moduleLoaded](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/moduleloaded.md): O Widget terminou de carregar.

### Controle de erros

* [errorTimeout](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/errortimeout.md): O tempo expirou na tela de erro terminal.
* [exceptionCaptured](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/exceptioncaptured.md): Ocorreu uma exceção durante a execução.
* [maxAttemptsExceeded](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/maxattemptsexceeded.md): As tentativas de captura permitidas se esgotaram.

### Processo de extração

* [trackStatus](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/trackstatus.md): Alteração de estado interno durante a captura.