Microsoft/TypeScript

JSDoc support for destructured parameters

Open

#11,859 opened on Oct 26, 2016

View on GitHub
 (12 comments) (44 reactions) (0 assignees)TypeScript (48,455 stars) (6,726 forks)batch import
Domain: JSDocHelp WantedIn DiscussionSuggestionVS Code Tracked

Description

TypeScript Version: 2.0.3

Code

interface Foo {
    /**
     * A bar value
     */
    bar?: string;
}

/**
 * A function
 *
 * @param foo A param
 * @param { bar } Another param
 * @param bar Another param
 */
function foo(foo: string, { bar }: Foo): void {
    bar;
    foo;
}

foo('bar', { bar: 'play' });

Expected behavior:

Intellisense for the second argument, or the second argument properties.

Actual behavior:

No way of providing a description for the destructured elements of a destructured parameter.

destructured

Contributor guide