Diga adeus às más práticas de javascript

Nov 29 2022

Quando damos nossos primeiros passos no maravilhoso mundo da programação, podemos ver por nós mesmos o que ela faz por milhões de pessoas. É graças à programação que a vida de tantos se torna mais fácil, bastando apertar algumas teclas em seus aparelhos (Isso é mágico).

A programação é outro tipo de superpoder, mas como o Tio Ben disse a seu sobrinho, Peter Parker, “Com grandes poderes vêm grandes responsabilidades”. No mundo da programação, nossa maior responsabilidade é garantir que o código que escrevemos seja facilmente testável e permaneça sustentável ao longo do tempo.

Existem algumas pequenas práticas de programação que podem ter um impacto continuamente negativo no código que escrevemos e no produto que criamos como resultado final. Eu experimentei esses problemas em primeira mão. É importante compartilhar o que são e por que você deve evitá-los a todo custo.

1. Usando var em vez de let e const

É hora de dizer adeus ao uso de var.

Você deve usar apenas let e const por estes motivos:

● O escopo é mais claro (entre colchetes).

● Não cria objetos globais.

● Sinaliza erros se você os declarar novamente.

A menos que você esteja usando um navegador mais antigo, como o amado IE11, é do seu interesse abrir mão do var. Let e const serão seus melhores amigos daqui para frente.

2. Usando comentários para explicar o código

Os comentários são uma parte fundamental quando construímos um software, eles nos ajudam a entender um pouco melhor o código que estamos lendo, mas não devemos cair no erro de explicar passo a passo o que nosso código faz, devemos criar um código fácil de entender read e comentários devem apenas fornecer contexto.

Aqui estão algumas dicas e lembretes para ajudá-lo a escrever comentários de código como um profissional:

● Evite redundância em seus comentários; não escreva o que você faz, escreva porque você faz.

● Nomes de variáveis/funções/classes descritivas são melhores do que comentários descritivos.

● Resuma o máximo possível; não escreva parágrafos se não for absolutamente necessário.

● Tente usar sempre a mesma linguagem e estilo de comentários.

● Ao longo do tempo, os comentários geralmente não são mantidos (modificados) de código.

3. Usando == em vez de ===

A primeira coisa a entender é que, embora visualmente sejam muito semelhantes, eles fazem coisas diferentes: o primeiro é chamado de operador de igualdade regular (==) e o segundo é chamado de operador de igualdade estrita (===).

O operador regular de igualdade (==) apenas verifica se os operandos são semelhantes, o que pode causar algumas surpresas desagradáveis.

O operador de igualdade estrita (===) sempre verifica se os operandos são de tipos e valores diferentes e se são exatamente iguais.

4. Esquecer de usar o encadeamento opcional

O operador de encadeamento opcional (?), permite que você leia o valor de uma propriedade localizada no fundo de uma cadeia de objetos conectados sem ter que verificar cada referência única na cadeia.

Isso nos ajuda a evitar erros ao tentar acessar uma propriedade inexistente. Como exemplo, digamos que temos um objeto Pokémon que contém as informações desse Pokémon.

Quando queremos acessar uma propriedade que não está definida, como neste exemplo, acessar a propriedade 'ataque' Javascript irá gerar um erro, e nossa aplicação irá quebrar. Ao usar o encadeamento opcional (?), o Javascript nos dirá que a propriedade está indefinida, mas não gerará nenhum erro. Pensar nesses tipos de erros que às vezes fogem do nosso controle faz uma grande diferença a longo prazo.

5. Não usar cordas mágicas e números mágicos

Um número mágico ou strings mágicas são números ou strings usados diretamente no código que geralmente não têm um contexto claro, mas têm um propósito. É melhor atribuir esses valores a constantes, pois eles podem se tornar difíceis de entender e depurar de outra forma.

6. Tratamento inadequado de erros de chamada de API

Devemos sempre lidar com erros com um try/catch em nosso async/await.

Se não tratarmos os erros em nossas promessas, é muito provável que nossa aplicação exploda, e acredite, não queremos que isso aconteça.

7. Usando um objeto como um único parâmetro

Ao declarar uma função em que vários valores são esperados de um objeto, é melhor usar vários parâmetros de entrada em vez de entradas de objeto único. Isso nos ajuda em várias coisas:

Primeiro, torna nosso código mais fácil de ler, sabendo desde o início quais parâmetros nossa função precisa.

Em segundo lugar, torna a função mais fácil de testar, e essas duas coisas juntas ajudam nosso produto a ser mantido ao longo do tempo. Além disso, como um plus, melhora o desempenho do nosso aplicativo, pois evita a coleta de lixo ou a criação de parâmetros de objeto desnecessários.

Outra vantagem é que se você usar TypeScript e tiver vários parâmetros, é mais fácil definir a interface dos parâmetros para se beneficiar da verificação de tipos e sugestões automáticas, o que evita erros.

8. Esquecendo o poder das abreviaturas

Todos nós já nos perguntamos se existe uma variável ou se ela contém algum tipo de valor diferente de nulo ou indefinido. Por causa disso, muitas vezes acabamos fazendo validações super longas desse tipo:

As abreviações nos ajudam a evitar esse problema. De forma mais simples e elegante, o código acima pode ser reduzido a apenas o seguinte:

Conclusão

Escrever código limpo sempre será nossa responsabilidade. Em minha experiência como desenvolvedor, aprendi que ter um código fácil de ler e de fácil manutenção economizará muitas horas para você e sua equipe.

Lembre-se de que passamos mais tempo lendo código do que escrevendo. Espero que essas pequenas dicas facilitem sua tarefa de criar produtos mágicos e surpreendentes.