javascript JSDOC备忘单

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了javascript JSDOC备忘单相关的知识,希望对你有一定的参考价值。

/** Functions **/

/*
 * @param {string} n - A string param
 * @return {string} A good string
 *
 * @throws {FooException}
 * @private
 * @deprecated
 * @see
 *
 * @function
 * @class
 */

function foo(n) { return n }

/** Types **/

/**
 * @param {string=} n - Optional param
 * @param {string} [n] - Optional param
 * @param {(string|number)} n - Multiple types
 * @param {*} n - Any type
 * @param {...string} n - Repeatable arguments
 * @param {string} [n="hi"] - Optional param with default
 * @param {string[]} n - An array of strings
 */
 
 /** Variables **/
 
 /**
 * @type {number}
 */
var FOO = 1

/**
 * @const {number}
 */
const FOO = 1

/** TypeDef **/
/**
 * A song
 * @typedef {Object} Song
 * @property {string} title - The title
 * @property {string} artist - The artist
 * @property {number} year - The year
 */

/**
 * Plays a song
 * @param {Song} song - The {@link Song} to be played
 */

function play (song) {
}

/** Renaming **/

/*
 * @alias Foo.bar
 * @name Foo.bar
 */

以上是关于javascript JSDOC备忘单的主要内容,如果未能解决你的问题,请参考以下文章

javascript JavaScript DocBlock备忘单

text Javascript OO备忘单

javascript 节点项目备忘单

javascript Firebase功能备忘单

javascript socket.io的快速备忘单

markdown Arrayzing - JavaScript数组备忘单