Блог

Мне нравится размещать свои статические методы в верхней части моих классов, за которыми следуют ctor и методы.

Но номер строки JSDoc для конструктора класса указывает на начало класса, а не на функцию конструктора. Даже использование @constructor не помогает.

Есть ли способ заставить JSDoc указывать на ctor, а не на объявление класса?

Пример: исходный файл

 import util from './util.js'

/**
 * Subclass of Array with convenience methods used by NetLogo.
 * Typically the items in the array are Objects but can be any type.
 */
class AgentArray extends Array {
  /**
   * Convert an existing Array to an AgentArray "in place".
   * Use array.slice() if a new array is wanted
   *
   * @static
   * @param {Array} array Array to convert to AgentArray
   * @return {AgentArray} array converted to AgentArray
   */
  static fromArray(array) {
      const aarray = Object.setPrototypeOf(array, AgentArray.prototype)
      return aarray
  }

  /**
   * Creates an instance of AgentArray. Simply pass-through to super()
   * now, but may add initialization code later.
   * @param {*} args Zero or more items in Array
   * @example
   * let aa = new AgentArray({x:0,y:0}, {x:0,y:1}, {x:1,y:0})
   *  //=>  [{ x: 0, y: 0 }, { x: 0, y: 1 }, { x: 1, y: 0 }]
   */
  constructor(...args) {
      super(...args)
      // maybe do some initialization later
  }

}
  

HTML-файл JSDoc:

Обратите внимание, что ctor находится в строке 7 .. что: