WebStorm의 콜백 함수에서 'this'인스턴스를 어떻게 문서화 할 수 있습니까?

Question

이 코드를 갖는

function Element() { 
    this.name = "yay"; 
} 
Element.prototype.extend = function(object) { 
    if (object instanceof Object) { 
     for (var n in object) { 
      if (object.hasOwnProperty(n)) { 
       this[n] = object[n]; 
      } 
     } 
    } 
}; 

var el = new Element(); 
el.extend({ 
    update: function() { 
     console.log(this.name); 
    } 
}); 

내가 WebStorm는 update()this이 Element의 인스턴스 알고 싶어요,하지만 난 정말 어떻게 해야할지 모르겠다.

내가 도달 한 최대

은 이것이다 :

el.extend({ 
    /** 
     * @this Element 
     */ 
    update: function() { 
     console.log(this.name); 
    } 
}); 

그러나 나는 모든 extend()에서 그렇게하고 싶지 않아.

는 또한이 발견

/** 
* @typedef {Object} FunctionExtend 
*/ 
/** 
* @param {FunctionExtend} object 
*/ 
Element.prototype.extend = function(object) { 
    [...] 

을하지만 난에 붙어 :

• 어떻게 매개 변수의 정의되지 않은 수를 가지고 FunctionExtend를 선언 할 수 있습니다.
• 각 @parameter이 매개 변수 이름을 모른 채 콜백이 될 것이라고 알려주는 방법.
• @this 콜백이 무엇인지 알려주는 방법.

Answer 1

프로토 타입을 일반적으로 확장하면 나쁜 생각인데, JSDoc과 같은 쓰기 시간 문서화 도구로는 잘 돌아 가지 않습니다.

모든 기능을 개별적으로 문서화 할 수밖에 없습니다.