如何遍历 v8 中全局对象（库）的所有属性/函数？

Question

Google 应用程序脚本提供了一个library feature，如果您在其中包含项目密钥，则会添加一个库作为全局对象。我正在寻找迭代添加库的所有功能。这在带有for...in 循环的rhino 引擎中曾经是可能的。但我无法遍历 v8 引擎中库的任何属性。

documentation 说

在 V8 运行时中，项目及其库在不同的执行上下文中运行，因此具有不同的全局和原型链。

谁能解释这个对象是如何创建的或如何访问它的所有属性？

项目A：

function testLib(prop = 'main') {
  const isEnumerable = MyLibrary.propertyIsEnumerable(prop);
  const isOwnProperty = MyLibrary.hasOwnProperty(prop);
  console.info({ isEnumerable, isOwnProperty }); // { isEnumerable: false, isOwnProperty: true }
  console.info(prop in MyLibrary);//true
  for (const property in MyLibrary) {
    //loop doesn't start
    console.info(property);
  }
  console.info(Object.getOwnPropertyDescriptor(MyLibrary, prop)); //logs expected  data:
  /*{ value: [Function: main],
  writable: true,
  enumerable: false,
  configurable: true }*/
  console.log(Object.getOwnPropertyDescriptors(MyLibrary)); //actual: {} Expected: array of all functions including `main`
  MyLibrary.a = 1;
  console.log(Object.getOwnPropertyDescriptors(MyLibrary)); //actual: {a:1} Expected: array of all functions including `main`
}

function testPropDescriptors() {
  const obj = { prop1: 1, b: 2 };
  console.log(Object.getOwnPropertyDescriptors(obj)); //logs expected data
  /*{prop1: { value: 1, writable: true, enumerable: true, configurable: true },
  b: { value: 2, writable: true, enumerable: true, configurable: true } }*/
}

我的图书馆（项目 B）：

function main(){}
function onEdit(){}

为了重现，

• 通过clicking here 创建一个新项目 - 比如项目 A
• Create a another script project（比如项目 B）：
  • 在项目 B 中添加一个名为 main 的函数并
  • Deploy it 点击右上角的部署。
  • add it's key 在项目 A 中并将其命名为 MyLibrary。
• 将以上脚本复制粘贴到项目A中，选择testLib函数点击运行

Answer 1

问题和解决方法：

我一直在寻找在启用 V8 的情况下从客户端直接检索库端的属性和函数的方法。但不幸的是，我仍然找不到它。因此，就我而言，我使用了 2 种解决方法。

1. 使用 Apps Script API 和/或 Drive API 检索所有脚本。

2. 将属性和函数包装在一个对象中。

通过上述变通方法，可以从客户端检索库端的属性和函数。

解决方法 1：

在此解决方法中，库端的所有脚本都是使用 Apps Script API 和 Drive API 检索的。

示例脚本 1：

在此示例中，使用了 Apps Script API。因此，当您使用此脚本时，请将 Google Cloud Platform Project 链接到 Google Apps Script Project。 Ref 并且，请在 API 控制台启用 Apps Script API。

const projectIdOflibrary = "###"; // Please set the project ID of the library.

const url = `https://script.googleapis.com/v1/projects/${projectIdOflibrary}/content`;
const res = UrlFetchApp.fetch(url, {headers: {authorization: "Bearer " + ScriptApp.getOAuthToken()}});
const obj = JSON.parse(res.getContentText())
const functions = obj.files.reduce((ar, o) => {
  if (o.name != "appsscript") ar.push(o);
  return ar;
}, []);
console.log(functions)
// console.log(functions.map(({functionSet}) => functionSet.values)) // When you want to see the function names, you can use this line.

• 当此脚本用于您的库脚本时，console.log(functions.flatMap(({functionSet}) => functionSet.values)) 返回[ { name: 'main' }, { name: 'onEdit' } ]。

• 在这种情况下，即使库是谷歌文档的容器绑定脚本，这个脚本也可以工作。

示例脚本 2：

在此示例中，使用了 Drive API。因此，当您使用此脚本时，请在 Google 高级服务中启用 Drive API。

const projectIdOflibrary = "###"; // Please set the project ID of the library.

const url = `https://www.googleapis.com/drive/v3/files/${projectIdOflibrary}/export?mimeType=application%2Fvnd.google-apps.script%2Bjson`;
const res = UrlFetchApp.fetch(url, {headers: {authorization: "Bearer " + ScriptApp.getOAuthToken()}});
const obj = JSON.parse(res.getContentText())
const functions = obj.files.reduce((ar, o) => {
  if (o.name != "appsscript") ar.push(o.source);
  return ar;
}, []);
console.log(functions)

• 当此脚本用于您的库脚本时，console.log(functions) 返回[ 'function main(){}\nfunction onEdit(){}\n' ]。

• 在这种情况下，不会自动解析函数名称。但 Google Apps Script Project 不需要与 Google Cloud Platform Project 链接。但是，当库是 Google Docs 的容器绑定脚本时，不能使用该脚本。在这种情况下，当库仅为独立类型时，可以使用此脚本。请注意这一点。

解决方法 2：

在此解决方法中，库端的属性和函数用对象包装。

示例脚本：库端

var sample1 = {
  method1: function() {},
  method2: function() {}
};


var sample2 = class sample2 {
  constructor() {
    this.sample = "sample";
  }

  method1() {
    return this.sample;
  }
}

示例脚本：客户端

function myFunction() {
  const res1 = MyLibrary.sample1;
  console.log(res1)

  const res2 = Object.getOwnPropertyNames(MyLibrary.sample2.prototype);
  console.log(res2)
}

• 在这种情况下，console.log(res1) 和 console.log(res2) 分别返回 { method1: [Function: method1], method2: [Function: method2] } 和 [ 'constructor', 'method1' ]。

参考资料：

• Linking Google Cloud Platform Project to Google Apps Script Project for New IDE
• Method: projects.getContent
• Files: export

Answer 2

Google Apps 脚本是 V8 的自定义嵌入，因此它使用 V8 C++ API 创建“魔术”对象。最终结果类似于代理：如果您知道属性的名称，则可以检索它；但是没有内置的方法来枚举库中的可用函数。 （我不知道为什么它是这样设计的。）

如果您控制有问题的库，一种可能的解决方法是从那里导出函数列表：

// MyLibrary:
Object.defineProperty(this, "global", {value: this});
function getExports() {
  let result = [];
  let descriptors = Object.getOwnPropertyDescriptors(global);
  for (let p in descriptors) {
    if (descriptors[p].enumerable) result.push(p);
  }
  return result;
}

// main project:
console.log(MyLibrary.getExports());

（如果你不控制图书馆，@Tanaike 的回答提供了一些建议。）