Apps Script中getCriteriaValues()获取默认复选框值返回空数组的问题

这不是Bug，是Google Sheets默认复选框的设计特性：

• 通过Insert>Tick Box插入的默认复选框，使用系统内置的布尔值对（勾选为true，未勾选为false），这类复选框没有显式设置自定义条件值，因此调用getCriteriaValues()会返回空数组。
• 当手动设置自定义复选框值（比如["yes","no"]）时，这些值会被存储为规则的条件值，此时getCriteriaValues()就能正常返回对应数组。

获取默认复选框值的处理方法 #

默认复选框的取值是固定的true/false，可以结合规则类型和条件值数组长度来判断处理：

1. 用getCriteriaType()确认规则类型为CHECKBOX
2. 若getCriteriaValues()返回空数组，直接认定为默认复选框，取值为true（勾选）和false（未勾选）
3. 若返回非空数组，则用数组内的值作为勾选/未勾选对应的值

修改后的测试脚本示例：

function testTickboxes() {
  var cell = SpreadsheetApp.getActive().getRange('A1');
  var rule = cell.getDataValidation();
  if (rule != null) {
    var criteria = rule.getCriteriaType();
    var args = rule.getCriteriaValues();
    Logger.log('数据验证规则：%s %s', criteria, args);
    
    // 处理复选框值逻辑
    var checkedValue, uncheckedValue;
    if (criteria === SpreadsheetApp.DataValidationCriteria.CHECKBOX) {
      if (args.length === 0) {
        // 默认复选框
        checkedValue = true;
        uncheckedValue = false;
        Logger.log('默认复选框：勾选=%s，未勾选=%s', checkedValue, uncheckedValue);
      } else {
        // 自定义值复选框
        checkedValue = args[0];
        uncheckedValue = args[1];
        Logger.log('自定义复选框：勾选=%s，未勾选=%s', checkedValue, uncheckedValue);
      }
    }
    
    Logger.log('当前单元格值：%s', cell.getValue());
  } else {
    Logger.log('该单元格无数据验证规则。')
  }
}

至于cell.getValue()能返回false，是因为默认复选框未勾选时，单元格的实际值就是系统内置的false——这个值是单元格的状态值，和数据验证规则的条件值是两个概念：条件值用于定义勾选/未勾选时的映射值，而单元格值是当前的实际状态结果。

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