Excel JavaScript API 要求集

项目
11/08/2023

要求集是指各组已命名的 API 成员。 Office 加载项使用清单中指定的要求集或执行运行时检查，以确定 Office 应用程序是否支持加载项所需的 API。有关详细信息，请参阅 Office 版本和要求集。

要求集可用性

Excel 加载项可在多个 Office 版本中运行，包括 Windows 版 Office 2016 或更高版本、Office 网页版、Mac 版 Office 和 iPad 版 Office。下表列出了 Excel 要求集、支持的 Office 客户端应用程序，以及这些应用程序（如果适用） 的最低 内部版本或版本。

注意

若要在任何带编号的要求集或 ExcelApiOnline 中使用 API，应引用 Office.js 内容分发网络（CDN）上的生产库。

有关使用预览 API 的信息，请参阅 Excel JavaScript 预览 API 一文。

要求集	Windows 版 Office - Microsoft 365 订阅 - 零售永久 Office 2016 及更高版本	Windows 版 Office (批量许可的永久)	Mac 版 Office	iPad 版 Office	Office 网页版
预览	请使用最新的 Office 版本尝试预览版 API， (可能需要加入 Microsoft 365 预览体验计划) 。
ExcelApiOnline	不适用	不适用	不适用	不适用	最新（请参阅要求集页面）
ExcelApi 1.17	版本 2302 (内部版本 16130.20332)	不可用	16.70	16.70	支持
ExcelApi 1.16	版本 2208 (内部版本 15601.20148)	不可用	16.64	16.66	支持
ExcelApi 1.15	版本 2202 (内部版本 14931.20132)	不可用	16.58	16.59	支持
ExcelApi 1.14	版本 2108（内部版本 14326.20508）	Office 2021：版本 2108 (内部版本 14326.20508)	16.52	16.53	支持
ExcelApi 1.13	版本 2102（内部版本 13801.20738）	Office 2021：版本 2102 (内部版本 13801.20738)	16.50	16.50	支持
ExcelApi 1.12	版本 2008（内部版本 13127.20408）	Office 2021：版本 2008 (内部版本 13127.20408)	16.40	16.40	支持
ExcelApi 1.11	版本 2002 (内部版本 12527.20470)	Office 2021：版本 2002 (内部版本 12527.20470)	16.33	16.35	支持
ExcelApi 1.10	版本 1907 (内部版本 11929.20306)	Office 2021：版本 1907 (内部版本 11929.20306)	16.30	16.0	支持
ExcelApi 1.9	版本 1903（内部版本 11425.20204）	Office 2021：版本 1903 (内部版本 11425.20204)	16.24	16.0	支持
ExcelApi 1.8	版本 1808（内部版本 10730.20102）	Office 2021：版本 1808 (内部版本 10730.20102)	16.17	16.0	支持
ExcelApi 1.7	版本 1801（内部版本 9001.2171）	Office 2019：版本 1801 (内部版本 9001.2171)	16.9	16.0	支持
ExcelApi 1.6	版本 1704 (内部版本 8201.2001)	Office 2019：版本 1704 (内部版本 8201.2001)	15.36	15.0	支持
ExcelApi 1.5	版本 1703 (内部版本 8067.2070)	Office 2019：版本 1703 (内部版本 8067.2070)	15.36	15.0	支持
ExcelApi 1.4	版本 1701 (内部版本 7870.2024)	Office 2019：版本 1701 (内部版本 7870.2024)	15.36	15.0	支持
ExcelApi 1.3	版本 1608 (内部版本 7369.2055)	Office 2019：版本 1608 (内部版本 7369.2055)	15.27	15.0	支持
ExcelApi 1.2	版本 1601 (内部版本 6741.2088)	Office 2019：版本 1601 (内部版本 6741.2088)	15.22	15.0	支持
ExcelApi 1.1	版本 1509 (内部版本 4266.1001)	Office 2016：版本 1509 (内部版本 4266.1001)	15.20	15.0	支持

Office 版本和内部版本号

有关 Office 版本和内部版本号的详细信息，请参阅：

如何在运行时和清单中使用 Excel 要求集

注意

本节假定你熟悉 Office 版本和要求集和指定 Office 应用程序和 API 要求集处的要求集概述。

要求集是指各组已命名的 API 成员。 Office 加载项可以执行运行时检查或使用清单中指定的要求集确定 Office 应用程序是否支持加载项所需的 API。

在运行时检查要求集支持

以下代码示例显示如何确定运行加载项的 Office 应用程序是否支持指定的 API 要求集。

if (Office.context.requirements.isSetSupported('ExcelApi', '1.3')) {
  // Perform actions.
}
else {
  // Provide alternate flow/logic.
}

在清单中定义要求集支持

可以在加载项清单中使用要求元素指定加载项要求激活的最小要求集和/或 API 方法。如果 Office 应用程序或平台不支持清单的 Requirements 元素中指定的要求集或 API 方法，则加载项将不会在该应用程序或平台中运行，也不会出现在“我的加载项”中显示的加载项列表中。如果你的加载项需要特定要求集以实现完整功能，但是即使在不支持该要求集的平台上也可以为用户提供值，则建议在运行时按照上述方式检查要求支持，而不是在清单中定义要求集支持。

以下代码示例显示加载项清单中的 Requirements 元素，该元素指定应在支持 ExcelApi 要求集版本 1.3 或更高版本的所有 Office 客户端应用程序中加载该加载项。

<Requirements>
   <Sets DefaultMinVersion="1.3">
      <Set Name="ExcelApi" MinVersion="1.3"/>
   </Sets>
</Requirements>