Estou usando o Netbeans para adicionar comentários profissionais a cada função que escrevo. Então, começo cada um com /**
e pressiono Enter
para permitir que o Netbeans cumpra o esquema de comentários padrão para a função seguinte.
Até agora, usei isso apenas para a linguagem PHP e, neste caso, o Netbeans estava sempre adicionando @returns {type}
parte no esquema de comentários apenas, se a função PHP seguinte realmente incluísse a return
instrução. Nos chamados "procedimentos" (funções que não retornam nenhum valor) esta parte estava faltando.
Hoje eu tentei a mesma coisa para a função Javascript e o Netbeans adicionou @returns {undefined}
parte ao esquema de comentários, embora a função seguinte não retorne nada.
Isso me confundiu. O Netbeans sugere desta forma, que toda função Javascript deve retornar alguma coisa? O que devo fazer? Ignorar (ou excluir) essa parte do esquema de comentários ou seguir a sugestão (se for uma sugestão) e adicionar return false;
no final dessa função, embora seja inútil para mim?
undefined
. Em muitos idiomas, o resultado da última instrução é retornado (mais útil, IMO). Esses são chamados de retornos implícitos .