Лучший способ документировать анонимные объекты и функции с помощью jsdoc

Вы можете документировать то, чего нет в коде, используя тег @name.

/**
 * Description of the function
 * @name IDontReallyExist
 * @function
 * @param {String} someParameter Description
*/

/**
 * The CallAgain method calls the provided function twice
 * @param {IDontReallyExist} func The function to call twice
*/
exports.CallAgain = function(func) { func(); func(); }

Вот документация по тегу @name. Вам также могут пригодиться пути имен.

Вы можете использовать @callback или @typedef.

/**
 * @callback arrayCallback
 * @param  {object} element - Value of array element
 * @param  {number} index   - Index of array element
 * @param  {Array}  array   - Array itself
 */

/**
 * @param {arrayCallback} callback - function applied against elements
 * @return {Array} with elements transformed by callback
 */
Array.prototype.map = function(callback) { ... }

Чтобы дополнить ответ Стаджика, я привел пример, показывающий, что такое JsDoc с Google Closure. Компилятор позволяет это сделать.

Обратите внимание, что задокументированные анонимные типы удаляются из сгенерированного мини-файла, а компилятор обеспечивает передачу допустимых объектов (когда это возможно). Однако, даже если вы не используете компилятор, он может помочь следующему разработчику и таким инструментам, как WebStorm (IntelliJ), понять его и обеспечить автодополнение кода.

// This defines an named type that you don't need much besides its name in the code
// Look at the definition of Page#getPage which illustrates defining a type inline
/**  @typedef { pageId : string, pageName : string, contents: string} */
var PageResponse;

/**
 * @class {Page} Page Class specification
 */
var Page = function() {    
    /**
     * Get a page from the server
     * @param {PageRequest} pageRequest Info on the page you want to request
     *
     * The type for the second parameter for the function below is defined inline
     *
     * @param {function(PageResponse, {statusCode: number, statusMsg: string})} callback
     *        Function executed when page is retrieved
     */
    this.getPage = function(pageRequest, callback) {
    }; 
};

@link может добавлять встроенные ссылки на методы и классы.

/**
 * Get a page from the server
 * @param {PageRequest} pageRequest Info on the page you want to request
 * @param {function} callback Function executed when page is retrieved<br />
 * function({@link PageResponse} pageResponse,{@link PageRequestStatus} pageRequestStatus)
 */
this.getPage = function (pageRequest, callback) {
};

Не идеально, но со своей задачей справляется.

Аннотации Google Closure Compiler содержат выражения типов для это включает в себя возможность указать тип для определенных аргументов, тип возвращаемого значения и даже это. Многие библиотеки следят за аннотациями Google Closure Compiler, потому что хотят использовать их для сжатия своего кода. Так что у него есть некоторый импульс. Недостатком является то, что я не вижу способа дать описание.

Для предоставления описания, возможно, подойдет подход JSDoc Toolkit Parameters With Properties ( смотрите внизу страницы). Это то, что я делаю прямо сейчас. JSDoc Toolkit готовится начать работу над версией 3, поэтому отзывы могут быть хорошими.

Вы можете использовать @see для ссылки на другой метод в том же классе. Этот метод никогда не будет использоваться, он будет использоваться только для целей документации.

/**
 * @class {Page} Page Class specification
 */
var Page = function() {

    /**
     * Get a page from the server
     * @param {PageRequest} pageRequest Info on the page you want to request
     * @param {function} callback Function executed when page is retrieved
     * @see #getPageCallback 
     */
    this.getPage = function (pageRequest, callback) {
    }; 

    /**
     * Called when page request completes 
     * @param {PageResponse} pageResponse The requested page
     * @param {PageRequestStatus} pageRequestStatus Status of the page
     */
    //#ifdef 0
    this.getPageCallback = function (pageResponse, pageRequestStatus) { };
    //#endif 
};

Если вы используете какую-то систему сборки, фиктивный метод можно легко исключить из сборки.