[DevTools] Added public method for async execution of scripts

public/web/WebLocalFrame.h

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef WebLocalFrame_h
 #define WebLocalFrame_h
 
 #include "WebFrame.h"
 
 namespace blink {
 
+class WebScriptExecutionCallback;
+
 // Interface for interacting with in process frames. This contains methods that
 // require interacting with a frame's document.
 // FIXME: Move lots of methods from WebFrame in here.
 class WebLocalFrame : public WebFrame {
 public:
     // Creates a WebFrame. Delete this WebFrame by calling WebFrame::close().
     // It is valid to pass a null client pointer.
     BLINK_EXPORT static WebLocalFrame* create(WebFrameClient*);
 
     // Returns the WebFrame associated with the current V8 context. This
@@ skipping 38 matching lines @@
     virtual void navigateToSandboxedMarkup(const WebData& markup) = 0;
 
 
     // Orientation Changes ----------------------------------------------------
 
     // Notify the frame that the screen orientation has changed.
     virtual void sendOrientationChangeEvent() = 0;
 
 
     // Scripting --------------------------------------------------------------
+    virtual void requestExecuteScriptAndReturnValue(const WebScriptSource&,

[pfeldman, 2014/10/22 15:38:17]

Please document those. Also, it is not clear whether I am allowed to use the
ones below. I should not be since things might be suspended, right?

[kozyatinskiy1, 2014/10/22 16:46:58]

Done.

+        bool userGesture, WebScriptExecutionCallback*) = 0;
+    virtual void requestExecuteScriptInIsolatedWorld(
+        int worldID, const WebScriptSource* sourceIn, unsigned numSources,
+        int extensionGroup, bool userGesture, WebScriptExecutionCallback*) = 0;
+
     // ONLY FOR TESTS: Forwards to executeScriptAndReturnValue, but sets a fake
     // UserGestureIndicator before execution.
     virtual v8::Handle<v8::Value> executeScriptAndReturnValueForTests(const WebScriptSource&) = 0;
 
     // Associates an isolated world with human-readable name which is useful for
     // extension debugging.
     virtual void setIsolatedWorldHumanReadableName(int worldID, const WebString&) = 0;
 
 
     // Selection --------------------------------------------------------------
 
     // Moves the selection extent point. This function does not allow the
     // selection to collapse. If the new extent is set to the same position as
     // the current base, this function will do nothing.
     virtual void moveRangeSelectionExtent(const WebPoint&) = 0;
 };
 
 } // namespace blink
 
 #endif // WebLocalFrame_h