Google Apps Script移除列过滤规则报错:含被过滤行范围不支持该操作

报错根因 #

Google Sheets API存在原生限制：当筛选器当前已经隐藏了范围内的部分行时，不允许直接调用removeColumnFilterCriteria()修改或删除单列过滤规则，也不允许用空规则直接覆盖原有规则，就会触发你遇到的报错。

可行解决方案 #

方案1：先显示所有隐藏行再清除规则（保留筛选器框架，仅清除列规则） #

先调用showRows()把筛选范围内所有被隐藏的行恢复显示，再执行清除规则的操作即可，修改后的代码如下：

function _clearFilters() {
  const filter = mailTab.getFilter();
  // 不存在筛选器直接返回，避免报错
  if (!filter) return;
  // 先恢复筛选范围内所有行的显示
  filter.getRange().showRows();
  // 再逐列清除过滤规则
  for (let col = 1; col < 8; col++) {
    Logger.log("col " + col);
    filter.removeColumnFilterCriteria(col);
  }
}

对应单列清除的_clearDatesFilter修改版本：

function _clearDatesFilter(){
  const filter = mailTab.getFilter();
  if (!filter) return;
  filter.getRange().showRows();
  const criteria = SpreadsheetApp.newFilterCriteria().build();  
  filter.setColumnFilterCriteria(6, criteria);
}

方案2：直接删除整个筛选器（适合不需要保留筛选框架的场景） #

如果不需要保留当前的筛选器配置，直接删除整个筛选器是最简便的方式：

function _clearFilters() {
  const filter = mailTab.getFilter();
  if (filter) {
    filter.remove();
  }
  // 后续如果需要重新启用筛选，调用对应范围的createFilter()即可
  // 示例：mailTab.getRange('G7:XX').createFilter();
}

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