如何在JetBrains IDE中为闭包指定“this”值的类型？

Question

JetBrains has an old blog post about JSDoc annotations that explains how to inform the IDE of variable types http://blog.jetbrains.com/webide/2012/10/validating-javascript-code-with-jsdoc-types-annotations/ .

I still, however, cannot seem to find a way to tell the IDE that the "this" value in many jQuery callbacks are HTMLElements. For example:

/**
 * Enable input
 * @returns {SomeConstructor}
 */
SomeConstructor.prototype.enableInput = function(){
    this.$markup.find('input').each(function(){
        this.disabled = false;
    });
    return this;
};

The above example will still produce a warning in the IDE - "Potentially invalid usage of this".

How can I specify that "this" refers to a HTMLElement object?

EDIT:

After looking through the JSDoc documentation I found the @this annotation http://usejsdoc.org/tags-this.html . @this will allow you to specify a "this" value for an entire function, but in the posted example the IDE will think it's returning an HTMLElement rather than a SomeConstructor.

Answer 1

@de1mar in the comments nailed it. The trick is to place /**@this {HTMLElement} just before the closure. So, for example:

/**
 * Enable input
 * @returns {SomeConstructor}
 */
SomeConstructor.prototype.enableInput = function(){
    this.$markup.find('input').each(/**@this {HTMLElement}*/function(){
        this.disabled = false;
    });
    return this;
};

Or,

SomeConstructor.prototype.listenForCheck = function(){
    this.$markup.find('input[type=checkbox]').on('click', /**@this {HTMLInputElement}*/ function(){
        //Do something
    });
};

Should be useful for anyone out there writing jQuery in a jetbrains IDE. Thanks @del1mar!