Can't get intellisense to link params for anonymous functions

[egamma]

From @Sequoia on July 14, 2016 14:7

• VSCode Version: Version 1.3.1 (1.3.1)
• OS Version: osx 10.11.5 (15F34)

Goal

return sftp.readdirAsync(dir)
  .then(function(/*Array<String>*/dirList) {
    dirList // <-- I want intellisense hinting on this array

Expected

## Actual

## Things I've tried 1. `.then(function(/*Array*/dirList ) {` 2. `.then(function(/**Array*/dirList ) {` 3. `.then(function(/**@type Array*/dirList ) {` 4. `.then(function(/**@type {Array}*/dirList ) {` 5. `.then(function(/**@type {String[]}*/dirList ) {` 6. `.then(/**@param {String[]} dirList */ function(dirList ) {` 7. `.then(function(dirList/**=String[]*/) {` 8. `.then(function(dirList/*=String[]*/) {` 9. `.then(function(dirList/*:String[]*/) {` 10. `.then(function(/**{String[]}:*/dirList ) {` 11. `.then(function(/*String[]:*/dirList ) {`

😢 Help

Copied from original issue: microsoft/vscode#9288

[egamma]

From @Sequoia on July 14, 2016 14:11

readdirAsync is result of promisifyAll so not easily doc-linkable. (i.e. I can't easily mark the @return {Promise<String[]>} on that method).

[egamma]

@Sequoia in general the supported jsdoc annotation are defined in this doc.

This form works for me:

 sftp.readdirAsync(dir)
  .then(
      /** @param {string} dirList*/function (dirList) {

This form does not work for me (open paren in front of jsdoc comment):

 sftp.readdirAsync(dir)
  .then
      (/** @param {string} dirList*/function (dirList) {

Moving to TypeScript for comment.

[mhegazy]

The second form that @egamma mentioned not working is due to #7533. this has since been fixed.

so:

return sftp.readdirAsync(dir)
.then(/**@param {String[]} dirList */ function(dirList ) {
    dirList.

should work.

[mhegazy]

I should note that the fix for this is part of TypeSript 2.1. VSCode ships with an older version of TypeScript. Please see Using Newer TypeScript Versions documentation for more details on updating your VSCode to use a different version of TypeScript.