> 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/selphi-biometria-facial/eventos.md).

# Eventos

O Selphi Widget emite eventos durante seu Fluxo de vida.

## Formato dos eventos

`facephi-selphi-widget` envolve o motor interno `facephi-selphi`. 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`**, e não em `event.detail`.

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

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

***

## Exemplo de uso

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

***

## Eventos emitidos por Selphi Widget

### Resultados da extração

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

### Interação do usuário

* [timeoutErrorButtonClick](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/timeouterrorbuttonclick.md): O usuário clicou no botão na tela de Timeout ou erro.
* [userCancel](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/usercancel.md): O usuário cancelou o processo.

### Temporizadores

* [extractionTimeout](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/extractiontimeout.md): O tempo limite de extração foi atingido.
* [moduleLoaded](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/moduleloaded.md): O widget terminou de carregar.

### Controle de erros

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

### Processo de extração

* [stabilizing](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/stabilizing.md): Frame analisado durante a estabilização.
* [trackStatus](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/trackstatus.md): Alteração do estado interno durante a captura.