Auto detection

JSDuck features some great auto-detection capabilities for its built-in members. Your custom members should not be worse - they too can have various attributes automatically detected from source code.

In fact, even without any additions, the @hook tag implemented in introductory chapter already has some auto detection in it.

When we try with the following code:

/**
 * @hook
 * Runs after the component is initialized.
 */
function after(self, cfg) {
}

We get the following output:

The name of the hook has been auto-detected from the function name. That's great, but the parameters are missing. We need to enhance the built-in auto-detection to include :params field. For this we override the process_code method:

def process_code(code)
  h = super(code)
  h[:params] = code[:params]
  h
end

This method is called with a hash of data that JSDuck itself auto-detected from code. In the case of our example the code parameter will have the value:

{
  :tagname => :method,
  :name => "after",
  :params => [{:name=>"self"}, {:name=>"cfg"}],
  :fires => nil,
  :chainable => false,
  :method_calls => nil,
}

First we pass this data to the superclass method, allowing it detect the name and a few other things. Then we augment the returned data to also include the auto-detected parameters.

The result now looks like expected: