Jak mogę poinformować JSDoc o strukturze zwracanego obiektu. Znalazłem @return {{field1: type, field2: type, ...}} description
składnię i wypróbowałem ją:
/**
* Returns a coordinate from a given mouse or touch event
* @param {TouchEvent|MouseEvent|jQuery.Event} e
* A valid mouse or touch event or a jQuery event wrapping such an
* event.
* @param {string} [type="page"]
* A string representing the type of location that should be
* returned. Can be either "page", "client" or "screen".
* @return {{x: Number, y: Number}}
* The location of the event
*/
var getEventLocation = function(e, type) {
...
return {x: xLocation, y: yLocation};
}
Chociaż ta analiza przebiega pomyślnie, wynikowa dokumentacja po prostu stwierdza:
Returns:
The location of an event
Type: Object
Rozwijam API i potrzebuję, aby ludzie wiedzieli o obiekcie, który otrzymają. Czy to możliwe w JSDoc? Używam JSDoc3.3.0-beta1.
@typedef
jest to obejście / rozwiązanie, ale wydaje się dziwne, że nie działa to z obiektami dosłownymi. Jeśli ktoś się na to natknie w przyszłości (tak jak ja), dodałem problem github.com/jsdoc/jsdoc/issues/1678, który może zawierać więcej informacji niż ta strona.Odpowiedzi:
Zdefiniuj swoją strukturę oddzielnie, używając @typdef :
I użyj go jako typu zwracanego:
źródło
@return
instrukcji rzeczywiście działa, ale są one wyświetlane w danych wyjściowych tak, jakby były kilkoma zwrotami (jeden stan wypunktowania,point - Object
a następnie dwa inne wypunktowanie dlapoint.x - Number
ipoint.y - Number
). Chociaż mogę z tym żyć, przypuszczam, że nie ma sposobu na uzyskanie skondensowanego wyniku zwróconego obiektu? Czy przynajmniej mają wpisy dlapoint.x
ipoint.y
wcięcia?@typedef
podejście jest najbardziej jasne pod względem wyników dokumentacji, dzięki!@inner
lub definicja typu będzie miałaglobal
zakres w dokumentacji. +1@typedef {Object} Point
. W rzeczywistości, użycie tego dwuwierszowego formularza podświetlaPoint
w PhpStorm komunikat „Nierozwiązana zmienna lub wpisz Punkt”. W@typedef
docs wspierać to, ale nie chcę, aby edytować tę odpowiedź, czy jest to prawidłowy wariant.Alternatywnie do już opublikowanych sugestii możesz użyć tego formatu:
co da następującą dokumentację wyjściową:
źródło
Czystym rozwiązaniem jest napisanie klasy i zwrócenie jej.
źródło
Point
nie jest konstruktorem, aby zmienić tę funkcję , aby zastąpićPoint
this.x = x; this.y = y;
new
składnia polega na utworzeniu instancji z plikuconstructor
. Beznew
kontekstuthis
byłby kontekst globalny. Możesz spróbować utworzyć instancję beznew
zobaczenia efektu.