Share via


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

Definition

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 true if the request is handled or ignored. false if WebView needs to show the default dialog.

Attributes

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