JSDoc：如何记录混合了动态和固定属性的对象？

Question

假设我有一个像这样的函数：

function validator(obj){
  const ret = {};

  for (const key in obj){
    // Returns a boolean
    result = validate(key, obj[key]);

    if (result !== true)
      ret.error = true;

    ret[key] = result;
  }

  return ret;
}

这个函数将返回一个对象，对象的内容根据传递给函数的参数动态填充。

我可以像这样记录函数：

/**
 * @param {Object.<string, *>} obj
 * @returns {Object.<string, boolean>}
 */

但它没有记录.error也将返回布尔值的动态属性。

如果它会返回，我可以简单地写：

/**
 * @param {Object.<string, *>} obj
 * @returns {{error: boolean}}
 */

但是现在它没有记录动态属性。

我能想到的事情是这样的：

/**
 * @param {Object.<string, *>} obj
 * @returns {Object.<string, boolean>|{error: boolean}}
 */

虽然它有效，但在我看来它在语法上并不正确。我不能使用，@typedef因为当我已经知道将使用什么属性时应该使用它。

我在JSDoc 的文档中找不到关于这个问题的任何信息。

那么我如何记录一个混合了动态和固定属性的对象呢？

Answer 1

您可以使用模板来完成此操作

/**
 * @template {Object<string,any>} T
 * @param {T} obj
 */
function validator(obj){
    /** @type {T & {error?: Boolean}} */
    const ret = {};
  
    for (const key in obj){
      // Returns a boolean
      const result = validate(key, obj[key]);
  
      if (result !== true)
        ret.error = true;
  
      ret[key] = result;
    }
  
    return ret;
  }

代码完成示例