> 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 mecanismo 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](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/maxattemptsexceeded.md) e para de tentar novamente a captura. Sem essa propriedade, a integração precisava controlar as tentativas por conta própria com base em [extractionTimeout](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/extractiontimeout.md) e [timeoutErrorButtonClick](https://docs.facephi.com/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 mecanismo, e o valor padrão do mecanismo de captura é aplicado.

Esta propriedade limita as tentativas do fluxo completo de captura. Ela não substitui [captureRetries](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/propiedades/captureretries.md), que controla as novas tentativas de captura de cada lado do documento.

***

## Exemplo

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