Question

function foo(a, opt_b) {
  opt_b = opt_b || 1;
  ...
}

foo(1);  // IntelliJ will yell at me, saying "Invalid number of parameters, expected 2"

Is there a way to document foo() such that IntelliJ won’t yell at me?

Answer 1

Using JavaDoc-style comments for JavaScript, you can declare a parameter as optional with brackets [] around it:

/**
 * My function
 * @param [optionalParam] An optional parameter
 */
myFunction: function(optionalParam) {
    //...
},