archive-gh-me/jsdoc
1
0
Fork 0
mirror of https://github.com/jsdoc/jsdoc.git synced 2025-12-08 19:46:11 +00:00
Code Issues Projects Releases Wiki Activity

added @listens tag (need to add to template too)

Browse Source
This commit is contained in:
mathematicalcoffee 2013-02-15 16:27:02 +10:00
parent 21dbd5804f
commit 5ffaaff619
2 changed files with 20 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
lib/jsdoc/tag/dictionary/definitions.js
View File

@ -404,6 +404,15 @@ exports.defineTags = function(dictionary) {
doclet.license = tag.value;
}
});
dictionary.defineTag('listens', {
mustHaveValue: true,
onTagged: function (doclet, tag) {
if (!doclet.listens) { doclet.listens = []; }
doclet.listens.push(tag.value);
// TODO: verify that parameters match the event parameters?
}
});
dictionary.defineTag('member', {
canHaveType: true,

11
test/specs/tags/listenstag.js Normal file
View File

@ -0,0 +1,11 @@
describe("@listens tag", function() {
var doclet = require('jsdoc/doclet'),
doc = new doclet.Doclet('/** An event handler\n@function handler\n@listens Foo\n@listens Bar */', {});
it("should create a 'listens' property on the doclet, an array, with the events that are listened to", function() {
expect(Array.isArray(doc.listens)).toBeTruthy();
expect(doc.listens.length).toBe(2);
expect(doc.listens).toContain('Foo');
expect(doc.listens).toContain('Bar');
});
});