> 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/sdks/sdk-web/componentes/selphid-documentos/eventos/trackstatus.md).

# trackStatus

## Detalles

Se emite tras acciones del usuario o cambios de estado durante el flujo de captura.

**Evento:** `trackStatus`

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

### Sintaxis

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

### Objeto recibido

El payload útil es de tipo `SelphidTrackStatusDetail` y está en `event.detail.detail`:

* `eventType` (`string`): Tipo de evento emitido.
* `currentState` (`string`) | `tapButton` (`string`) | `retriesConsumed` (`number`) | `documentPresent` (`boolean`): Clave dinámica con el estado, la acción o metadatos de captura (solo las presentes en cada emisión).

**Valores `currentState`**:

| Valor          | Descripción                                   |
| -------------- | --------------------------------------------- |
| `initializing` | El motor de SelphID se está inicializando.    |
| `initEngine`   | Inicialización del motor en curso.            |
| `ready`        | SelphID ha cargado y está listo.              |
| `analyzing`    | La imagen actual está siendo analizada.       |
| `previewImage` | Se muestra la previsualización de la captura. |
| `resetting`    | El motor interno se está reiniciando.         |
| `finish`       | La captura ha finalizado.                     |
| `error`        | Ha ocurrido un error en el flujo.             |
| `end`          | La extracción ha finalizado.                  |

**Valores `tapButton`**:

| Valor                | Descripción                |
| -------------------- | -------------------------- |
| `tutorial`           | Botón de tutorial pulsado. |
| `exit`               | Botón de cerrar pulsado.   |
| `repeatExtraction`   | Reintentar captura.        |
| `continueExtraction` | Continuar extracción.      |
| `finishExtraction`   | Finalizar extracción.      |
| `retryExtraction`    | Reintentar extracción.     |
| `switchCamera`       | Cambio de cámara.          |
| `back`               | Volver atrás.              |

## Descripción

Permite rastrear las acciones del usuario y los cambios de estado internos del widget.

### Consideraciones

El payload útil está en `event.detail.detail` (ver [formato de eventos](/sdks/sdk-web/componentes/selphid-documentos/eventos.md#formato-de-los-eventos)).

***

## Ejemplo

```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;
});
```