ES 2015 模組
JSDoc 3 使得文件化遵循 ECMAScript 2015 規範 的模組成為可能。ES 2015 模組在 JSDoc 3.4.0 及更新版本中受到支援。
模組識別碼
當您文件化 ES 2015 模組時，您將使用 @module 標籤 來文件化模組的識別碼。例如，如果使用者透過呼叫 import * as myShirt from 'my/shirt' 來載入模組，您將撰寫包含標籤 @module my/shirt 的 JSDoc 註解。
如果您在沒有值的情況下使用 @module 標籤，JSDoc 將嘗試根據檔案路徑猜測正確的模組識別碼。
當您使用 JSDoc 名稱路徑 從其他 JSDoc 註解來參照模組時，您必須加上前綴 module:。例如，如果您希望 my/pants 模組的文件連結到 my/shirt 模組，您可以使用 @see 標籤 來文件化 my/pants，如下所示
/**
* Pants module.
* @module my/pants
* @see module:my/shirt
*/
類似地，模組中每個成員的名稱路徑將以 module: 開頭，後接模組名稱。例如，如果您的 my/pants 模組匯出 Jeans 類別，而 Jeans 有個名為 hem 的實例方法，則實例方法的長名稱為 module:my/pants.Jeans#hem。
匯出的值
以下範例顯示如何文件化 ES 2015 模組中不同類型的匯出值。在大多數情況下，您只需將 JSDoc 註解新增到定義匯出值的 export 陳述式即可。如果您在其他名稱下匯出值，您可以在其 export 區塊中文件化匯出值。
/** @module color/mixer */
/** The name of the module. */
export const name = 'mixer';
/** The most recent blended color. */
export var lastColor = null;
/**
* Blend two colors together.
* @param {string} color1 - The first color, in hexadecimal format.
* @param {string} color2 - The second color, in hexadecimal format.
* @return {string} The blended color.
*/
export function blend(color1, color2) {}
// convert color to array of RGB values (0-255)
function rgbify(color) {}
export {
/**
* Get the red, green, and blue values of a color.
* @function
* @param {string} color - A color, in hexadecimal format.
* @returns {Array.<number>} An array of the red, green, and blue values,
* each ranging from 0 to 255.
*/
rgbify as toRgb
}