> 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/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:** `FacephiSelphidWidgetCustomEvent<TrackStatusEvent>` | `CustomEvent<TrackStatusEvent>`

### Sintaxe

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

### Objeto recebido

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

* `eventType` (`string`): Tipo de evento emitido.
* `currentState` (`string`) | `tapButton` (`string`) | `retriesConsumed` (`number`) | `documentPresent` (`boolean`): Chave dinâmica com o estado, a ação ou metadados de captura (somente as presentes em cada emissão).

**Valores `currentState`**:

| Valor          | Descrição                                   |
| -------------- | ------------------------------------------- |
| `initializing` | O motor do SelphID está sendo inicializado. |
| `initEngine`   | Inicialização do motor em andamento.        |
| `ready`        | SelphID foi carregado e está pronto.        |
| `analyzing`    | A imagem atual está sendo analisada.        |
| `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.   |
| `repeatExtraction`   | Tentar captura novamente.      |
| `continueExtraction` | Continuar extração.            |
| `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/selphid-documentos/eventos.md#formato-de-los-eventos)).

***

## Exemplo

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

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

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