将命名参数传递给Javascript函数[重复]

Question

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

someFunction(1, true, 'foo');

不熟悉功能就不是很清楚。

我已经看到并使用了插入 cmets 的样式来命名参数：

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

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

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

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

Answer 1

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

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