add spec and fix docs

docs/api/browser-window.md

@@ -910,7 +910,9 @@ Injects CSS into this page.
 * `code` String
 * `userGesture` Boolean - Default false
 
-Evaluates `code` in page. If `userGesture` is set will simulate user gesture.
+Evaluates `code` in page. If `userGesture` is set will create user gesture context,
+HTML api like `requestFullScreen` which require user action can take advantage
+of this option for automation.
 
 ### WebContents.setAudioMuted(muted)
 

docs/api/web-view-tag.md

@@ -225,11 +225,14 @@ Returns a `String` represents the user agent for guest page.
 
 Injects CSS into guest page.
 
-### `<webview>`.executeJavaScript(code)
+### `<webview>`.executeJavaScript(code, userGesture)
 
 * `code` String
+* `userGesture` Boolean - Default false
 
-Evaluates `code` in guest page.
+Evaluates `code` in page. If `userGesture` is set will create user gesture context,
+HTML api like `requestFullScreen` which require user action can take advantage
+of this option for automation.
 
 ### `<webview>`.openDevTools()
 

spec/fixtures/pages/fullscreen.html

@@ -0,0 +1 @@
+<video></video>

spec/webview-spec.coffee

@@ -261,3 +261,17 @@ describe '<webview> tag', ->
           done()
         webview.src = "file://#{fixtures}/pages/dom-ready.html?port=#{port}"
         document.body.appendChild webview
+
+  describe 'executeJavaScript', ->
+    it 'should support user gesture', (done) ->
+      listener = (e) ->
+        webview.removeEventListener 'enter-html-full-screen', listener
+        done()
+      listener2 = (e) ->
+        jsScript = 'document.getElementsByTagName("video")[0].webkitRequestFullScreen()'
+        webview.executeJavaScript jsScript, true
+        webview.removeEventListener 'did-finish-load', listener2
+      webview.addEventListener 'enter-html-full-screen', listener
+      webview.addEventListener 'did-finish-load', listener2
+      webview.src = "file://#{fixtures}/pages/fullscreen.html"
+      document.body.appendChild webview