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

# trackStatus

## Detalhes

É emitido após ações do usuário ou mudanças de estado durante o Fluxo de captura.

**Evento:** `trackStatus`

**Tipo:** `FacephiSelphiWidgetCustomEvent<TrackStatusEvent>` | `CustomEvent<TrackStatusEvent>`

### Sintaxe

```typescript
selphi.addEventListener('trackStatus', onTrackStatus);
```

### Objeto recebido

O payload útil é do tipo `SelphiTrackStatusDetail` e está em `event.detail.detail`:

* `eventType` (`string`): Tipo de evento emitido.
* `currentState` (`string`) | `tapButton` (`string`): Chave dinâmica com o estado ou a ação (apenas uma presente por emissão).

**Valores `currentState`**:

| Valor          | Descrição                                  |
| -------------- | ------------------------------------------ |
| `initializing` | O motor de Selphi está sendo inicializado. |
| `ready`        | Selphi foi carregado e está pronto.        |
| `liveness`     | O teste de vida ativo foi iniciado.        |
| `analyzing`    | O processo de captura foi iniciado.        |
| `previewImage` | A pré-visualização da captura é exibida.   |
| `resetting`    | O motor interno está sendo reiniciado.     |
| `fim`          | A captura foi finalizada.                  |
| `error`        | Ocorreu um erro no Fluxo.                  |
| `end`          | A extração foi finalizada.                 |

**Valores `tapButton`**:

| Valor              | Descrição                      |
| ------------------ | ------------------------------ |
| `tutorial`         | Botão de tutorial pressionado. |
| `exit`             | Botão de fechar pressionado.   |
| `startCapture`     | Início da captura.             |
| `repeatExtraction` | Tentar captura novamente.      |
| `finishExtraction` | Finalizar extração.            |
| `retryExtraction`  | Tentar extração novamente.     |
| `switchCamera`     | Troca de câmera.               |
| `back`             | Voltar atrás.                  |

## Descrição

Permite rastrear as ações do usuário e as mudanças de estado internas do Widget.

### Considerações

O payload útil está em `event.detail.detail` (veja [formato de eventos](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos.md#formato-de-los-eventos)).

***

## Exemplo

```jsx
<facephi-selphi-widget
    onTrackStatus={(event) => {
      const detail = event.detail.detail;
      console.log('Track status:', detail);
    }}
/>
```

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

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