如何在Excel JavaScript API中高效遍历所有工作表？

我需要遍历工作簿中的所有工作表并对每个工作表执行操作（例如调用calculate()方法）。出于性能考量，我希望所有操作都在一个sync()请求中完成。但问题在于，在执行sync()之前，我只能通过有限的方式获取工作表，比如通过active worksheet（活动工作表）或按worksheet name（工作表名称）获取，这使得遍历操作难以实现。我目前想到的最佳方法是使用getFirst()和getNext()编写循环，代码如下：

Excel.run(function(ctx) { 
  var sheets = ctx.workbook.worksheets; 
  var sheetCount = sheets.getCount(); 
  var currentSheet = sheets.getFirst(); 
  currentSheet.calculate() 
  if (sheetCount > 1) { 
    for (var i = 2; i <= sheetCount; i++) { 
      currentSheet = currentSheet.getNext(); 
      currentSheet.calculate(); 
    } 
  } 
  return ctx.sync(); 
}); 

但这个循环写法十分繁琐，我认为一定有更优的实现方式，请问是否存在更好的方法？

你说得对，用getFirst()+getNext()的循环确实有点啰嗦，其实Excel.js提供了更简洁的方式来批量处理所有工作表，同时保持单个sync()请求的性能优势。

核心思路是先加载工作表集合的items属性，这样你就能直接遍历整个工作表数组，而不需要手动逐个获取下一个工作表。具体写法如下：

Excel.run(function(ctx) {
  // 获取工作表集合并加载items属性
  const sheets = ctx.workbook.worksheets.load('items');
  
  // 等待sync获取所有工作表的引用（Excel.run会合并请求，最终仅一次网络调用）
  return ctx.sync().then(function() {
    // 遍历所有工作表并执行calculate操作
    sheets.items.forEach(function(sheet) {
      sheet.calculate();
    });
    
    // 执行所有操作并同步到Excel
    return ctx.sync();
  });
}).catch(function(error) {
  console.error(error);
  if (error instanceof OfficeExtension.Error) {
    console.error('Debug info:', error.debugInfo);
  }
});

为什么这个方法更优？ #

• 代码更简洁直观：用forEach遍历数组比手动维护getNext()循环要易读得多，逻辑一目了然。
• 扩展性更强：如果后续需要添加筛选条件（比如跳过隐藏工作表），直接在forEach里追加判断即可，无需修改循环结构。
• 性能不受影响：整个流程依然只触发一次实际的网络请求（Excel.run会自动合并多个ctx.sync()调用为一个批量请求），完全满足你的性能要求。

如果你习惯使用现代JavaScript语法，还可以用async/await来替代then链，让代码更清爽：

await Excel.run(async (ctx) => {
  const sheets = ctx.workbook.worksheets.load('items');
  await ctx.sync();
  
  sheets.items.forEach(sheet => {
    sheet.calculate();
  });
  
  await ctx.sync();
});

这种写法利用ES6的异步语法，让异步代码看起来像同步代码，可读性进一步提升。

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