WebChromeClient.OnJsAlert(WebView, String, String, JsResult) Method

Reference

Definition

Namespace:: Android.Webkit

Assembly:: Mono.Android.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Notify the host application that the web page wants to display a JavaScript alert() dialog.

[Android.Runtime.Register("onJsAlert", "(Landroid/webkit/WebView;Ljava/lang/String;Ljava/lang/String;Landroid/webkit/JsResult;)Z", "GetOnJsAlert_Landroid_webkit_WebView_Ljava_lang_String_Ljava_lang_String_Landroid_webkit_JsResult_Handler")]
public virtual bool OnJsAlert (Android.Webkit.WebView? view, string? url, string? message, Android.Webkit.JsResult? result);

[<Android.Runtime.Register("onJsAlert", "(Landroid/webkit/WebView;Ljava/lang/String;Ljava/lang/String;Landroid/webkit/JsResult;)Z", "GetOnJsAlert_Landroid_webkit_WebView_Ljava_lang_String_Ljava_lang_String_Landroid_webkit_JsResult_Handler")>]
abstract member OnJsAlert : Android.Webkit.WebView * string * string * Android.Webkit.JsResult -> bool
override this.OnJsAlert : Android.Webkit.WebView * string * string * Android.Webkit.JsResult -> bool

Parameters

view: WebView

The WebView that initiated the callback.

url: String

The url of the page requesting the dialog.

message: String

Message to be displayed in the window.

result: JsResult

A JsResult to confirm that the user closed the window.

Returns

Boolean

boolean true if the request is handled or ignored. false if WebView needs to show the default dialog.

Attributes: RegisterAttribute

Remarks

Notify the host application that the web page wants to display a JavaScript alert() dialog.

The default behavior if this method returns false or is not overridden is to show a dialog containing the alert message and suspend JavaScript execution until the dialog is dismissed.

To show a custom dialog, the app should return true from this method, in which case the default dialog will not be shown and JavaScript execution will be suspended. The app should call JsResult.confirm() when the custom dialog is dismissed such that JavaScript execution can be resumed.

To suppress the dialog and allow JavaScript execution to continue, call JsResult.confirm() immediately and then return true.

Note that if the WebChromeClient is set to be null, or if WebChromeClient is not set at all, the default dialog will be suppressed and Javascript execution will continue immediately.

Note that the default dialog does not inherit the android.view.Display#FLAG_SECURE flag from the parent window.

Java documentation for android.webkit.WebChromeClient.onJsAlert(android.webkit.WebView, java.lang.String, java.lang.String, android.webkit.JsResult).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to