Can I reference a param type in JSDoc @return?
I commented on the other answer that what I'm looking for boils down to a generic parameter, which is implemented in JSDoc with @template
. I don't know if it's part of core JSDoc -- I think it's a Closure extension -- but Typescript does recognize it if you're running your JS through TS, or just trying to get autocomplete working in your IDE.
Adapted from that link:
/**
* @template T
* @param {T} x - A generic parameter that flows through to the return type
* @return {T[]}
*/
function id(x) {
return [x];
}