Unable to mark JS functions as not being constructors (TS80002)

Bug Report

TS80002 ("This constructor function may be turned to a class declaration") is a useful tool, but, it often breaks syntax coloring and classification of functions for things like out-of-line event handlers. There seems to be no way to mark a function as "not a constructor" (would the @function JSDoc hint maybe serve this purpose?)

🔎 Search Terms

jsdoc typescript constructor ts80002

🕗 Version & Regression Information

• This behavior was introduced after 3.6.2 at some point, and I reviewed the FAQ for entries about TS80002.

⏯ Playground Link

Playground link with relevant code

💻 Code

/**
 * @this {HTMLElement}
 * @param {MouseEvent} e
 */
function test(e)
{
    this.textContent = '500';
}

document.addEventListener('click', test);

🙁 Actual behavior

TypeScript marks the function test as a constructor for a type. As a consequence, too, VSCode marks it as a type, and not a function, which is confusing for navigation purposes.

🙂 Expected behavior

TypeScript should be able to detect that with a @this hint (or @function perhaps?) that this isn't a constructor.

Reproduire le comportement dans le TypeScript Playground lié avec JavaScript et TS80002, puis étudier l’effet des indications JSDoc @this et @function sur la détection des constructeurs. Le travail est terminé lorsqu’une annotation prise en charge ou un chemin d’inférence pris en charge empêche la fonction d’être classée comme constructeur et rétablit la classification de fonction attendue pour la navigation dans l’éditeur.