使用 Google Apps 脚本将数据从数组复制/推送到工作表范围，一次一行

我在原始表上使用 .getValues() 创建了一个多维数组sheetValues[][]。我想将sheetValues数组中的值复制到目标工作表中。如何将sheetValues数组每行的内容推送到目标工作表中？

什么函数允许我将数组的每一行一次一行（检查 IF 条件后）推入目标表的相应范围？

这是代码片段：

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheetByName("Source Sheet"); //Source sheet that has all data
var lastRow = sheet.getLastRow(); //last row number of Source sheet
var sheetValues = sheet.getRange(1, 1, lastRow, 18).getDisplayValues; //Copy Display values to an array; getDisplayValues() is used instead of getValues() to ignore formulas in the source cells such as "IMPORTRANGE"
var targetSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetbyName('Target Sheet'); //destination sheet
var currentRow = targetSheet.getLastRow(); //current last row of the destination sheet (start copying after this row)
var target = targetSheet.getRange(currentRow+1, 1); //target range where the copying of data should begin in destination sheet

loop through each row of the array (sheetValues) to check if the status (column I) is 'On Target'; if yes, copy that entire row to the target range defined above
for (var i = 0; i <= lastRow; i++) {
  if (sheetValues[i][9] == 'On Target') {
    How do I copy/push the entire row at once (column 1 - 18) directly into the target range (currentRow, columns 1-18)? What function do I use?
  }
  currentRow++;
}

永远不要“一次推送数组的每一行”。这是笨重的代码，启动速度非常慢。设置值与获取值非常相似。您可以声明一个范围变量，其中包含适合值尺寸的适当坐标[ ][] 数组，并将整个值数组传递给 Range 对象的“setValues()”方法。

getRange() 的方法签名之一如下：

sheet.getRange(row, column, numberOfRows, numberOfColumns);

更多信息https://developers.google.com/apps-script/reference/spreadsheet/sheet#getrangerow-column-numrows-numcolumns

前 2 个参数用于范围中最左上角的单元格，而其他参数则定义范围应跨越的行数和列数。

假设您想开始从目标工作表中的第一个单元格插入值，下面是您需要的单行代码。

sheet.getRange(1, 1, sheetValues.length, sheetValues[0].length);

行数是数组的长度，列数是数组第一个元素（行）的长度。

UPDATE

我错过了埋在你的代码中的评论。您可以在将值写入目标工作表之前对其进行过滤。

sheetValues = sheetValues.map(function(row){

if (row[9] == 'Target') { return row;  }

});