Method resolveThis

lib/jsdoc/src/parser.js:499–563

* Resolve what "this" refers to relative to a node. * @param {node} node - The "this" node * @returns {string} The longname of the enclosing node.

(node)

     * @returns {string} The longname of the enclosing node.
     */
    resolveThis(node) {
        let doclet;
        let parentClass;
        let result;

        // Properties are handled below.
        if (node.type !== Syntax.Property && node.enclosingScope) {
            // For ES2015 constructor functions, we use the class declaration to resolve `this`.
            if (node.parent && node.parent.type === Syntax.MethodDefinition &&
                node.parent.kind === 'constructor') {
                doclet = this._getDocletById(node.parent.parent.parent.nodeId);
            }
            // Otherwise, if there's an enclosing scope, we use the enclosing scope to resolve `this`.
            else {
                doclet = this._getDocletById(node.enclosingScope.nodeId);
            }

            if (!doclet) {
                result = jsdoc.name.LONGNAMES.ANONYMOUS; // TODO handle global this?
            }
            else if (doclet.this) {
                result = doclet.this;
            }
            else if (doclet.kind === 'function' && doclet.memberof) {
                parentClass = this._getParentClass(node);

                // like: function Foo() { this.bar = function(n) { /** blah */ this.name = n; };
                // or:   Foo.prototype.bar = function(n) { /** blah */ this.name = n; };
                // or:   var Foo = exports.Foo = function(n) { /** blah */ this.name = n; };
                // or:   Foo.constructor = function(n) { /** blah */ this.name = n; }
                if ( parentClass || /\.constructor$/.test(doclet.longname) ) {
                    result = doclet.memberof;
                }
                // like: function notAClass(n) { /** global this */ this.name = n; }
                else {
                    result = doclet.longname;
                }
            }
            // like: var foo = function(n) { /** blah */ this.bar = n; }
            else if ( doclet.kind === 'member' && jsdoc.src.astnode.isAssignment(node) ) {
                result = doclet.longname;
            }
            // walk up to the closest class we can find
            else if (doclet.kind === 'class' || doclet.kind === 'interface' || doclet.kind === 'module') {
                result = doclet.longname;
            }
            else if (node.enclosingScope) {
                result = this.resolveThis(node.enclosingScope);
            }
        }
        // For object properties, we use the node's parent (the object) instead.
        else {
            doclet = this._getDocletById(node.parent.nodeId);

            if (!doclet) {
                // The object wasn't documented, so we don't know what name to use.
                result = '';
            }