TypeScript removes JSDoc comments for overloaded functions

[joshuat]

Bug Report

TypeScript removes JSDoc comments from above overloaded functions regardless of removeComments.

🔎 Search Terms

comment; removeComments; overloaded comments;

🕗 Version & Regression Information

This is present in all versions from v3.3.3 and above, likely below as well.

⏯ Playground Link

Playground link with relevant code

💻 Code

/**
 * Missing jsDoc comment
 */
export function overloaded(
  value: number,
): number;
export function overloaded(
  value: string,
): string;
export function overloaded(
  value: number | string,
): number | string {
  if (typeof value === 'number') {
    return value * 2;
  }
  if (typeof value === 'string') {
    return value + '';
  }
}

🙁 Actual behavior

export function overloaded(value) {
    if (typeof value === 'number') {
        return value * 2;
    }
    if (typeof value === 'string') {
        return value + '';
    }
    value;
    throw new Error('Invalid value supplied');
}

🙂 Expected behavior

/**
 * Missing jsDoc comment
 */
export function overloaded(value) {
    if (typeof value === 'number') {
        return value * 2;
    }
    if (typeof value === 'string') {
        return value + '';
    }
    value;
    throw new Error('Invalid value supplied');
}

[david-shortman]

Function overloads don't exist in JS, and the doc comments are removed. The comment is preserved when it is applied to the base method: playground

[MartinJohns]

Duplicate of #27981. Used search terms: JSDoc overload in:title