[webview_flutter] Update webview platform interface with new methods for running JavaScript.

packages/webview_flutter/webview_flutter_platform_interface/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 1.1.0
+
+* Added `runJavaScript` and `runJavaScriptForResult` interface methods to supersede `evaluateJavaScript`.
+
 ## 1.0.0
 
 * Extracted platform interface from `webview_flutter`.

packages/webview_flutter/webview_flutter_platform_interface/lib/src/method_channel/webview_method_channel.dart

@@ -129,6 +129,18 @@ class MethodChannelWebViewPlatform implements WebViewPlatformController {
  .then((result) => result!);
  }
 
+ @override
+ Future<void> runJavaScript(String javaScriptString) async {
+ await _channel.invokeMethod<String>('runJavaScript', javaScriptString);
+ }
+
+ @override
+ Future<String> runJavaScriptForResult(String javaScriptString) {
+ return _channel
+ .invokeMethod<String>('runJavaScriptForResult', javaScriptString)
+ .then((result) => result!);
+ }
+
  @override
  Future<void> addJavascriptChannels(Set<String> javascriptChannelNames) {
  return _channel.invokeMethod<void>(

packages/webview_flutter/webview_flutter_platform_interface/lib/src/platform_interface/webview_platform_controller.dart

@@ -112,6 +112,23 @@ abstract class WebViewPlatformController {
  "WebView evaluateJavascript is not implemented on the current platform");
  }
 
+ /// Runs the given JavaScript in the context of the current page.
+ ///
+ /// The Future completes with an error if a JavaScript error occurred.
+ Future<void> runJavaScript(String javaScriptString) {
+ throw UnimplementedError(
+ "WebView runJavaScript is not implemented on the current platform");
+ }
+
+ /// Runs the given JavaScript in the context of the current page, and returns the result.
+ ///
+ /// The Future completes with an error if a JavaScript error occurred, or if the type of the
+ /// evaluated expression is not supported(e.g on iOS not all non primitive type can be evaluated).
+ Future<String> runJavaScriptForResult(String javaScriptString) {
+ throw UnimplementedError(
+ "WebView runJavaScriptForResult is not implemented on the current platform");
+ }
+
  /// Adds new JavaScript channels to the set of enabled channels.
  ///
  /// For each value in this list the platform's webview should make sure that a corresponding

packages/webview_flutter/webview_flutter_platform_interface/pubspec.yaml

@@ -4,7 +4,7 @@ repository: https://github.com/flutter/plugins/tree/master/packages/webview_flut
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+webview_flutter%22
 # NOTE: We strongly prefer non-breaking changes, even at the expense of a
 # less-clean API. See https://flutter.dev/go/platform-interface-breaking-changes
-version: 1.0.0
+version: 1.1.0
 
 environment:
  sdk: ">=2.12.0 <3.0.0"

packages/webview_flutter/webview_flutter_platform_interface/test/src/method_channel/webview_method_channel_test.dart

@@ -31,6 +31,7 @@ void main() {
  case 'canGoBack':
  case 'canGoForward':
  return true;
+ case 'runJavaScriptForResult':
  case 'evaluateJavascript':
  return methodCall.arguments as String;
  case 'getScrollX':
@@ -280,6 +281,40 @@ void main() {
  );
  });
 
+ test('runJavaScript', () async {
+ await webViewPlatform.runJavaScript(
+ 'This simulates some Javascript code.',
+ );
+
+ expect(
+ log,
+ <Matcher>[
+ isMethodCall(
+ 'runJavaScript',
+ arguments: 'This simulates some Javascript code.',
+ ),
+ ],
+ );
+ });
+
+ test('runJavaScriptForResult', () async {
+ final String evaluateJavascript =
+ await webViewPlatform.runJavaScriptForResult(
+ 'This simulates some Javascript code.',
+ );
+
+ expect('This simulates some Javascript code.', evaluateJavascript);
+ expect(
+ log,
+ <Matcher>[
+ isMethodCall(
+ 'runJavaScriptForResult',
+ arguments: 'This simulates some Javascript code.',
+ ),
+ ],
+ );
+ });
+
  test('addJavascriptChannels', () async {
  final Set<String> channels = <String>{'channel one', 'channel two'};
  await webViewPlatform.addJavascriptChannels(channels);