> 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/propiedades/maxattempts.md).

# maxAttempts

Número máximo de tentativas de captura facial.

## Detalhes

**Atributo:** `max-attempts`

**Tipo:** `number`

**Valores permitidos:** `0` ou superior

**Valor padrão:** o do motor de captura (a propriedade só é enviada se for definida)

## Morfologia

```typescript
selphi.maxAttempts = 3;
```

## Descrição

Número máximo de tentativas de captura que o usuário pode realizar em `facephi-selphi-widget` antes que o Widget considere o processo esgotado.

Quando o limite é ultrapassado, o Widget emite [maxAttemptsExceeded](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/maxattemptsexceeded.md) e para de tentar a captura novamente. Sem essa propriedade, a integração tinha que controlar a contagem de tentativas por conta própria a partir de [extractionTimeout](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/extractiontimeout.md) e [timeoutErrorButtonClick](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/eventos/timeouterrorbuttonclick.md).

### Considerações

Se a propriedade não for definida, o Widget não a envia ao motor e é aplicado o valor padrão do motor de captura.

Esta propriedade limita as tentativas do Fluxo completo de captura. Não substitui a [livenessMoveFailedAttempts](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphi-biometria-facial/propiedades/livenessmovefailedattempts.md), que controla as tentativas malsucedidas dentro de cada etapa do teste de vida ativa.

***

## Exemplo

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