SpreadsheetApp.Range.getBorders()函数报错及替代方案咨询

问题说明 #

调用getBorders()方法获取单元格区域边框时触发以下异常：

Exception: Unexpected error while getting the method or property getBorders on object SpreadsheetApp.Range.

测试代码：

function test(){  
  var ss = SpreadsheetApp.getActiveSpreadsheet();  
  var pg = ss.getActiveSheet();  
  var range = pg.getRange(1,1,10,5);  
  var border = range.getBorders(); // 此处触发异常
}

错误原因 #

Google Apps Script的SpreadsheetApp.Range类没有getBorders()方法，仅提供针对单个单元格的getBorder()方法，直接在区域对象上调用不存在的方法会抛出上述异常。

优化后的替代方案 #

原替代方案存在变量名错误（linha未定义，应为row），以下是修正并优化后的代码，实现遍历区域内每个单元格获取边框颜色的功能：

function getBorders(range){  
  const pg = range.getSheet();  
  const fr = range.getRow();  
  const fc = range.getColumn();  
  const lr = range.getLastRow();  
  const lc = range.getLastColumn();  
  const finalArray = [];

  // 统一处理颜色转十六进制的逻辑
  const getHexColor = (color) => {
    if (color.getColorType() === SpreadsheetApp.ColorType.RGB) {
      return color.asRgbColor().asHexString();
    }
    return "#000000"; // 默认黑色
  };

  for(let r = fr; r <= lr; r++){  
    const row = [];
    for(let c = fc; c <= lc; c++){  
      const cell = pg.getRange(r,c);  
      let hexTop, hexLeft, hexRight, hexBottom;

      if(cell.isPartOfMerge()){  
        // 合并单元格暂时使用默认黑色边框，可根据需求调整
        hexTop = hexLeft = hexRight = hexBottom = "#000000";
      } else {  
        const border = cell.getBorder();
        hexTop = getHexColor(border.getTop().getColor());
        hexLeft = getHexColor(border.getLeft().getColor());
        hexRight = getHexColor(border.getRight().getColor());
        hexBottom = getHexColor(border.getBottom().getColor());
      }
      row.push([hexTop, hexLeft, hexRight, hexBottom]);
    }  
    finalArray.push(row);
  }  
  return finalArray;
}

说明 #

• 函数返回一个二维数组，每个子数组对应一行单元格，每个单元格的边框信息格式为[上边框颜色, 左边框颜色, 右边框颜色, 下边框颜色]
• 合并单元格的边框处理可根据实际需求调整，比如获取合并区域的整体边框后分配到对应单元格
• Google Apps Script目前没有直接获取区域所有单元格边框的批量方法，必须遍历单个单元格调用getBorder()

内容的提问来源于stack exchange，提问作者Vitor Luis Dias