trackStatus

Internal status change during capture.

Details

It is emitted after user actions or state changes during the capture Flow.

Event: trackStatus

Type: FacephiSelphiWidgetCustomEvent<TrackStatusEvent> | CustomEvent<TrackStatusEvent>

Syntax

selphi.addEventListener('trackStatus', onTrackStatus);

Received object

The useful payload is of type SelphiTrackStatusDetail and is in event.detail.detail:

• eventType (string): Type of event emitted.

• currentState (string) | tapButton (string): Dynamic key with the state or action (only one present per emission).

Values currentState:

Value	Description
initializing	The Selphi engine is initializing.
ready	Selphi has loaded and is ready.
liveness	The active liveness check has started.
analyzing	The capture process has started.
previewImage	The capture preview is shown.
resetting	The internal engine is restarting.
finish	The capture has finished.
error	An error has occurred in the Flow.
end	The extraction has finished.

Values tapButton:

Value	Description
tutorial	Tutorial button pressed.
exit	Close button pressed.
startCapture	Capture started.
repeatExtraction	Retry capture.
finishExtraction	Finish extraction.
retryExtraction	Retry extraction.
switchCamera	Camera switched.
back	Go back.

Description

Allows tracking user actions and the Widget's internal state changes.

Considerations

The useful payload is in event.detail.detail (see event format).

---

Example

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

import { type SelphiTrackStatusDetail } from '@facephi/sdk-web-wc';

selphi.addEventListener('trackStatus', (event) => {
  const detail: SelphiTrackStatusDetail = event.detail.detail;
});