检查 JavaScript 方法或 属性 是否在 Excel 版本中受支持

Check if a JavaScript method or property is supported in an Excel version

我在 Mac 中编写 JavaScript 加载项,所以我不经常使用 Visual Studio(但我可以启动 Windows 和 运行 Visual Studio 如果确实需要的话)。 我很困惑如何检查 JavaScript 方法或 属性 是否在 Excel 版本中受支持, 基于网络上的引用

Document.addHandlerAsync method for example, according the page, it has been added in 1.1, does this 1.1 mean ExcelApi 1.1? But according to this page,属于Common API requirement sets,可在Excel2013年使用?

当我检查Visual Studio时,它没有给出版本信息:

有几个相关页面:Office Add-in host and platform availability, Office common API requirement sets, Excel JavaScript API requirement sets,仅其中 none 就足以回答某个 Excel 版本是否支持 method/property。

此外,Excel JavaScript API 1.1中有什么?

大体上,Office JS API有两种风格。

  1. "shared"APIs 不是特定于主机的,它们中的大多数都可以跨 Excel、Word、PowerPoint 等工作(不是全部,因此需要方法和功能特定要求集,例如 MatrixCoercionTextBindings)。如果您正在创作需要 运行 cross-host 并且主要针对 Office-2013 的 add-ins,那么此集 API 将会有所帮助。另一个区别是这些 API 的风格 - 它们具有基于 call-back 的语法,而不是稍后引入的基于承诺的执行。在 API 规格页面中,这些 API 可在 dev.office.com 网站的 "SHARED API" 部分下找到。他们的条目标题为 "Added in 1.1"。这里的1.1指的是CDN版本,不要和Excel1.1等需求集混淆。

  2. 更现代和特定于主机的 API 基于承诺的。这些 API 分组在 requirement-sets 下,例如 Excel1.1、Excel1.2、Word1.3 等。这些 API 是随 Office-2016 和我们正在根据较新的要求集逐步添加新的 API。您可以使用 table(标题为 "Req-set." 的列)在 API 规范中找到确切的要求编号。它链接到 "Excel JavaScript API requirement sets" 页面,其中列出了较新版本中添加的功能。第一个版本是在 Excel1.1 下发布的,它有 100 多个 API,因此在 "Excel JavaScript API requirement sets" 页面中没有单独的 table for 1.1。

"shared API" 文档确实需要一些修复。我们很快就会着手解决这个问题。使需求集名称成为智能的一部分也是我们讨论过的一个好主意。可能需要更长的时间才能将其作为 d.ts 或 VSDOCS 的一部分提供。