使用类似以下内容调用Javascript函数
someFunction(1, true, 'foo');
不熟悉功能就不是很清楚。
我已经看到并使用了插入注释来命名参数的样式:
someFunction(/*itemsToAdd*/1, /*displayLabel*/ true, /*labelText*/ 'foo');
但是当它超过3个或更多参数时,在JSON对象中传递参数似乎更好,这使它与顺序无关,并允许在被调用的函数中提供默认值
someFunction({'itemsToAdd':1, 'labelText':'foo', 'displayLabel':true});
我的问题是;行业的一般做法是什么,是否有压倒一切的理由不使用这些方法。例如,Lint就不喜欢第二种方法。
就我个人而言,我只需要grep函数名并查看与之相关联的注释。维护良好的代码在函数上方会有一个注释,解释参数是什么以及它对它们的作用,如果需要解释参数为何如此,您可以将注释粘贴在函数调用上方。
使用JSON传递参数似乎会增加不必要的解析开销,并可能使维护人员感到困惑--只需添加更多字段,并将空值传递给需要默认值的字段,您可以解释为什么在调用注释中传递空值,而不只是让它们不出现在JSON中。