Dokumentuj ogólne parametry typu w JSDOC
WJSDoc istnieje możliwość udokumentowania dokładnych typów zawartości tablicylubię to:
/** @param {Array.<MyClass>} myClasses An array of MyClass objects. */
TestClass.protoype.someMethod = function( myClasses ){
myClasses[0].aMethodOnMyClass();
}
To sprawia, że uzupełnianie kodu w IDE, takich jak WebStorm, faktycznie dostarcza właściwych informacji o typie po[0].
. Działa to dobrze dla typu Array, jednak mam własne typy kolekcji, w których chciałbym również skorzystać z tej funkcji. Problem polega na tym, że nie mogę znaleźć właściwej składni (może dlatego, że jeszcze jej nie ma). Chciałbym być w stanie zadeklarować moją klasę w ten sposób:
/**
* @typeparam {T} the type parameter
* @constructor {Test2.<T>}
* */
Test2 = function(){};
/**
* @returns {T} a value of type T, where T is the generic type parameter of Test2
*/
Test2.prototype.getGenericValue = function(){}
Ta składnia lub funkcja nie działa z moim IDE i nie jest wymienionatutaj, więc zastanawiam się, czy istnieje składnia dla tego przypadku użycia, zarówno dla WebStorm, jak i dla innego narzędzia do tworzenia JS.