# Boas práticas

A APIPASS oferece um conector Node.js, seguir boas práticas de desenvolvimento é essencial para garantir que suas integrações sejam eficientes, seguras e de fácil manutenção. Abaixo, descrevemos algumas boas práticas comuns e fornecer um exemplo prático em Node.js:

**Boas Práticas em um Conector Node.js:**

1. **Usar Módulos e Bibliotecas**: O conector disponibiliza algumas bibliotecas conhecidas da plataforma NodeJs, conforme mencionado no tópico [**Pacotes NPM disponíveis**](https://docs.apipass.com.br/documentacao-apipass/desenvolvimento-de-fluxos/componentes-do-fluxo/conectores-steps/conector-nodejs/pacotes-npm-disponiveis). 
2. **Gerenciar Erros Adequadamente**: Utilize tratamento de erros para garantir que seu código lide com exceções de maneira apropriada. Isso inclui o uso de blocos `try...catch` e o registro de erros de forma significativa.
3. **Padronização de Código**: Siga um estilo de codificação consistente. O uso de ferramentas como ESLint pode ajudar a garantir que o código siga padrões estabelecidos.
4. **Documentação Clara**: Documente seu código de forma clara, incluindo comentários explicativos, documentação de funções e descrições de parâmetros.
5. **Gestão de Dependências de Forma Segura**: A gestão de dependências é feita pelo time de plataforma da APIPASS. 
6. **Testes Automatizados**: Crie testes automatizados para verificar se o seu código funciona conforme o esperado. Use estruturas de teste como Mocha ou Jest.

Aqui está um exemplo de código Node.js que usa a biblioteca `htmlencode` para codificar uma string:

<figure><img src="https://1306291473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDzvP8voRuAZBRwdfQgKE%2Fuploads%2FxGGSiDK5WR1nfQkCehmn%2Fimage.png?alt=media&#x26;token=2ec86a77-7d80-4a66-9171-9e7ce8f47ee1" alt=""><figcaption></figcaption></figure>

Neste exemplo, a biblioteca `htmlencode` é importada, e uma string contendo código HTML malicioso é codificada usando a função `htmlEncode()`. O resultado é uma versão segura da string que pode ser exibida em uma página web sem executar o código malicioso.

### IMPORTANTE:

Por questões de segurança, não é possível executar chamadas externas a partir do conector NodeJs, também não é possível importar bibliotecas usando o Require.

O uso do conector NodeJs é recomendado para cenários de mapeamento e manipulação de dados, considere o uso de outros conectores para demais casos de uso.&#x20;

Em caso de dúvida entre em contato com time de suporte da APIPASS para identificar o conector ideal para o seu caso de uso.