如何在OfficeScript中获取Excel在线工作簿的可见工作表？

原代码存在的问题 #

• getNext({visibleOnly: true})用法错误：这个方法是Excel集合的迭代器方法，并非用于筛选可见工作表，不能直接用来获取可见工作表数组。
• 循环内对象调用错误：forEach遍历的是单个工作表对象，但代码里错误地使用了数组visibleSheets来调用getName()、getAutoFilter()等方法，会导致运行报错。

修正后的代码 #

function main(workbook: ExcelScript.Workbook) {
    // 获取所有工作表，筛选出仅可见的工作表
    let visibleSheets: ExcelScript.Worksheet[] = workbook.getWorksheets().filter(sheet => {
        return sheet.getVisibility() === ExcelScript.SheetVisibility.visible;
    });

    // 遍历每个可见工作表
    visibleSheets.forEach(sheet => {
        // 排除名为"SUMMARY"的工作表
        if (sheet.getName() !== "SUMMARY") {
            console.log(sheet.getName());
            // 对A1单元格所在区域应用自动筛选
            const autoFilter = sheet.getAutoFilter();
            const targetRange = sheet.getRange("A1");
            autoFilter.apply(targetRange);
            // 在第1列（索引0）应用自定义筛选：排除空值
            autoFilter.apply(autoFilter.getRange(), 0, {
                filterOn: ExcelScript.FilterOn.custom,
                criterion1: "<>"
            });
        }
    });
}

关键说明 #

• 用数组的filter()方法结合sheet.getVisibility()判断，精准筛选出可见工作表，这是Excel Script中获取可见工作表的标准方式。
• 循环内始终使用当前迭代的sheet对象调用方法，避免数组与单个对象混淆导致的错误。
• 增加变量存储autoFilter和targetRange，提升代码可读性和执行效率。

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