> For the complete documentation index, see [llms.txt](https://docs.apipass.com.br/documentacao-apipass/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apipass.com.br/documentacao-apipass/desenvolvimento-de-fluxos/fluxos/componentes-do-fluxo/conectores-steps/conector-nodejs/boas-praticas.md).

# 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**](/documentacao-apipass/desenvolvimento-de-fluxos/fluxos/componentes-do-fluxo/conectores-steps/conector-nodejs/pacotes-npm-disponiveis.md). 
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="/files/9a7OkmiogcT1aymitDI2" 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.