Optional arguments in JSDoc types may be moved to TypeScript types quickfix

TypeScript Version: 3.4.3

• 80004
• jsdoc quickfix optional

Code

With Closure Compiler, you mark a function parameter optional by adding an = after its type (reference):

/**
 * @param a {string} Base string.
 * @param b {string=} Optional string to add
 * @return {string}
 */
function foo(a, b) {
  if (b) return a + b;
  return a;
}

TypeScript offers a quickfix to convert these jsdoc annotations to TypeScript types:

Expected behavior:

The b parameter should be optional:

/**
 * @param a {string} Base string.
 * @param b {string=} Optional string to add
 * @return {string}
 */
function foo(a: string, b?: string): string {
  if (b) return a + b;
  return a;
}

Actual behavior:

The b parameter is required but has type string | optional:

/**
 * @param a {string} Base string.
 * @param b {string=} Optional string to add
 * @return {string}
 */
function foo(a: string, b: string | undefined): string {
  if (b) return a + b;
  return a;
}

This means that all calls of the function which don't specify b will be flagged as errors.

Playground Link: link, though quickfixes are not available there

Related Issues:

Beginnen Sie damit, den Quickfix für JSDoc-to-TypeScript-Typen mit der bereitgestellten foo-Funktion zu reproduzieren und vergleichen Sie den generierten Parametertyp mit dem erwarteten optionalen Parameter. Verfolgen Sie den Einstiegspunkt des Quickfixes und fügen Sie eine Regressionstestabdeckung hinzu, die zeigt, dass Aufrufe, bei denen b weggelassen wird, akzeptiert werden, während der generierte Rückgabetyp string bleibt.