O que acha do JSDoc como alternativa ao TypeScript?

O JSDoc permite documentar o código JavaScript adicionando anotações de tipos nos comentários.

• Vantagens do JSDoc como alternativa ao TypeScript:
  • Não requer compilação: o código permanece como JavaScript puro.
  • Fácil de integrar em projetos existentes, sem necessidade de uma refatoração significativa.
  • É suportado por muitos IDEs para análise estática e autocompletar.
  • Permite gerar documentação a partir do código.
• Desvantagens do JSDoc em comparação com o TypeScript:
  • Não fornece garantias de segurança de tipos tão rigorosas quanto o TypeScript, pois as verificações ocorrem na fase de análise, não na compilação.
  • A sintaxe é menos explícita e pode ser menos legível do que a sintaxe do TypeScript.
  • Não suporta algumas funcionalidades mais avançadas do sistema de tipos do TypeScript (por exemplo, genéricos, tipos condicionais em sua totalidade).
  • Os erros de tipos são detectados na fase de análise do IDE ou de construção (se forem usadas ferramentas apropriadas), e não na fase de compilação.

Conclusão:

O JSDoc pode ser uma boa escolha para projetos pequenos ou para uma adoção progressiva de tipagem em uma base de código existente, quando reescrever completamente em TypeScript não é possível ou justificado. No entanto, para projetos grandes e complexos, onde a alta confiança nos tipos e na confiabilidade do código são importantes, o TypeScript é uma solução mais recomendada. O TypeScript oferece um sistema de tipagem mais poderoso e rigoroso, que ajuda a identificar erros nas fases iniciais do desenvolvimento.

Exemplo de JSDoc:

/**
 * @param {string} name Nome do utilizador.
 * @param {number} age Idade do utilizador.
 * @returns {string} Saudação.
 */
function greet(name, age) {
  return `Olá, ${name}! Tens ${age} anos.`;
}

Exemplo de TypeScript:

// Especificamos explicitamente os tipos dos parâmetros e do valor de retorno
function greet(name: string, age: number): string {
  return `Olá, ${name}! Tens ${age} anos.`;
}