> 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

Cambio de estado interno durante la captura.

## 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.                                                          |
| `codeInfo`      | Pantalla informativa del código localizado (foto + recuadro) tras la extracción del documento. |
| `readingCode`   | Escaneo en vivo del QR/código.                                                                 |
| `codesFinished` | Lectura de código completada (o omitida en modo `optional`).                                   |
| `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;
});
```