Office Scripts报错：Cannot read properties of undefined(reading '5')求助

问题 #

编写Office Scripts实现以下需求：

• 对表格「MasterA」排序
• 拆分E列字符串：保留前10个字符在E列，剩余部分移入F列

运行代码时触发错误：Line 16: Cannot read properties of undefined (reading '5')，对应代码行let value: string = range.getValue[i][5]。

用户提供的原始代码：

function main(workbook: ExcelScript.Workbook) {
    let masterA = workbook.getTable("MasterA");
    // Sort on table: masterA column index: '8'
    masterA.getSort().apply([{key: 8, ascending: true}]);
    // Sort on table: masterA column index: '2'
    masterA.getSort().apply([{key: 2, ascending: true}]);
    let tableRows = masterA.getRowCount();
    let sheet = workbook.getActiveWorksheet();
    // Set the range to the column of data to modify
    let lastRowCount = sheet.getTable("MasterA").getRowCount()
    if (lastRowCount > 0) {// Adjust the range to include all rows in the column
    let range = sheet.getRangeByIndexes(1, 0, lastRowCount, 10);
    let vals = range.getValues();

    for (let i=1; i< tableRows; i++) {
        let value: string = range.getValue[i][5]
        let len: number = value.length
        if (len > 10) {
            vals[i][6] = value.substring(10)
            vals[i][5] = value.substring(0,9)
        }
    }}
}

错误原因 #

1. range.getValue调用错误：getValue()是Range对象的方法，必须带括号执行，且仅返回单个单元格的值，不是二维数组。你已经通过range.getValues()获取了整个区域的二维数组vals，应直接从vals读取数据。
2. 索引与循环逻辑错误：
   • 循环从i=1开始会跳过表格第一行数据；循环条件i < tableRows与lastRowCount不统一，易导致数组越界。
   • 若range.getValue[i]不存在，访问[5]就会触发undefined错误。
3. 字符串截取错误：substring(0,9)仅保留前9个字符，要保留前10个需改为substring(0,10)。
4. 排序逻辑冗余：两次调用apply()会覆盖排序规则，应一次性传入多列排序条件。
5. 冗余对象获取：已获取masterA表格对象，无需再通过sheet.getTable("MasterA")重复获取。

修正后的代码 #

function main(workbook: ExcelScript.Workbook) {
    // 获取目标表格
    let masterA = workbook.getTable("MasterA");
    // 一次性设置多列排序：先按第8列升序，再按第2列升序
    masterA.getSort().apply([
        {key: 8, ascending: true},
        {key: 2, ascending: true}
    ]);

    let tableRows = masterA.getRowCount();
    if (tableRows === 0) {
        return; // 无数据时直接终止程序
    }

    // 获取表格的纯数据区域（跳过表头和总计行）
    let dataRange = masterA.getRangeBetweenHeaderAndTotal();
    let vals = dataRange.getValues();

    // 遍历所有数据行
    for (let i = 0; i < tableRows; i++) {
        let value = vals[i][5] as string;
        // 跳过空值或非字符串类型
        if (!value || typeof value !== "string") {
            continue;
        }
        if (value.length > 10) {
            // 剩余部分写入F列（索引6）
            vals[i][6] = value.substring(10);
            // E列保留前10个字符
            vals[i][5] = value.substring(0, 10);
        }
    }

    // 将修改后的数据批量写回表格
    dataRange.setValues(vals);
}

关键修正点 #

• 合并排序条件，一次完成多列排序，避免规则覆盖。
• 使用getRangeBetweenHeaderAndTotal()直接获取表格数据区域，无需手动计算行列，更适配表格结构变化。
• 从vals二维数组读取数据，彻底解决getValue的使用错误。
• 循环从i=0开始，覆盖所有数据行；添加空值和类型判断，避免非字符串数据导致的错误。
• 修正字符串截取索引，确保保留前10个字符。
• 批量写回数据，提升脚本执行效率。

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