在javascript中评论“null”值

Question

在javascript中评论null值的正确方法是什么？例如：

/**
 * Hides an element.
 * @param {String} id - element id (can be {@code null}).
 * @returns {undefined}.
 */
function hide(id) {

    if (id !== null) {
        document.getElementById(id).style.visibility = 'hidden';
    }
}

但是标签{@code null} 不起作用...

Answer 1

我自己也遇到了同样的问题，发现使用反引号 (``) 对我有用。使用示例中使用的 JSDoc 注释，它应该如下所示：

/**
 * Hides an element.
 * @param {String} id - element id (can be `null`).
 * @returns {undefined}.
 */