Use typescript namespace in JSDoc comments

[mjbvz]

From @Liero on November 22, 2017 15:5

When I install npm package, VS Code nicely shows typescript definitions in javascript file:

I would expect, that I will be able to use these definitions in JSDoc comments:

/**
 * compiles application javascripts using specified bundler, either browserify or watchify
 * @param {browserify.BrowserifyObject} bundler
 * @param {string} bundleFileName - output javascript file
 */
function compileJs(bundler, bundleFileName) {

But the parameter type is still reported as any:

Copied from original issue: microsoft/vscode#38964

[mjbvz]

@Liero Do you import or require broswerify anywhere in that file?

Possibly related to #11825 and #14377

[mhegazy]

looks like a duplicate of #14377

[Liero]

@mjbvz:

Do you import or require broswerify anywhere in that file?

yes, I do. Otherwise I would not be able to call browserify(), see the first screenshot. The definitions are actually downloaded and works, but I'm not able to use it in my own JSDoc comments (see seconds screenshot)

[Liero]

@mhegazy:

looks like a duplicate of #14377

Is it? I'm not sure. I'm actually importing the `browserify' module, see my previous comment

[mhegazy]

Is it? I'm not sure. I'm actually importing the `browserify' module, see my previous comment

Well, i can not tell if you are from the screen shot above. if you are not importing it, then you need #14377 to be fixed, if you are, then you are running into #16489

[Liero]

@mhegazy:
it looks like this could be duplicate of #16489. Just make sure following works, pls:

const browserify = require('browserify');
var b = browserify(); //definitions are shown in tooltips and autocomplete hints

/** @param {browserify.BrowserifyObject} bundler */
function compileJs(bundler) {
  //bundler is reported as any...
}

package.json:

{
  "devDependencies": {
    "browserify": "^14.5.0"
  }
}

[typescript-bot]

Automatically closing this issue for housekeeping purposes. The issue labels indicate that it is unactionable at the moment or has already been addressed.