我一直在尝试使用 JSDoc 在 JS 中记录一个重载函数:
有 2 个用例:
assignSlave(ticket, userid);
assignSlave(ticket, firstname, lastname);
我想让它在 VSCode 中看起来像这样:
案例一
案例二
等等……
我尝试了 here 给出的解决方案,但它对我不起作用:
/**
* Test
*
* @function assignSlave
* @param {String} ticket
* @param {String} userid
*//**
* Test2
*
* @function assignSlave
* @param {String} ticket
* @param {String} firstname
* @param {String} lastname
*/
function assignSlave(a, b, c){}
assignSlave()
我明白了:
有没有办法实现我想要做的事情?
ETA:我试过这篇文章但我不确定它在我的情况下是如何工作的。
像下面的片段一样做。从
function
更改为 arrow function
并相应地设置其类型。最后一件事是为尾随参数分配一个默认值,以便重载类型彼此兼容。
/**
* @type {{
* (ticket: string, userid: string): void;
* (ticket: string, firstname: string, lastname: string): void;
* }}
*/
const assignSlave = (a, b, c = '') => {}
assignSlave('ticket', 'userid')
assignSlave('ticket', 'firstname', 'lastname')
这样函数被识别为 2 个重载:
过载 1
过载 2
在 TypeScript 5 中,您将能够使用
@overload
标签:
/**
* @overload
* @param {string} ticket
* @param {string} userId
*//**
* @overload
* @param {string} ticket
* @param {string} firstname
* @param {string} lastname
*//**
* @param {string} a
* @param {string} b
* @param {string} c
*/
function assignSlave(a, b, c) {}
供参考:
https://devblogs.microsoft.com/typescript/announcing-typescript-5-0-beta/#overload-support-in-jsdoc