Я использую Netbeans для добавления профессиональных комментариев к каждой функции, я пишу. Поэтому я начинаю каждую из них с /**
, а затем нажимаю Enter
, чтобы Netbeans выполнял схему комментариев по умолчанию для следующей функции.
До сих пор я использовал это только для языка PHP, и в этом случае Netbeans всегда добавлял часть @returns {type}
только в схеме комментариев, если в функции PHP действительно включался оператор return
. В так называемых "процедурах" (функции, которые не возвращают никакого значения) эта часть отсутствовала.
Сегодня я попробовал одно и то же для функции Javascript, а Netbeans добавила часть @returns {undefined}
для комментариев, даже если следующая функция ничего не возвращает.
Это меня смутило. Не предлагает ли Netbeans этот способ, чтобы каждая функция Javascript возвращала что-нибудь? Что мне делать? Игнорировать (или удалять) эту часть схемы комментариев или следовать предложению (если это вообще предложение) и добавить return false;
в конце такой функции, хотя для меня это бесполезно?