jsDoc use overloaded function documentations in intellisense.

[aliemre1990]

Issue Type: Feature Request

It would be nice to see variations of functions documented like below code, when typing the function. I documented overloaded function according to this link jsdoc/jsdoc#1017 .

/**
 * Returns imported styles in 'dir/dir/style.scss' format.
 * @returns {string[]} Imported style's paths.
 *//**
* Returns imported styles in 'dir/dir/style.scss' format.
* @param {string} content File content to be used in operation.
* @returns {string[]} Imported style's paths.
*/
StyleFile.prototype.getImportedStylePaths = function (content) {
    if (!content)
        content = this.content;
....
}

Current behavior when typing.

Expected to be like below. ( Would like to see '+ overload').

And current behavior after typing

Expected. I would like to move with arrows between variations.

VS Code version: Code 1.33.0 (0dd516dd412d42323fc3464531b1c715d51c4c1a, 2019-04-04T15:14:28.026Z)
OS version: Windows_NT x64 10.0.17134

[mjbvz]

Related #25590

[zavr-1]

@aliemre1990 good luck waiting for a few years before this issue gets addressed. MS only wants people to use TS so I wouldn't count on your issue being resolved any time soon. If you reading this in 2021, what did I say?

[sandersn]

Duplicate of #25590.

[JoakimCh]

@aliemre1990 good luck waiting for a few years before this issue gets addressed. MS only wants people to use TS so I wouldn't count on your issue being resolved any time soon. If you reading this in 2021, what did I say?

You seem to have a point, almost 2021 now.

[kPepis]

Welp, it is 2021 and I just landed here 🤷

[jhunterkohler]

I am not a big Typescript fan (probably because I'm a C++ fan) but I'm such a big IntelliSense fan.

+1 to this to support the bitter JSDoc clingers like myself.

[igorskyflyer]

+1, just spent 2.5h trying to get overloads to appear properly in Intellisense in a TypeScript project; it was a JavaScript project but I converted it to TypeScript, hoping I could get overloads + JSDocs to work. It does work, I got my overloads with proper types, documentation about parameters and you can go through the overloads when auto-completing, but... Never going that road again.

[Darker]

Another year behind us, we still one this. Just like @HunterKohler I'm a C++ programmer and a stickler for JSDoc+vanilla JS, mostly because I don't really want to be compiling a script language.