如何在Node.js及JS环境中通过反射获取内置方法/属性的描述？

首先明确：原生JavaScript/Node.js的反射机制无法直接获取内置方法、函数或属性的人工编写功能描述。这类描述是MDN等文档平台的人工补充内容，并非JavaScript引擎内置的元数据，Reflect API、Object.getOwnPropertyDescriptors等原生工具只能获取方法的特性（如可枚举性、可写性），拿不到类似MDN的功能说明文本。

以下是适配多环境（Node.js、浏览器、Google Apps Script）的可行方案，且无需爬取MDN页面：

1. 预打包离线API描述数据集 #

这是最可靠的方案，提前把MDN的结构化API描述转换成本地可加载的数据集：

• 从MDN官方的结构化数据仓库导出JSON格式的文档内容，批量提取API名称和对应的功能描述，生成一个键值对结构的文件（JS模块或JSON）。
• 示例实现：

  // 预定义的API描述数据集（可批量生成）
  const apiDescriptions = {
    'Array.prototype.at': 'Takes an integer value and returns the item at that index, allowing for positive and negative integers. Negative integers count back from the last item in the array.',
    'Array.prototype.slice': 'Returns a shallow copy of a portion of an array into a new array object selected from start to end (end not included). The original array will not be modified.',
    // 其他内置API的描述...
  };
  
  // 获取描述的核心函数
  function getDescription(target) {
    const apiId = resolveApiIdentifier(target);
    return apiDescriptions[apiId] || 'No description available';
  }
  
  // 辅助函数：将目标方法映射为标准API标识符
  function resolveApiIdentifier(target) {
    // 针对不同内置方法的匹配逻辑，可根据toString输出或原型链判断
    if (target === Array.prototype.at) return 'Array.prototype.at';
    if (target === Array.prototype.slice) return 'Array.prototype.slice';
    // 更多匹配规则...
  }
  

• 优势：完全离线，适配所有JavaScript运行环境；一次生成后可长期使用。

2. 批量生成CSV文件 #

拿到上述键值对数据集后，可快速生成CSV用于Quizlet：

• Node.js环境示例：

  const fs = require('fs');
  const csvContent = Object.entries(apiDescriptions)
    .map(([apiName, desc]) => `"${desc}","${apiName}"`) // 符合Quizlet闪卡格式：题目（描述）,答案（API名称）
    .join('\n');
  fs.writeFileSync('api-flashcards.csv', csvContent);
  

• 浏览器环境：可将CSV内容生成Blob，提供下载链接。
• Google Apps Script：可直接将数据写入Google表格，再导出为CSV。

注意事项 #

• 部分旧内置方法的toString()会返回"function xxx() { [native code] }"，但没有任何功能描述，无法通过这种方式提取有效信息，因此不能依赖。
• 批量生成数据集时，建议优先使用MDN的官方结构化数据，避免手动编写大量内容，减少出错概率。

内容的提问来源于stack exchange，提问作者forgodsakehold