import 'dart:async'; import 'dart:collection'; import 'dart:io'; import 'package:flutter/foundation.dart'; import 'package:flutter/services.dart'; import 'context_menu.dart'; import 'in_app_webview_controller.dart'; import 'webview_options.dart'; import 'types.dart'; ///This class uses the native WebView of the platform. ///The [webViewController] field can be used to access the [InAppWebViewController] API. class InAppBrowser { ///Browser's UUID. String uuid; ///Context menu used by the browser. It should be set before opening the browser. ContextMenu contextMenu; Map javaScriptHandlersMap = HashMap(); bool _isOpened = false; MethodChannel _channel; static const MethodChannel _sharedChannel = const MethodChannel('com.pichillilorenzo/flutter_inappbrowser'); /// WebView Controller that can be used to access the [InAppWebViewController] API. InAppWebViewController webViewController; /// InAppBrowser() { uuid = uuidGenerator.v4(); this._channel = MethodChannel('com.pichillilorenzo/flutter_inappbrowser_$uuid'); this._channel.setMethodCallHandler(handleMethod); _isOpened = false; webViewController = new InAppWebViewController.fromInAppBrowser(uuid, this._channel, this); } Future handleMethod(MethodCall call) async { switch (call.method) { case "onBrowserCreated": this._isOpened = true; onBrowserCreated(); break; case "onExit": this._isOpened = false; onExit(); break; default: return webViewController.handleMethod(call); } } ///Opens an [url] in a new [InAppBrowser] instance. /// ///[url]: The [url] to load. Call `encodeUriComponent()` on this if the [url] contains Unicode characters. The default value is `about:blank`. /// ///[headers]: The additional headers to be used in the HTTP request for this URL, specified as a map from name to value. /// ///[options]: Options for the [InAppBrowser]. Future openUrl( {@required String url, Map headers = const {}, InAppBrowserClassOptions options}) async { assert(url != null && url.isNotEmpty); this.throwIsAlreadyOpened(message: 'Cannot open $url!'); Map args = {}; args.putIfAbsent('uuid', () => uuid); args.putIfAbsent('url', () => url); args.putIfAbsent('headers', () => headers); args.putIfAbsent('options', () => options?.toMap() ?? {}); args.putIfAbsent('contextMenu', () => contextMenu?.toMap() ?? {}); await _sharedChannel.invokeMethod('openUrl', args); } ///Opens the given [assetFilePath] file in a new [InAppBrowser] instance. The other arguments are the same of [InAppBrowser.openUrl]. /// ///To be able to load your local files (assets, js, css, etc.), you need to add them in the `assets` section of the `pubspec.yaml` file, otherwise they cannot be found! /// ///Example of a `pubspec.yaml` file: ///```yaml ///... /// ///# The following section is specific to Flutter. ///flutter: /// /// # The following line ensures that the Material Icons font is /// # included with your application, so that you can use the icons in /// # the material Icons class. /// uses-material-design: true /// /// assets: /// - assets/index.html /// - assets/css/ /// - assets/images/ /// ///... ///``` ///Example of a `main.dart` file: ///```dart ///... ///inAppBrowser.openFile("assets/index.html"); ///... ///``` /// ///[headers]: The additional headers to be used in the HTTP request for this URL, specified as a map from name to value. /// ///[options]: Options for the [InAppBrowser]. Future openFile( {@required String assetFilePath, Map headers = const {}, InAppBrowserClassOptions options}) async { assert(assetFilePath != null && assetFilePath.isNotEmpty); this.throwIsAlreadyOpened(message: 'Cannot open $assetFilePath!'); Map args = {}; args.putIfAbsent('uuid', () => uuid); args.putIfAbsent('url', () => assetFilePath); args.putIfAbsent('headers', () => headers); args.putIfAbsent('options', () => options?.toMap() ?? {}); args.putIfAbsent('contextMenu', () => contextMenu?.toMap() ?? {}); await _sharedChannel.invokeMethod('openFile', args); } ///Opens a new [InAppBrowser] instance with [data] as a content, using [baseUrl] as the base URL for it. /// ///The [mimeType] parameter specifies the format of the data. The default value is `"text/html"`. /// ///The [encoding] parameter specifies the encoding of the data. The default value is `"utf8"`. /// ///The [androidHistoryUrl] parameter is the URL to use as the history entry. The default value is `about:blank`. If non-null, this must be a valid URL. This parameter is used only on Android. /// ///The [options] parameter specifies the options for the [InAppBrowser]. Future openData( {@required String data, String mimeType = "text/html", String encoding = "utf8", String baseUrl = "about:blank", String androidHistoryUrl = "about:blank", InAppBrowserClassOptions options}) async { assert(data != null); Map args = {}; args.putIfAbsent('uuid', () => uuid); args.putIfAbsent('options', () => options?.toMap() ?? {}); args.putIfAbsent('data', () => data); args.putIfAbsent('mimeType', () => mimeType); args.putIfAbsent('encoding', () => encoding); args.putIfAbsent('baseUrl', () => baseUrl); args.putIfAbsent('historyUrl', () => androidHistoryUrl); args.putIfAbsent('contextMenu', () => contextMenu?.toMap() ?? {}); await _sharedChannel.invokeMethod('openData', args); } ///This is a static method that opens an [url] in the system browser. You wont be able to use the [InAppBrowser] methods here! static Future openWithSystemBrowser({@required String url}) async { assert(url != null && url.isNotEmpty); Map args = {}; args.putIfAbsent('url', () => url); return await _sharedChannel.invokeMethod('openWithSystemBrowser', args); } ///Displays an [InAppBrowser] window that was opened hidden. Calling this has no effect if the [InAppBrowser] was already visible. Future show() async { this.throwIsNotOpened(); Map args = {}; args.putIfAbsent('uuid', () => uuid); await _channel.invokeMethod('show', args); } ///Hides the [InAppBrowser] window. Calling this has no effect if the [InAppBrowser] was already hidden. Future hide() async { this.throwIsNotOpened(); Map args = {}; await _channel.invokeMethod('hide', args); } ///Closes the [InAppBrowser] window. Future close() async { this.throwIsNotOpened(); Map args = {}; await _channel.invokeMethod('close', args); } ///Check if the Web View of the [InAppBrowser] instance is hidden. Future isHidden() async { this.throwIsNotOpened(); Map args = {}; return await _channel.invokeMethod('isHidden', args); } ///Sets the [InAppBrowser] options with the new [options] and evaluates them. Future setOptions({@required InAppBrowserClassOptions options}) async { this.throwIsNotOpened(); Map args = {}; args.putIfAbsent('options', () => options?.toMap() ?? {}); await _channel.invokeMethod('setOptions', args); } ///Gets the current [InAppBrowser] options as a `Map`. Returns `null` if the options are not setted yet. Future getOptions() async { this.throwIsNotOpened(); Map args = {}; InAppBrowserClassOptions inAppBrowserClassOptions = InAppBrowserClassOptions(); Map options = await _channel.invokeMethod('getOptions', args); if (options != null) { options = options.cast(); inAppBrowserClassOptions.crossPlatform = InAppBrowserOptions.fromMap(options); inAppBrowserClassOptions.inAppWebViewGroupOptions = InAppWebViewGroupOptions(); inAppBrowserClassOptions.inAppWebViewGroupOptions.crossPlatform = InAppWebViewOptions.fromMap(options); if (Platform.isAndroid) { inAppBrowserClassOptions.android = AndroidInAppBrowserOptions.fromMap(options); inAppBrowserClassOptions.inAppWebViewGroupOptions.android = AndroidInAppWebViewOptions.fromMap(options); } else if (Platform.isIOS) { inAppBrowserClassOptions.ios = IOSInAppBrowserOptions.fromMap(options); inAppBrowserClassOptions.inAppWebViewGroupOptions.ios = IOSInAppWebViewOptions.fromMap(options); } } return inAppBrowserClassOptions; } ///Returns `true` if the [InAppBrowser] instance is opened, otherwise `false`. bool isOpened() { return this._isOpened; } ///Event fired when the [InAppBrowser] is created. void onBrowserCreated() {} ///Event fired when the [InAppBrowser] window is closed. void onExit() {} ///Event fired when the [InAppBrowser] starts to load an [url]. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebViewClient#onPageStarted(android.webkit.WebView,%20java.lang.String,%20android.graphics.Bitmap) ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wknavigationdelegate/1455621-webview void onLoadStart(String url) {} ///Event fired when the [InAppBrowser] finishes loading an [url]. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebViewClient#onPageFinished(android.webkit.WebView,%20java.lang.String) ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wknavigationdelegate/1455629-webview void onLoadStop(String url) {} ///Event fired when the [InAppBrowser] encounters an error loading an [url]. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebViewClient#onReceivedError(android.webkit.WebView,%20int,%20java.lang.String,%20java.lang.String) ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wknavigationdelegate/1455623-webview void onLoadError(String url, int code, String message) {} ///Event fired when the [InAppBrowser] main page receives an HTTP error. /// ///[url] represents the url of the main page that received the HTTP error. /// ///[statusCode] represents the status code of the response. HTTP errors have status codes >= 400. /// ///[description] represents the description of the HTTP error. On iOS, it is always an empty string. /// ///**NOTE**: available on Android 23+. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebViewClient#onReceivedHttpError(android.webkit.WebView,%20android.webkit.WebResourceRequest,%20android.webkit.WebResourceResponse) ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wknavigationdelegate/1455643-webview void onLoadHttpError(String url, int statusCode, String description) {} ///Event fired when the current [progress] (range 0-100) of loading a page is changed. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebChromeClient#onProgressChanged(android.webkit.WebView,%20int) void onProgressChanged(int progress) {} ///Event fired when the [InAppBrowser] webview receives a [ConsoleMessage]. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebChromeClient#onConsoleMessage(android.webkit.ConsoleMessage) void onConsoleMessage(ConsoleMessage consoleMessage) {} ///Give the host application a chance to take control when a URL is about to be loaded in the current WebView. This event is not called on the initial load of the WebView. /// ///Note that on Android there isn't any way to load an URL for a frame that is not the main frame, so if the request is not for the main frame, the navigation is allowed by default. ///However, if you want to cancel requests for subframes, you can use the [AndroidInAppWebViewOptions.regexToCancelSubFramesLoading] option ///to write a Regular Expression that, if the url request of a subframe matches, then the request of that subframe is canceled. /// ///Also, on Android, this method is not called for POST requests. /// ///[shouldOverrideUrlLoadingRequest] represents the navigation request. /// ///**NOTE**: In order to be able to listen this event, you need to set [InAppWebViewOptions.useShouldOverrideUrlLoading] option to `true`. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebViewClient#shouldOverrideUrlLoading(android.webkit.WebView,%20java.lang.String) ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wknavigationdelegate/1455641-webview // ignore: missing_return Future shouldOverrideUrlLoading( ShouldOverrideUrlLoadingRequest shouldOverrideUrlLoadingRequest) {} ///Event fired when the [InAppBrowser] webview loads a resource. /// ///**NOTE**: In order to be able to listen this event, you need to set [InAppWebViewOptions.useOnLoadResource] and [InAppWebViewOptions.javaScriptEnabled] options to `true`. void onLoadResource(LoadedResource resource) {} ///Event fired when the [InAppBrowser] webview scrolls. /// ///[x] represents the current horizontal scroll origin in pixels. /// ///[y] represents the current vertical scroll origin in pixels. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebView#onScrollChanged(int,%20int,%20int,%20int) ///**Official iOS API**: https://developer.apple.com/documentation/uikit/uiscrollviewdelegate/1619392-scrollviewdidscroll void onScrollChanged(int x, int y) {} ///Event fired when [InAppBrowser] recognizes and starts a downloadable file. /// ///[url] represents the url of the file. /// ///**NOTE**: In order to be able to listen this event, you need to set [InAppWebViewOptions.useOnDownloadStart] option to `true`. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebView#setDownloadListener(android.webkit.DownloadListener) ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wknavigationdelegate/1455643-webview void onDownloadStart(String url) {} ///Event fired when the [InAppBrowser] webview finds the `custom-scheme` while loading a resource. Here you can handle the url request and return a [CustomSchemeResponse] to load a specific resource encoded to `base64`. /// ///[scheme] represents the scheme of the url. /// ///[url] represents the url of the request. /// ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wkurlschemehandler // ignore: missing_return Future onLoadResourceCustomScheme( String scheme, String url) {} ///Event fired when the [InAppBrowser] webview requests the host application to create a new window, ///for example when trying to open a link with `target="_blank"` or when `window.open()` is called by JavaScript side. /// ///[onCreateWindowRequest] represents the request. /// ///**NOTE**: on Android you need to set [AndroidInAppWebViewOptions.supportMultipleWindows] option to `true`. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebChromeClient#onCreateWindow(android.webkit.WebView,%20boolean,%20boolean,%20android.os.Message) ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wkuidelegate/1536907-webview void onCreateWindow(OnCreateWindowRequest onCreateWindowRequest) {} ///Event fired when javascript calls the `alert()` method to display an alert dialog. ///If [JsAlertResponse.handledByClient] is `true`, the webview will assume that the client will handle the dialog. /// ///[message] represents the message to be displayed in the alert dialog. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebChromeClient#onJsAlert(android.webkit.WebView,%20java.lang.String,%20java.lang.String,%20android.webkit.JsResult) ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wkuidelegate/1537406-webview // ignore: missing_return Future onJsAlert(String message) {} ///Event fired when javascript calls the `confirm()` method to display a confirm dialog. ///If [JsConfirmResponse.handledByClient] is `true`, the webview will assume that the client will handle the dialog. /// ///[message] represents the message to be displayed in the alert dialog. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebChromeClient#onJsConfirm(android.webkit.WebView,%20java.lang.String,%20java.lang.String,%20android.webkit.JsResult) ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wkuidelegate/1536489-webview // ignore: missing_return Future onJsConfirm(String message) {} ///Event fired when javascript calls the `prompt()` method to display a prompt dialog. ///If [JsPromptResponse.handledByClient] is `true`, the webview will assume that the client will handle the dialog. /// ///[message] represents the message to be displayed in the alert dialog. ///[defaultValue] represents the default value displayed in the prompt dialog. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebChromeClient#onJsPrompt(android.webkit.WebView,%20java.lang.String,%20java.lang.String,%20java.lang.String,%20android.webkit.JsPromptResult) ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wkuidelegate/1538086-webview // ignore: missing_return Future onJsPrompt(String message, String defaultValue) {} ///Event fired when the WebView received an HTTP authentication request. The default behavior is to cancel the request. /// ///[challenge] contains data about host, port, protocol, realm, etc. as specified in the [HttpAuthChallenge]. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebViewClient#onReceivedHttpAuthRequest(android.webkit.WebView,%20android.webkit.HttpAuthHandler,%20java.lang.String,%20java.lang.String) ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wknavigationdelegate/1455638-webview // ignore: missing_return Future onReceivedHttpAuthRequest( HttpAuthChallenge challenge) {} ///Event fired when the WebView need to perform server trust authentication (certificate validation). ///The host application must return either [ServerTrustAuthResponse] instance with [ServerTrustAuthResponseAction.CANCEL] or [ServerTrustAuthResponseAction.PROCEED]. /// ///[challenge] contains data about host, port, protocol, realm, etc. as specified in the [ServerTrustChallenge]. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebViewClient#onReceivedSslError(android.webkit.WebView,%20android.webkit.SslErrorHandler,%20android.net.http.SslError) ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wknavigationdelegate/1455638-webview // ignore: missing_return Future onReceivedServerTrustAuthRequest( ServerTrustChallenge challenge) {} ///Notify the host application to handle an SSL client certificate request. ///Webview stores the response in memory (for the life of the application) if [ClientCertResponseAction.PROCEED] or [ClientCertResponseAction.CANCEL] ///is called and does not call [onReceivedClientCertRequest] again for the same host and port pair. ///Note that, multiple layers in chromium network stack might be caching the responses. /// ///[challenge] contains data about host, port, protocol, realm, etc. as specified in the [ClientCertChallenge]. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebViewClient#onReceivedClientCertRequest(android.webkit.WebView,%20android.webkit.ClientCertRequest) ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wknavigationdelegate/1455638-webview // ignore: missing_return Future onReceivedClientCertRequest( ClientCertChallenge challenge) {} ///Event fired as find-on-page operations progress. ///The listener may be notified multiple times while the operation is underway, and the numberOfMatches value should not be considered final unless [isDoneCounting] is true. /// ///[activeMatchOrdinal] represents the zero-based ordinal of the currently selected match. /// ///[numberOfMatches] represents how many matches have been found. /// ///[isDoneCounting] whether the find operation has actually completed. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebView#setFindListener(android.webkit.WebView.FindListener) void onFindResultReceived( int activeMatchOrdinal, int numberOfMatches, bool isDoneCounting) {} ///Event fired when an `XMLHttpRequest` is sent to a server. ///It gives the host application a chance to take control over the request before sending it. /// ///[ajaxRequest] represents the `XMLHttpRequest`. /// ///**NOTE**: In order to be able to listen this event, you need to set [InAppWebViewOptions.useShouldInterceptAjaxRequest] option to `true`. // ignore: missing_return Future shouldInterceptAjaxRequest(AjaxRequest ajaxRequest) {} ///Event fired whenever the `readyState` attribute of an `XMLHttpRequest` changes. ///It gives the host application a chance to abort the request. /// ///[ajaxRequest] represents the [XMLHttpRequest]. /// ///**NOTE**: In order to be able to listen this event, you need to set [InAppWebViewOptions.useShouldInterceptAjaxRequest] option to `true`. // ignore: missing_return Future onAjaxReadyStateChange(AjaxRequest ajaxRequest) {} ///Event fired as an `XMLHttpRequest` progress. ///It gives the host application a chance to abort the request. /// ///[ajaxRequest] represents the [XMLHttpRequest]. /// ///**NOTE**: In order to be able to listen this event, you need to set [InAppWebViewOptions.useShouldInterceptAjaxRequest] option to `true`. // ignore: missing_return Future onAjaxProgress(AjaxRequest ajaxRequest) {} ///Event fired when a request is sent to a server through [Fetch API](https://developer.mozilla.org/it/docs/Web/API/Fetch_API). ///It gives the host application a chance to take control over the request before sending it. /// ///[fetchRequest] represents a resource request. /// ///**NOTE**: In order to be able to listen this event, you need to set [InAppWebViewOptions.useShouldInterceptFetchRequest] option to `true`. // ignore: missing_return Future shouldInterceptFetchRequest(FetchRequest fetchRequest) {} ///Event fired when the host application updates its visited links database. ///This event is also fired when the navigation state of the [InAppWebView] changes through the usage of ///javascript **[History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API)** functions (`pushState()`, `replaceState()`) and `onpopstate` event ///or, also, when the javascript `window.location` changes without reloading the webview (for example appending or modifying an hash to the url). /// ///[url] represents the url being visited. /// ///[androidIsReload] indicates if this url is being reloaded. Available only on Android. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebViewClient#doUpdateVisitedHistory(android.webkit.WebView,%20java.lang.String,%20boolean) void onUpdateVisitedHistory(String url, bool androidIsReload) {} ///Event fired when `window.print()` is called from JavaScript side. /// ///[url] represents the url on which is called. /// ///**NOTE**: available on Android 21+. void onPrint(String url) {} ///Event fired when an HTML element of the webview has been clicked and held. /// ///[hitTestResult] represents the hit result for hitting an HTML elements. /// ///**Official Android API**: https://developer.android.com/reference/android/view/View#setOnLongClickListener(android.view.View.OnLongClickListener) ///**Official iOS API**: https://developer.apple.com/documentation/uikit/uilongpressgesturerecognizer void onLongPressHitTestResult(InAppWebViewHitTestResult hitTestResult) {} ///Event fired when the current page has entered full screen mode. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebChromeClient#onShowCustomView(android.view.View,%20android.webkit.WebChromeClient.CustomViewCallback) ///**Official iOS API**: https://developer.apple.com/documentation/uikit/uiwindow/1621621-didbecomevisiblenotification void onEnterFullscreen() {} ///Event fired when the current page has exited full screen mode. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebChromeClient#onHideCustomView() ///**Official iOS API**: https://developer.apple.com/documentation/uikit/uiwindow/1621617-didbecomehiddennotification void onExitFullscreen() {} ///Called when the web view begins to receive web content. /// ///This event occurs early in the document loading process, and as such ///you should expect that linked resources (for example, CSS and images) may not be available. /// ///[url] represents the URL corresponding to the page navigation that triggered this callback. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebViewClient#onPageCommitVisible(android.webkit.WebView,%20java.lang.String) ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wknavigationdelegate/1455635-webview void onPageCommitVisible(String url) {} ///Event fired when the WebView notifies that a loading URL has been flagged by Safe Browsing. ///The default behavior is to show an interstitial to the user, with the reporting checkbox visible. /// ///[url] represents the url of the request. /// ///[threatType] represents the reason the resource was caught by Safe Browsing, corresponding to a [SafeBrowsingThreat]. /// ///**NOTE**: available only on Android 27+. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebViewClient#onSafeBrowsingHit(android.webkit.WebView,%20android.webkit.WebResourceRequest,%20int,%20android.webkit.SafeBrowsingResponse) // ignore: missing_return Future androidOnSafeBrowsingHit( String url, SafeBrowsingThreat threatType) {} ///Event fired when the WebView is requesting permission to access the specified resources and the permission currently isn't granted or denied. /// ///[origin] represents the origin of the web page which is trying to access the restricted resources. /// ///[resources] represents the array of resources the web content wants to access. /// ///**NOTE**: available only on Android 23+. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebChromeClient#onPermissionRequest(android.webkit.PermissionRequest) // ignore: missing_return Future androidOnPermissionRequest( String origin, List resources) {} ///Event that notifies the host application that web content from the specified origin is attempting to use the Geolocation API, but no permission state is currently set for that origin. ///Note that for applications targeting Android N and later SDKs (API level > `Build.VERSION_CODES.M`) this method is only called for requests originating from secure origins such as https. ///On non-secure origins geolocation requests are automatically denied. /// ///[origin] represents the origin of the web content attempting to use the Geolocation API. /// ///**NOTE**: available only on Android. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebChromeClient#onGeolocationPermissionsShowPrompt(java.lang.String,%20android.webkit.GeolocationPermissions.Callback) Future // ignore: missing_return androidOnGeolocationPermissionsShowPrompt(String origin) {} ///Notify the host application that a request for Geolocation permissions, made with a previous call to [androidOnGeolocationPermissionsShowPrompt] has been canceled. ///Any related UI should therefore be hidden. /// ///**NOTE**: available only on Android. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebChromeClient#onGeolocationPermissionsHidePrompt() void androidOnGeolocationPermissionsHidePrompt() {} ///Notify the host application of a resource request and allow the application to return the data. ///If the return value is `null`, the WebView will continue to load the resource as usual. ///Otherwise, the return response and data will be used. /// ///This callback is invoked for a variety of URL schemes (e.g., `http(s):`, `data:`, `file:`, etc.), ///not only those schemes which send requests over the network. ///This is not called for `javascript:` URLs, `blob:` URLs, or for assets accessed via `file:///android_asset/` or `file:///android_res/` URLs. /// ///In the case of redirects, this is only called for the initial resource URL, not any subsequent redirect URLs. /// ///[request] Object containing the details of the request. /// ///**NOTE**: available only on Android. /// ///**Official Android API**: ///- https://developer.android.com/reference/android/webkit/WebViewClient#shouldInterceptRequest(android.webkit.WebView,%20android.webkit.WebResourceRequest) ///- https://developer.android.com/reference/android/webkit/WebViewClient#shouldInterceptRequest(android.webkit.WebView,%20java.lang.String) Future // ignore: missing_return androidShouldInterceptRequest(WebResourceRequest request) {} ///Event called when the renderer currently associated with the WebView becomes unresponsive as a result of a long running blocking task such as the execution of JavaScript. /// ///If a WebView fails to process an input event, or successfully navigate to a new URL within a reasonable time frame, the renderer is considered to be unresponsive, and this callback will be called. /// ///This callback will continue to be called at regular intervals as long as the renderer remains unresponsive. ///If the renderer becomes responsive again, [androidOnRenderProcessResponsive] will be called once, ///and this method will not subsequently be called unless another period of unresponsiveness is detected. /// ///The minimum interval between successive calls to `androidOnRenderProcessUnresponsive` is 5 seconds. /// ///No action is taken by WebView as a result of this method call. ///Applications may choose to terminate the associated renderer via the object that is passed to this callback, ///if in multiprocess mode, however this must be accompanied by correctly handling [androidOnRenderProcessGone] for this WebView, ///and all other WebViews associated with the same renderer. Failure to do so will result in application termination. /// ///**NOTE**: available only on Android 29+. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebViewRenderProcessClient#onRenderProcessUnresponsive(android.webkit.WebView,%20android.webkit.WebViewRenderProcess) Future // ignore: missing_return androidOnRenderProcessUnresponsive(String url) {} ///Event called once when an unresponsive renderer currently associated with the WebView becomes responsive. /// ///After a WebView renderer becomes unresponsive, which is notified to the application by [androidOnRenderProcessUnresponsive], ///it is possible for the blocking renderer task to complete, returning the renderer to a responsive state. ///In that case, this method is called once to indicate responsiveness. /// ///No action is taken by WebView as a result of this method call. /// ///**NOTE**: available only on Android 29+. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebViewRenderProcessClient#onRenderProcessResponsive(android.webkit.WebView,%20android.webkit.WebViewRenderProcess) Future // ignore: missing_return androidOnRenderProcessResponsive(String url) {} ///Event fired when the given WebView's render process has exited. ///The application's implementation of this callback should only attempt to clean up the WebView. ///The WebView should be removed from the view hierarchy, all references to it should be cleaned up. /// ///[detail] the reason why it exited. /// ///**NOTE**: available only on Android 26+. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebViewClient#onRenderProcessGone(android.webkit.WebView,%20android.webkit.RenderProcessGoneDetail) void androidOnRenderProcessGone(RenderProcessGoneDetail detail) {} ///As the host application if the browser should resend data as the requested page was a result of a POST. The default is to not resend the data. /// ///**NOTE**: available only on Android. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebViewClient#onFormResubmission(android.webkit.WebView,%20android.os.Message,%20android.os.Message) Future // ignore: missing_return androidOnFormResubmission(String url) {} ///Event fired when the scale applied to the WebView has changed. /// ///[oldScale] The old scale factor. /// ///[newScale] The new scale factor. /// ///**NOTE**: available only on Android. /// ///**Official Android API**: https://developer.android.com/reference/android/webkit/WebViewClient#onScaleChanged(android.webkit.WebView,%20float,%20float) void androidOnScaleChanged(double oldScale, double newScale) {} ///Invoked when the web view's web content process is terminated. /// ///**NOTE**: available only on iOS. /// ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wknavigationdelegate/1455639-webviewwebcontentprocessdidtermi void iosOnWebContentProcessDidTerminate() {} ///Called when a web view receives a server redirect. /// ///**NOTE**: available only on iOS. /// ///**Official iOS API**: https://developer.apple.com/documentation/webkit/wknavigationdelegate/1455627-webview void iosOnDidReceiveServerRedirectForProvisionalNavigation() {} void throwIsAlreadyOpened({String message = ''}) { if (this.isOpened()) { throw Exception([ 'Error: ${(message.isEmpty) ? '' : message + ' '}The browser is already opened.' ]); } } void throwIsNotOpened({String message = ''}) { if (!this.isOpened()) { throw Exception([ 'Error: ${(message.isEmpty) ? '' : message + ' '}The browser is not opened.' ]); } } }