Office Scripts中getSurroundingRegion()空单元格报错及替代方案咨询

Office Scripts里的getSurroundingRegion()和VBA的CurrentRegion行为存在差异：当目标单元格为空，且周围没有关联数据区域时，前者会抛出getSurroundingRegion: The requested resource doesn't exist.错误，而后者会直接返回该单元格本身。除了基础的错误处理，这里提供几个更优的替代方案：

1. 先判空再处理 #

直接检查目标单元格是否为空，为空就返回原单元格，否则调用getSurroundingRegion()：

function main(workbook: ExcelScript.Workbook) {
    let sh = workbook.getActiveWorksheet();
    let targetRng = sh.getRange("A1");
    let resultRng: ExcelScript.Range;

    if (targetRng.getValue() === "") {
        resultRng = targetRng;
    } else {
        resultRng = targetRng.getSurroundingRegion();
    }

    console.log(resultRng.getAddress());
}

2. 结合已使用范围判断 #

如果需要考虑单元格是否在工作表的已使用区域内，可以加一层判断，避免边缘空单元格的问题：

function main(workbook: ExcelScript.Workbook) {
    let sh = workbook.getActiveWorksheet();
    let targetRng = sh.getRange("A1");
    let usedRange = sh.getUsedRange();
    let resultRng: ExcelScript.Range;

    // 检查单元格是否不在已使用区域，或者本身为空
    if (!usedRange || !usedRange.getIntersection(targetRng) || targetRng.getValue() === "") {
        resultRng = targetRng;
    } else {
        resultRng = targetRng.getSurroundingRegion();
    }

    console.log(resultRng.getAddress());
}

3. 封装安全调用函数（推荐） #

把错误处理和逻辑封装成可复用的工具函数，既保持代码整洁，又能统一处理所有类似场景：

// 封装安全获取周边区域的函数
function getSafeSurroundingRegion(targetRng: ExcelScript.Range): ExcelScript.Range {
    try {
        return targetRng.getSurroundingRegion();
    } catch (err) {
        // 只捕获目标错误，其他错误正常抛出
        if (err.message.includes("The requested resource doesn't exist")) {
            return targetRng;
        }
        throw err;
    }
}

function main(workbook: ExcelScript.Workbook) {
    let sh = workbook.getActiveWorksheet();
    let targetRng = sh.getRange("A1");
    let resultRng = getSafeSurroundingRegion(targetRng);
    
    console.log(resultRng.getAddress());
}

这个封装后的方案兼顾了严谨性和复用性，和VBACurrentRegion的行为对齐度最高。

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