Home / Questions / 505
Accepted
Rubén
Asked: 2020-12-06 17:35:48 +0800 CST 2020-12-06 17:35:48 +0800 CST

如何在 Google Apps 脚本中测试触发函数（激活器）

  • 772

Google Apps 脚本支持触发器 ( Triggers )，也称为激活器，它传递事件 ( Events ) 来触发函数以触发/激活函数。不幸的是，开发环境不允许在不传递参数的情况下测试函数，因此无法以这种方式模拟事件。尝试时，会导致如下错误：

ReferenceError: 'e' is not defined.

可以将事件视为可选参数，并使用“是否有更好的方法在 Javascript 中执行可选函数参数？”的技术将默认值插入到触发函数中。. 但这引入了一个风险，即懒惰的程序员（谁说我？）可能会留下该代码并产生意想不到的副作用。

当然还有更好的方法。


基于如何在 GAS 中测试触发功能的参考文献？来自Mogsdad 2014-11-14 19:40:55Z 编辑

javascript

1 Answers

  1. Best Answer

    编写一个将模拟事件传递给触发器函数的测试函数。这是一个测试触发功能的示例onEdit()。这将传递一个事件对象，其中包含了解事件中为“电子表格编辑事件”描述的所有信息。

    要使用它，请在您的目标函数上设置一个中断onEdit，选择该函数test_onEdit并单击Debug。

    /*
 * Función de prueba para onEdit. Pasa un objento de evento para simular una
 * edición  a una celda en una hoja de cálculo 
 *
 * Para actualizaciones revisar https://stackoverflow.com/a/16089067/1677912
 *
 * Véase 
 * https://developers.google.com/apps-script/guides/triggers/events#google_sheets_events
 */

function test_onEdit() {
  onEdit({
    user : Session.getActiveUser().getEmail(),
    source : SpreadsheetApp.getActiveSpreadsheet(),
    range : SpreadsheetApp.getActiveSpreadsheet().getActiveCell(),
    value : SpreadsheetApp.getActiveSpreadsheet().getActiveCell().getValue(),
    authMode : "LIMITED"
  });
}

    如果您好奇，这是为了测试Google SpreadsheetonEdit的三个单元格函数的 条件。

    以下是电子表格中表单提交事件的功能。这通过从表单提交中读取数据来构建一个模拟事件。这最初是为在 onFormSubmit 触发器中获取 TypeError 编写的？.

    /**
 * Función de prueba para funciones disparadoras en hojas de cálculo de
 * envío de formularios.
 * Recorre el contenido de la hoja, creando eventos de envío de formulario
 * simulados 
 *
 * Para actualizaciones revisar: https://stackoverflow.com/a/16089067/1677912
 *
 * Véase 
 * https://developers.google.com/apps-script/guides/triggers/events#google_sheets_events
 */

function test_onFormSubmit() {
  var dataRange = SpreadsheetApp.getActiveSheet().getDataRange();
  var data = dataRange.getValues();
  var headers = data[0];
  // Inicia en la fila 1, saltando los encabezados en la fila 0
  for (var row=1; row < data.length; row++) {
    var e = {};
    e.values = data[row].filter(Boolean);  // filtro: https://stackoverflow.com/a/19888749
    e.range = dataRange.offset(row,0,1,data[0].length);
    e.namedValues = {};
    // Recorre los encabezados para crear un objeto namedValues
    // NOTA: todos los namedValues son arreglos.
    for (var col=0; col<headers.length; col++) {
      e.namedValues[headers[col]] = [data[row][col]];
    }
    // Pasar el evento simulado a onFormSubmit
    onFormSubmit(e);
  }
}

    提示

    模拟事件时，请注意尽可能精确地匹配文档事件对象。

    • 如果要验证文档，可以记录从触发函数接收到的事件。

      Logger.log( JSON.stringify( e , null, 2 ) );
      • 在电子表格中提交表单事件：
      • 所有namedValues都是数组。
      • 时间戳是字符串，它们的格式将本地化到表单的位置。如果使用默认*格式从电子表格中读取，它们将是日期对象。如果触发函数依赖于时间戳的字符串格式（这是个坏主意），请注意确保正确模拟了该值。
      • 如果电子表格中有不在表单中的列，则此代码中的技术将模拟一个包含这些附加值的“事件”，这不是从表单提交中接收到的。
      • 正如问题 4335中所报告的，该修复程序valores将跳过空白响应（在“新表单”+“新电子表格”中）。该方法filter(Boolean)用于模拟这种行为。

    *格式化为“纯文本”的单元格会将日期保留为字符串，这不是一个好主意。

    参考
    Mogsdad的回复编辑 2014-12-03 17:16:57Z。

    • 2