3

使用类似的方法调用 Javascript 函数

someFunction(1, true, 'foo');

不熟悉功能不是很清楚。

我已经看到并使用了插入注释来命名参数的样式:

someFunction(/*itemsToAdd*/1, /*displayLabel*/ true, /*labelText*/ 'foo');

但是当它超过 3 个或更多参数时,最好在 JSON 对象中传递参数,这使得它与顺序无关,并允许在被调用的函数中提供默认值

someFunction({'itemsToAdd':1, 'labelText':'foo', 'displayLabel':true});

我的问题是;行业的一般做法是什么,是否有不使用这些方法的首要原因。例如,Lint 不喜欢第二种方法。

4

1 回答 1

0

就我个人而言,我只是 grep 函数名称并查看与之相关的注释。维护良好的代码将在函数上方有一个注释,解释参数是什么以及它对它们的作用,如果你需要解释为什么你的参数是这样的,你可以将它粘贴到函数调用上方。

使用 JSON 传递参数似乎是一种增加不必要的解析开销并可能使维护者感到困惑的方法 - 只需添加更多字段并将 NULL 传递给您想要默认值的字段,您可以解释为什么要传递 NULL在调用注释中,而不是仅仅让它们不出现在 JSON 中。

于 2013-07-11T10:03:42.743 回答