Upstream web_controller_provider and dependencies

ios/web/web_state/ui/web_view_js_utils.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 IOS_WEB_WEB_STATE_UI_WEB_VIEW_JS_UTILS_H_
+#define IOS_WEB_WEB_STATE_UI_WEB_VIEW_JS_UTILS_H_
+
+#import <Foundation/Foundation.h>
+
+@class UIWebView;
+@class WKWebView;
+
+// This file contains functions that asynchronously evaluate JavaScript on
+// WKWebView/UIWebView and provide result in the same format. Call
+// |completion_handler| with results of the evaluation or an NSError if there is
+// an error. The |completion_handler| can be nil.
+namespace web {
+
+// The type of the completion handler block that is called to inform about
+// JavaScript evaluation completion.
+typedef void (^JavaScriptCompletion)(NSString*, NSError*);
+
+// Asynchronous adaptor to evaluate JavaScript on UIWebView. Provides evaluation
+// result as it is, without modifications.
+void EvaluateJavaScript(UIWebView* web_view,
+                        NSString* script,
+                        JavaScriptCompletion completion_handler);
+
+// Evaluates JavaScript on WKWebView. Provides evaluation result is the same
+// format as UIWebView.
+void EvaluateJavaScript(WKWebView* web_view,
+                        NSString* script,
+                        JavaScriptCompletion completion_handler);
+
+}  // namespace web
+
+#endif // IOS_WEB_WEB_STATE_UI_WEB_VIEW_JS_UTILS_H_