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

# maxAttempts

Número máximo de tentativas de captura do documento.

## 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
selphid.maxAttempts = 3;
```

## Descrição

Número máximo de tentativas de captura que o usuário pode realizar em `facephi-selphid-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/selphid-documentos/eventos/maxattemptsexceeded.md) e para de tentar capturar novamente. Sem essa propriedade, a Integração tinha que controlar por conta própria a contagem de tentativas a partir de [extractionTimeout](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/extractiontimeout.md) e [timeoutErrorButtonClick](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/timeouterrorbuttonclick.md).

### Considerações

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

Esta propriedade limita as tentativas do Fluxo completo de captura. Não substitui a [captureRetries](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/propiedades/captureretries.md), que controla as tentativas de captura de cada lado do documento.

***

## Exemplo

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