返回具有特定 属性 和类型的对象

Question

我有一个函数 operation，它接受两个参数 str（一个字符串）和 fn（一个函数）。

function operation(str, fn){
  var temp = {}
  temp[str] = fn
  return temp
}

• 你如何描述这个 return 值？
• 这个 return 值在 JSDoc 中是什么样子的？
• 示例输出格式是什么？

@return 描述可以接受吗？

@returns {Object} With one key set to str and one value set to fn.

@example 输出可以接受吗？

operation("foo", console.log)
// => {"foo": [Function]}

我问的主要原因是因为我想使用这种格式来测试像 yamadapc/jsdoctest.

这样的套件中的功能

Answer 1

在我看来，你应该使用这两个them.For例子，在underscore js中，doc被描述为fellow：