[9.0.0] clearCache, clearFormData, clear History, requestFocus methods added

Author: sgny

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog of `@reason-react-native/webview`
 
+## 9.0.0 - 2020-03-19
+
+- `clearCache`, `clearFormData`, `clearHistory`, `requestFocus` methods added
+- `injectedJavaScriptForMainFrameOnly`, `injectedJavaScriptBeforeContentLoaded`,
+  `injectedJavaScriptBeforeContentLoadedForMainFrameOnly` props added
+
 ## 7.4.0 - 2019-10-06
 
 Initial release.

README.md

@@ -511,7 +511,9 @@ Does not store any data within the lifetime of the `WebView.`
 
 #### `injectedJavaScript: string`
 
-Specifies JavaScript that will be injected into the web page when loaded. The string should evaluate to a valid type (e.g. `true`) and not otherwise throw an exception.
+Specifies JavaScript that will be injected into the web page when loaded. The string should evaluate to a valid type (e.g. `true`) and not otherwise throw an exception. 
+
+Example below passes`window.location` as a JSON object to be handled by the function passed to `onMessage`
 
 ```reason
 let injectedJavaScript = "(function() {
@@ -529,6 +531,45 @@ Note that the JavaScript will only be run once when the page is loaded for the f
 
 Refer to the [Communicating between JS and Native](https://github.com/react-native-community/react-native-webview/blob/master/docs/Guide.md#communicating-between-js-and-native) guide for more information.
 
+On iOS, also refer to documentation on [WKUserScriptInjectionTimeAtDocumentEnd](https://developer.apple.com/documentation/webkit/wkuserscriptinjectiontime/wkuserscriptinjectiontimeatdocumentend?language=objc).
+
+#### `injectedJavaScriptForMainFrameOnly: bool`
+
+_iOS only_
+Script specified with `injectedJavaScript` will be loaded for all frames (main frame and iframes) when `false`, defaults to `true` (only for the main frame).
+
+#### `injectedJavaScriptBeforeContentLoaded: string`
+
+_iOS only_
+Specifies JavaScript that will be injected into the web page after the document element is created, but before any other content is loaded. The string should evaluate to a valid type (e.g. `true`) and not otherwise throw an exception.
+
+
+Example below passes`window.location` as a JSON object to be handled by the function passed to `onMessage`
+
+```reason
+let injectedJavaScript = "(function() {
+  window.ReactNativeWebView.postMessage(JSON.stringify(window.location));
+})();";
+
+<ReactNativeWebView
+  source=ReactNativeWebView.Source.uri(~uri="https://facebook.github.io/react-native", ())
+  injectedJavaScriptBeforeContentLoaded=injectedJavaScript
+  onMessage={e => Js.Console.warn(e##nativeEvent##data)}
+/>
+```
+
+Refer to the [Communicating between JS and Native](https://github.com/react-native-community/react-native-webview/blob/master/docs/Guide.md#communicating-between-js-and-native) guide for more information.
+
+Also refer to documentation on [WKUserScriptInjectionTimeAtDocumentStart](https://developer.apple.com/documentation/webkit/wkuserscriptinjectiontime/wkuserscriptinjectiontimeatdocumentstart?language=objc).
+
+#### `injectedJavaScriptBeforeContentLoadedForMainFrameOnly: bool`
+
+_iOS only_
+Script specified with `injectedJavaScriptBeforeContentLoaded` will be loaded for all frames (main frame and iframes) when `false`, defaults to `true` (only for the main frame).
+
+Note that it may not be possible to inject JS into iframes in this stage of the page lifecycle, therefore exercise caution when setting to `false`. 
+
+
 #### `javaScriptEnabled: bool`
 
 _Android only_
@@ -753,6 +794,24 @@ switch (ref -> React.Ref.current -> Js.Nullable.toOption) {
 };
 ```
 
+#### `clearFormData: element => unit`
+
+_Android only_
+Removes the autocomplete popup (if present) from the currently focused form field.
+
+#### `clearCache: element => unit`
+
+_Android only_
+Clears the resource cache for all WebViews in the application.
+
+#### `clearHistory: element => unit`
+
+_Android only_
+Clears WebView's internal back/forward list 
+
+#### `requestFocus: element => unit`
+Request focus for the WebView.
+
 #### `goBack: element => unit`
 
 Navigates back one page in the WebView history.

package.json

@@ -1,12 +1,12 @@
 {
   "name": "@reason-react-native/webview",
-  "version": "7.4.0",
+  "version": "9.0.0",
   "publishConfig": {
     "access": "public"
   },
   "author": "sgny (https://github.com/sgny)",
   "peerDependencies": {
-    "react-native-webview": "~7.4.0"
+    "react-native-webview": "~9.0.0"
   },
   "repository": "https://github.com/reason-react-native/webview.git",
   "license": "MIT",

src/ReactNativeWebView.re

@@ -161,6 +161,9 @@ external make:
     ~hideKeyboardAccessoryView: bool=?,
     ~incognito: bool=?,
     ~injectedJavaScript: string=?,
+    ~injectedJavaScriptForMainFrameOnly: bool=?,
+    ~injectedJavaScriptBeforeContentLoaded: string=?,
+    ~injectedJavaScriptBeforeContentLoadedForMainFrameOnly: bool=?,
     ~javaScriptEnabled: bool=?,
     ~keyboardDisplayRequiresUserAction: bool=?,
     ~mediaPlaybackRequiresUserAction: bool=?,

src/ReactNativeWebView_Methods.re

@@ -1,4 +1,8 @@
 module Make = (T: {type t;}) => {
+  [@bs.send] external clearFormData: T.t => unit = "clearFormData";
+  [@bs.send] external clearCache: T.t => unit = "clearCache";
+  [@bs.send] external clearHistory: T.t => unit = "clearHistory";
+  [@bs.send] external requestFocus: T.t => unit = "requestFocus";
   [@bs.send] external goForward: T.t => unit = "goForward";
   [@bs.send] external goBack: T.t => unit = "goBack";
   [@bs.send] external reload: T.t => unit = "reload";