> 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/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/maxattemptsexceeded.md).

# maxAttemptsExceeded

As tentativas de captura permitidas se esgotaram.

## Detalhes

É emitido quando o usuário ultrapassa o número de tentativas configurado em [maxAttempts](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/maxattempts.md).

**Evento:** `maxAttemptsExceeded`

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

### Sintaxe

```typescript
selphi.addEventListener('maxAttemptsExceeded', onMaxAttemptsExceeded);
```

### Objeto recebido

O payload útil está em `event.detail.detail`:

* `eventType` (`string`): Tipo de evento emitido.
* `message` (`string`): Breve descrição do motivo pelo qual as tentativas foram esgotadas.

## Descrição

Indica que o usuário consumiu todas as tentativas de captura permitidas e que o widget não vai tentar o processo novamente. Ao contrário de [extractionTimeout](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/extractiontimeout.md), que é emitido a cada tentativa expirada e permite tentar novamente, este evento marca o fim do fluxo de captura.

A Integração deve decidir aqui como continuar: mostrar uma tela de erro própria, oferecer um canal alternativo de verificação ou encerrar o processo.

### Considerações

Só é emitido se [maxAttempts](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/maxattempts.md) estiver configurado com um limite que o mecanismo possa esgotar.

O payload útil está em `event.detail.detail` (veja [formato de eventos](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos.md#formato-de-los-eventos)).

O widget registra este caso no Tracking com estado `EXPIRED` e motivo `SELPHI_MAX_ATTEMPTS`.

***

## Exemplo

```jsx
<facephi-selphi-widget
    maxAttempts={3}
    onMaxAttemptsExceeded={(event) => {
      const { message } = event.detail.detail;
      console.log('Intentos agotados:', message);
      showRetriesExceededView();
    }}
/>
```

```typescript
import { type MaxAttemptsExceededEvent } from '@facephi/selphi-web-component';

selphi.addEventListener('maxAttemptsExceeded', (event: CustomEvent<MaxAttemptsExceededEvent>) => {
  const detail = event.detail.detail;
  console.log('maxAttemptsExceeded:', detail);
});
```