如何使用Apps Script检测Google Sheets中行是否被filter view隐藏？

现有原生方法的局限 #

Google Apps Script提供的两个行隐藏检测方法均无法覆盖筛选视图场景：

• isRowHiddenByFilter(rowPosition)：仅能检测普通全局筛选的隐藏行，官方明确标注不支持筛选视图
• isRowHiddenByUser(rowPosition)：仅能检测用户手动拖拽隐藏的行

推荐解决方案：调用Google Sheets API检测 #

该方案可以准确识别普通筛选、筛选视图导致的行隐藏，是目前最稳定的实现方式。

前置操作 #

在Apps Script项目中开启Google Sheets API服务：

1. 打开目标表格，点击「扩展」>「Apps Script」进入脚本编辑器
2. 点击左侧菜单栏「服务」旁边的+号，找到「Google Sheets API」，点击添加即可

代码实现 #

/**
 * 检测指定行是否被任意筛选（含普通筛选、筛选视图）隐藏
 * @param {string} sheetName 目标工作表名称
 * @param {number} rowNum 待检测的行号，和表格界面行号一致，从1开始计数
 * @return {boolean} 行被隐藏返回true，可见返回false
 */
function isRowHiddenByAnyFilter(sheetName, rowNum) {
  const ssId = SpreadsheetApp.getActiveSpreadsheet().getId();
  const apiResponse = Sheets.Spreadsheets.get(ssId, {
    ranges: `${sheetName}!A${rowNum}:A${rowNum}`,
    includeGridData: true
  });
  const rowMetadata = apiResponse.sheets[0].data[0].rowData[0].rowMetadata;
  return !!rowMetadata?.hiddenByFilter;
}

使用示例 #

检测「库存表」第12行是否被筛选隐藏：

const checkResult = isRowHiddenByAnyFilter("库存表", 12);
console.log(checkResult); // true=已隐藏 false=可见

备选轻量方案（无需开启API） #

如果仅需少量临时检测，不想开启API，可以用临时替换筛选的方式实现：

1. 记录当前激活的筛选视图ID
2. 将筛选视图的条件应用为全局普通筛选
3. 调用isRowHiddenByFilter()检测行状态
4. 重新激活原有筛选视图，删除临时创建的普通筛选

注意：该方案会临时修改表格界面的筛选状态，不建议在面向普通用户的脚本中使用。

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