> 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

Mudança de estado interno durante a captura.

## 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                                                                            |
| --------------- | ------------------------------------------------------------------------------------ |
| `inicializando` | O motor do SelphID está sendo inicializado.                                          |
| `initEngine`    | Inicialização do motor em andamento.                                                 |
| `pronto`        | SelphID foi carregado e está pronto.                                                 |
| `analisando`    | A imagem atual está sendo analisada.                                                 |
| `previewImage`  | A pré-visualização da captura é exibida.                                             |
| `reiniciando`   | O motor interno está sendo reiniciado.                                               |
| `codeInfo`      | Tela informativa do código localizado (foto + recorte) após a extração do documento. |
| `readingCode`   | Leitura ao vivo do QR/código.                                                        |
| `codesFinished` | Leitura de código concluída (ou omitida no modo `optional`).                         |
| `finish`        | A captura foi concluída.                                                             |
| `erro`          | Ocorreu um erro no Fluxo.                                                            |
| `fim`           | A extração foi concluída.                                                            |

**Valores `tapButton`**:

| Valor                | Descrição                      |
| -------------------- | ------------------------------ |
| `tutorial`           | Botão de tutorial pressionado. |
| `sair`               | Botão de fechar pressionado.   |
| `repeatExtraction`   | Repetir captura.               |
| `continueExtraction` | Continuar extração.            |
| `finishExtraction`   | Finalizar extração.            |
| `retryExtraction`    | Repetir extração.              |
| `switchCamera`       | Troca de câmera.               |
| `voltar`             | Voltar atrás.                  |

## Descrição

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

### Considerações

O payload útil está em `event.detail.detail` (ver [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;
});
```