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

# trackStatus

## Detalles

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

**Evento:** `trackStatus`

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

### Sintaxis

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

### Objeto recibido

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

* `eventType` (`string`): Tipo de evento emitido.
* `currentState` (`string`) | `tapButton` (`string`): Clave dinámica con el estado o la acción (solo una presente por emisión).

**Valores `currentState`**:

| Valor          | Descripción                                   |
| -------------- | --------------------------------------------- |
| `initializing` | El motor de Selphi se está inicializando.     |
| `ready`        | Selphi ha cargado y está listo.               |
| `liveness`     | La prueba de vida activa ha iniciado.         |
| `analyzing`    | El proceso de captura ha iniciado.            |
| `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.   |
| `startCapture`     | Inicio de captura.         |
| `repeatExtraction` | Reintentar captura.        |
| `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/selphi-biometria-facial/eventos.md#formato-de-los-eventos)).

***

## Ejemplo

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