# Códigos de erro do SDK

> Lista dos códigos E_* estáveis retornados por extensões, pacotes, fluxos e conectores do CatSuite, com o significado de cada um.

- Idioma: pt-BR
- URL canônica: https://netcattest.com/catsuite/docs/referencia/erros
- Seção: Referência
- Atualizado: 2026-10-05
- Outro idioma (en): https://netcattest.com/catsuite/en/docs/reference/errors

Os erros do SDK usam códigos `E_*` estáveis, com descrição traduzida na interface. Use o código para tratar falhas no seu JavaScript e para pesquisar nos registros.

```js
try {
  await cat.http.send({url: 'https://api.aurora.test/timeout'});
} catch (erro) {
  if (erro.code === 'E_TIMEOUT') {
    cat.log({'pt-BR': 'Tempo esgotado.', en: 'Timed out.'}, 'warning');
  }
}
```

## Pacote e manifesto

| Código | Significado |
|---|---|
| `E_PACKAGE` | pacote inválido |
| `E_MANIFEST` | manifesto inválido |
| `E_TRANSLATION` | o pacote deve incluir português brasileiro e inglês |
| `E_VERSION` | versão do pacote ou do SDK incompatível |
| `E_ENTRY` | arquivo JavaScript de entrada inválido |
| `E_HASH` | a integridade do pacote não corresponde ao manifesto |
| `E_PATH` | o pacote contém um caminho não permitido |
| `E_SIZE` | o limite de tamanho foi excedido |
| `E_SETTINGS` | `settingsSchema` inválido |
| `E_SIGNATURE` | assinatura inválida |
| `E_UNSIGNED` | arquivo antigo sem assinatura; revise e aprove para criar uma revisão assinada localmente |

## Execução

| Código | Significado |
|---|---|
| `E_SERVICE` | motor de extensões indisponível |
| `E_RUNTIME` | falha na execução da extensão |
| `E_SYNTAX` | o código JavaScript contém um erro de sintaxe |
| `E_EVENT` | evento ou handler inválido |
| `E_HOOK_ASYNC` | handlers de alteração precisam ser síncronos |
| `E_TIMEOUT` | o tempo de execução foi excedido |
| `E_MEMORY` | o limite de memória foi excedido |
| `E_QUEUE` | a fila de execução está cheia |
| `E_LIMIT` | o limite de extensões ou recursos foi atingido |
| `E_DISABLED` | a extensão está desativada |
| `E_SUSPENDED` | a extensão foi suspensa após falhas consecutivas |
| `E_COMMAND` | comando inválido ou indisponível |
| `E_UI` | componente de interface inválido |

## Permissões e destinos

| Código | Significado |
|---|---|
| `E_PERMISSION` | a extensão não tem permissão para esta operação |
| `E_APPROVAL` | revise as permissões antes de ativar |
| `E_HOST` | destino fora do escopo permitido |
| `E_PRIVATE_DESTINATION` | o destino resolveu para um endereço privado sem escopo explícito |
| `E_PROXY_LOOP` | o envio aponta para o próprio proxy do CatSuite |
| `E_METHOD` | lista de métodos inválida |

## HTTP

| Código | Significado |
|---|---|
| `E_HTTP` | mensagem HTTP inválida |
| `E_HEADER` | cabeçalho HTTP inválido |
| `E_BODY` | este corpo HTTP não pode ser modificado |
| `E_CANCELLED` | envio cancelado |
| `E_EXTERNAL` | a API simulada retornou um erro |
| `E_LABORATORY` | ative o modo laboratório nas configurações da extensão |

## Dados e credenciais

| Código | Significado |
|---|---|
| `E_STORAGE` | o limite de armazenamento foi excedido |
| `E_FINDING` | achado inválido |
| `E_CREDENTIAL` | credencial indisponível |
| `E_CREDENTIAL_PROTECTION` | credenciais operacionais exigem proteção SECRET |
| `E_RECOVERY` | não foi possível concluir a recuperação segura |

## Fluxos e conectores

| Código | Significado |
|---|---|
| `E_STEP` | etapa inválida ou não registrada |
| `E_PARSER` | parser inválido ou repetido |
| `E_CHECKPOINT` | checkpoint inválido ou maior que 32 KiB |
| `E_FLOW` | definição de fluxo inválida |
| `E_JOB` | a tarefa remota não está disponível; revise o resultado antes de reenviar |
| `E_CONNECTOR` | falha ao falar com o conector |
| `E_PAIRING` | pareamento inválido |
| `E_CAPABILITY_UNAVAILABLE` | a capacidade não está disponível no conector |
| `E_SCHEMA_OPERATION` | seleção de operações do OpenAPI inválida |