Context menu egtests, plus related utilities.

ios/web/public/test/web_view_interaction_test_util.h

 // Copyright 2016 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.
 
-#import "ios/web/public/web_state/web_state.h"
+#import <UIKit/UIKit.h>
 
 #include <string>
 
+#include "base/ios/block_types.h"
+#include "base/values.h"
+
+#import "ios/web/public/web_state/web_state.h"
+
 namespace web {
 namespace test {
 
+// Synchronously returns the result of executed JavaScript.
+std::unique_ptr<base::Value> ExecuteScript(web::WebState* web_state,

[Eugene But (OOO till 7-30), 2016/08/30 18:11:05]

s/ExecuteScript/ExecuteJavaScript to be consistent with bunch of
ExecuteJavaScript methods

[marq (ping after 24h), 2016/08/31 13:07:58]

Done.

+                                           const std::string& script);
+
+// Returns the CGRect, in the coordinate system of web_state's view, that
+// encloses the element with |element_id| in |web_state|'s webview.
+// There is no guarantee that the CGRect returned is inside the current window;
+// callers should check and act accordingly (scrolling the webview, perhaps).
+// Returns CGRectZero if no element could be found.
+CGRect BoundingRectOfElementWithId(web::WebState* web_state,

[Eugene But (OOO till 7-30), 2016/08/30 18:11:05]

Maybe s/BoundingRectOfElementWithId/GetBoundingElementRect ? Current name sounds
like a good Objective-C name :)

[marq (ping after 24h), 2016/08/31 13:07:58]

Yeah, I can write Objective-C in any language.

+                                   const std::string& element_id);
+
 // Returns whether the element with |element_id| in the passed |web_state| has
 // been tapped using a JavaScript click() event.
 bool TapWebViewElementWithId(web::WebState* web_state,
                              const std::string& element_id);
 
 // Returns whether the element with |element_id| in the passed |web_state| has
 // been focused using a JavaScript focus() event.
 bool FocusWebViewElementWithId(web::WebState* web_state,
                                const std::string& element_id);
 
 // Returns whether the form with |form_id| in the passed |web_state| has been
 // submitted using a JavaScript submit() event.
 bool SubmitWebViewFormWithId(web::WebState* web_state,
                              const std::string& form_id);
 }  // namespace test
 }  // namespace web