[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 --------------------------------------------------------------
+    // Executes script in the context of the current page and returns the value
+    // that the script evaluated to with callback. Script execution can be
+    // suspend.
+    virtual void requestExecuteScriptAndReturnValue(const WebScriptSource&,
+        bool userGesture, WebScriptExecutionCallback*) = 0;
+
+    // worldID must be > 0 (as 0 represents the main world).
+    // worldID must be < EmbedderWorldIdLimit, high number used internally.
+    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