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

# codeReader

Etapa opcional de captura de QR/código após extrair o documento.

## Detalhes

**Atributo:** `code-reader`

**Tipo:** `CodeReader`

**Valor padrão:** `CodeReader.Off`

### CodeReader

| Membro      | Valor         | Descrição                                                                                                                                                         |
| ----------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Off`       | `'off'`       | Não abre a tela de código nem baixa os recursos do leitor (valor padrão).                                                                                         |
| `Optional`  | `'optional'`  | Abre a tela se o catálogo pedir. Se o orçamento de captura se esgotar, pula o código e emite `extractionFinish` sem dados de código.                              |
| `Mandatory` | `'mandatory'` | Igual a `optional`, mas se o código não for lido, mostra tempo limite e emite `extractionTimeout`. A nova tentativa retoma a leitura do código, não do documento. |

## Morfologia

```typescript
import { CodeReader } from '@facephi/selphid-web-component';

selphid.codeReader = CodeReader.Optional;
```

## Descrição

Ativa uma etapa **opcional** de captura de QR/código **durante** uma extração do documento em `facephi-selphid-widget`.

Não substitui nem usa [`barcode`](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/propiedades/barcode.md) / [`barcodeSide`](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/propiedades/barcodeside.md): esses controlam o leitor de barcode do motor de documento. `codeReader` monta a mesma instância de `<facephi-selphid>` e se ativa apenas com `settings.codeReader`.

O resultado do código vai em `event.detail.ocrResult` (`encoded` e `images`), não em `result.images`. Com `tokenize: true`, o payload tokenizado atual usa chaves como `qr_back_0` e `qr_back_0_content`.

Estados de telemetria relacionados em [`trackStatus`](/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/trackstatus.md): `codeInfo`, `readingCode`, `codesFinished`.

***

## Exemplo

```jsx
import { CodeReader } from '@facephi/selphid-web-component';

<facephi-selphid-widget
    codeReader={CodeReader.Optional}
    captureRetries={3}
    captureTimeout={10}
/>
```