Comment tester une fonction de déclenchement dans le gaz?

Vous pouvez écrire une fonction de test qui passe un événement simulé à votre fonction de déclenchement. Voici un exemple qui teste une fonction de déclenchement onEdit() . Il passe un objet d'événement avec toute l'information décrite pour " tableur Modifier les événements "dans comprendre les événements .

pour l'utiliser, définissez votre point de rupture dans la fonction de votre cible onEdit , sélectionnez la fonction test_onEdit et appuyez sur Debug .

/**
 * Test function for onEdit. Passes an event object to simulate an edit to
 * a cell in a spreadsheet.
 *
 * Check for updates: https://stackoverflow.com/a/16089067/1677912
 *
 * See 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"
  });
}

si vous êtes curieux, ceci a été écrit pour tester la fonction onEdit pour feuille de calcul Google conditionnelle à trois cellules .

Voici une fonction de test pour les événements de soumission de formulaire de feuille de calcul. Il construit son événement simulé en lisant les données de soumission de formulaire. Cela a été écrit à l'origine pour obtenir TypeError dans onformsubmit trigger? .

/**
 * Test function for Spreadsheet Form Submit trigger functions.
 * Loops through content of sheet, creating simulated Form Submit Events.
 *
 * Check for updates: https://stackoverflow.com/a/16089067/1677912
 *
 * See 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];
  // Start at row 1, skipping headers in row 0
  for (var row=1; row < data.length; row++) {
    var e = {};
    e.values = data[row].filter(Boolean);  // filter: https://stackoverflow.com/a/19888749
    e.range = dataRange.offset(row,0,1,data[0].length);
    e.namedValues = {};
    // Loop through headers to create namedValues object
    // NOTE: all namedValues are arrays.
    for (var col=0; col<headers.length; col++) {
      e.namedValues[headers[col]] = [data[row][col]];
    }
    // Pass the simulated event to onFormSubmit
    onFormSubmit(e);
  }
}

Conseils

lors de la simulation d'événements, veillez à apparier les objets d'événements documentés aussi près que possible.

• Si vous souhaitez valider la documentation, vous pouvez enregistrer l'événement reçu à partir de votre fonction de déclenchement.

  Logger.log( JSON.stringify( e , null, 2 ) );
  

• sous forme de tableur événements de soumission:

  • toutes les valeurs nommées sont des tableaux.
  • les horodateurs sont Les chaînes de caractères, et leur format seront localisés à l'emplacement de la forme. Si Lu à partir d'une feuille de calcul avec le formatage par défaut ^* , ils sont des objets Date. Si votre fonction de déclenchement repose sur le format de chaîne de caractères de l'horodatage (ce qui est une mauvaise idée), prenez soin de vous assurer de simuler la valeur de manière appropriée.
  • si vous avez des colonnes dans votre tableur qui ne sont pas dans votre forme, la technique dans ce script simulera un "événement" avec ces supplémentaires valeurs incluses, ce qui n'est pas ce que vous recevrez d'une soumission de formulaire.
  • comme indiqué dans numéro 4335 , le tableau values saute sur les réponses Vierges (dans" nouveaux formulaires " + "nouvelles feuilles"). La méthode filter(Boolean) est utilisée pour simuler ce comportement.

---

^* une cellule formatée "texte simple" préservera la date comme une chaîne de caractères, et n'est pas une Bonne Idée.