JSdoc生成器

jsdoc.js

function generateJSDoc(obj, prefix = '') {
  const jsdocComment = (name, type) => {
    return ` * @property {${type}} ${name}`;
  };
  const walkObj = (childObj, childPrefix) => {
    let jsdocStr = '';
    
    for (let key in childObj) {
      if (!Object.prototype.hasOwnProperty.call(childObj, key)) {
        continue;
      }
      const val = childObj[key];
      const propName = childPrefix + key;

      if (val === null || val === undefined) {
        jsdocStr += jsdocComment(propName, 'any') + '\n';
      } else if (typeof val === 'object') {
        if (Array.isArray(val)) {
          jsdocStr += jsdocComment(propName, 'any[]') + '\n';
        } else {
          jsdocStr += walkObj(val, propName + '.');
        }
      } else {
        jsdocStr += jsdocComment(propName, typeof val) + '\n';
      }
    }
    
    return jsdocStr;
  };
  const topLevelComment = `/**\n${walkObj(obj, prefix)}*/`;
  return topLevelComment;
}