exceptionCaptured

Ocorreu uma exceção durante a execução.

Detalhes

É emitido diante de erros ou situações inesperadas durante a captura.

Evento: exceptionCaptured

Tipo: FacephiSelphidWidgetCustomEvent<ExceptionCapturedEvent> | CustomEvent<ExceptionCapturedEvent>

Sintaxe

selphid.addEventListener('exceptionCaptured', onExceptionCaptured);

Objeto recebido

A carga útil é do tipo SelphidExceptionCapturedDetail e está em event.detail.detail:

• eventType (string): Tipo de evento emitido.

• exceptionType (string): Tipo de exceção (ExceptionType).

• message (string): Descrição breve do erro.

• code (string): Código de erro associado a exceptionType.

Valores exceptionType — terminais:

Valor	Descrição
AndroidWebViewBehaviour	O widget não pode ser executado no WebView do Android.
BrowserApiNotCompatible	O navegador não é compatível.
CameraHardwareError	Erro ao acessar a câmera.
PermissionsDenied	Permissões necessárias não concedidas.
CameraPermissionDenied	Permissão de câmera negada.
MicrophonePermissionDenied	Permissão de microfone negada.
SettingsError	Propriedade de configuração com formato incorreto.
UnknownInternalError	Erro interno desconhecido.
ExternalCameraChangeTimeout	Timeout ao trocar a câmera externa.

Valores exceptionType — extração:

Valor	Descrição
ErrorTimeout	O limite de tempo de extração foi excedido.

Valores code:

exceptionType	Código
AndroidWebViewBehaviour	SPD_318
UnknownInternalError	SPD_329
CameraHardwareError	SPD_305
PermissionsDenied	SPD_332
CameraPermissionDenied	SPD_301
MicrophonePermissionDenied	SPD_319
SettingsError	SPD_320
BrowserApiNotCompatible	SPD_321
ErrorTimeout	SPD_001

Descrição

Permite filtrar e reagir aos diferentes tipos de erro durante a captura do documento.

Considerações

A carga útil está em event.detail.detail (ver formato de eventos). As exceções terminais exibem uma tela de erro e fecham o widget após errorTimer.

Os códigos SPD estão alinhados com a tabela de resultados. Para ExternalCameraChangeTimeout, consulte o valor emitido em code.

---

Exemplo

<facephi-selphid-widget
    onExceptionCaptured={(event) => {
      const { exceptionType, message, code } = event.detail.detail;
      console.error(code, exceptionType, message);
    }}
/>

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

selphid.addEventListener('exceptionCaptured', (event) => {
  const detail: SelphidExceptionCapturedDetail = event.detail.detail;
});