如何通过Office-JS判断用户当前Excel版本是否支持指定公式？

可以通过两种方式实现你的需求：

方法1：尝试写入公式并捕获错误（推荐） #

Office-JS没有直接提供公式支持性检查的API，但可以通过尝试写入目标公式，根据是否抛出错误来判断版本是否支持。这种方法更可靠，能覆盖所有版本场景（包括预览版、特殊渠道版本）。

示例代码：

async function insertImageOrLink(imageUrl, rangeAddress = "A1") {
  try {
    await Excel.run(async (context) => {
      const range = context.workbook.worksheets.getActiveWorksheet().getRange(rangeAddress);
      // 尝试写入IMAGE公式
      range.formula = `=IMAGE("${imageUrl}")`;
      await context.sync();
      console.log("已插入IMAGE公式");
    });
  } catch (error) {
    // 写入失败，说明不支持IMAGE公式，插入超链接
    await Excel.run(async (context) => {
      const range = context.workbook.worksheets.getActiveWorksheet().getRange(rangeAddress);
      range.hyperlink = {
        address: imageUrl,
        textToDisplay: imageUrl
      };
      await context.sync();
      console.log("已插入超链接");
    });
  }
}

方法2：通过版本号判断 #

IMAGE公式仅支持以下Excel版本：

• Excel 365（订阅版，所有更新通道）
• Excel 2021 及以后的桌面永久版

可以通过context.application.version获取版本号，再进行判断：

• Excel 365的版本号通常以20或更高开头（比如2308、2401）
• Excel 2021的版本号为16.0.14326及以上

示例代码：

async function insertImageOrLinkByVersion(imageUrl, rangeAddress = "A1") {
  await Excel.run(async (context) => {
    const appVersion = context.application.version;
    context.load(appVersion);
    await context.sync();
    
    const versionParts = appVersion.split(".");
    let supportsImage = false;
    
    // 判断版本是否符合要求
    if (parseInt(versionParts[0]) >= 20) {
      // Excel 365 版本
      supportsImage = true;
    } else if (parseInt(versionParts[0]) === 16) {
      // Excel 2021+ 桌面版
      if (parseInt(versionParts[2]) >= 14326) {
        supportsImage = true;
      }
    }
    
    const range = context.workbook.worksheets.getActiveWorksheet().getRange(rangeAddress);
    if (supportsImage) {
      range.formula = `=IMAGE("${imageUrl}")`;
    } else {
      range.hyperlink = {
        address: imageUrl,
        textToDisplay: imageUrl
      };
    }
    await context.sync();
  });
}

注意事项 #

• 版本号判断可能存在例外（比如部分旧版365未更新到支持IMAGE的版本），因此方法1的错误捕获方式更推荐。
• 如果需要处理批量单元格，可以循环遍历目标范围，重复上述逻辑。

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