Added method to nightmare helper to trigger electron mouse events (#553)

Author: chrisbrainerd

docs/helpers/Nightmare.md

@@ -461,6 +461,14 @@ Can submit special keys like 'Enter', 'Backspace', etc
 
 -   `key`  
 
+## triggerMouseEvent
+
+Sends [input event](http://electron.atom.io/docs/api/web-contents/#contentssendinputeventevent) on a page.
+
+**Parameters**
+
+-   `event` event object, must contain `x` and `y` keys, others as needed from above link  
+
 ## resizeWindow
 
 Resize the current window to provided width and height.

lib/helper/Nightmare.js

@@ -159,6 +159,16 @@ class Nightmare extends Helper {
     }, function (key, done) {
       this.child.call('pressKey', key, done);
     });
+
+    this.Nightmare.action('triggerMouseEvent', function (ns, options, parent, win, renderer, done) {
+      parent.respondTo('triggerMouseEvent', function (evt, done) {
+        win.webContents.sendInputEvent(evt);
+        done();
+      });
+      done();
+    }, function (event, done) {
+      this.child.call('triggerMouseEvent', event, done);
+    });
   }
 
   _beforeSuite() {
@@ -568,6 +578,20 @@ class Nightmare extends Helper {
     return this.browser.pressKey(key).wait(this.options.waitForAction);
   }
 
+  /**
+   * Sends [input event](http://electron.atom.io/docs/api/web-contents/#contentssendinputeventevent) on a page.
+   * Should be a mouse event like:
+   *  {
+        type: 'mouseDown',
+        x: args.x,
+        y: args.y,
+        button: "left"
+      }
+   */
+  triggerMouseEvent(event) {
+    return this.browser.triggerMouseEvent(event).wait(this.options.waitForAction);
+  }
+
   /**
    * {{> ../webapi/seeCheckboxIsChecked }}
    */

translations/it-IT.js

@@ -19,6 +19,7 @@ module.exports = {
         'selectOption': 'seleziono_la_opzione',
         'fillField': 'compilo_il_campo',
         'pressKey': 'premo_il_tasto',
+        'triggerMouseEvent': 'attivare_levento_del_mouse',
         'attachFile': 'allego_il_file',
         'seeInField': 'vedo_nel_campo',
         'dontSeeInField': 'non_vedo_nel_campo',

translations/pl-PL.js

@@ -19,6 +19,7 @@ module.exports = {
         'selectOption': 'wybieram_opcję',
         'fillField': 'wypełniam_pole',
         'pressKey': 'naciskam_przycisk',
+        'triggerMouseEvent': 'wywołaj_wydarzenie_myszki',
         'attachFile': 'załączam_plik',
         'seeInField': 'widzę_w_polu',
         'dontSeeInField': 'nie_widzę_w_polu',

translations/pt-BR.js

@@ -21,6 +21,7 @@ module.exports = {
         'selectOption': 'selecionoAOpcao',
         'fillField': 'preenchoOCampo',
         'pressKey': 'pressioneATecla',
+        'triggerMouseEvent': 'lançarEventoDoMouse',
         'attachFile': 'anexaOArquivo',
         'seeInField': 'vejoNoCampo',
         'dontSeeInField': 'naoVejoNoCampo',

translations/ru-RU.js

@@ -12,6 +12,7 @@ module.exports = {
         'selectOption': 'выбираю_опцию',
         'fillField': 'заполнаю_поле',
         'pressKey': 'нажимаю_кнопку',
+        'triggerMouseEvent': 'триггерное_событие_мыши',
         'attachFile': 'загружаю_файл',
         'seeInField': 'вижу_в_поле',
         'dontSeeInField': 'не_вижу_в_поле',