Added in API level 1

WebViewDatabase


abstract class WebViewDatabase
kotlin.Any
   ↳ android.webkit.WebViewDatabase

This class allows developers to determine whether any WebView used in the application has stored any of the following types of browsing data and to clear any such stored data for all WebViews in the application.

  • Username/password pairs for web forms
  • HTTP authentication username/password pairs
  • Data entered into text fields (e.g. for autocomplete suggestions)

Summary

Public constructors

Public methods
abstract Unit

Clears any saved data for web forms.

abstract Unit

Clears any saved credentials for HTTP authentication.

abstract Unit

Clears any saved username/password pairs for web forms.

abstract Array<String!>?

Retrieves HTTP authentication credentials for a given host and realm from the WebViewDatabase instance.

open static WebViewDatabase!
getInstance(context: Context!)

abstract Boolean

Gets whether there is any saved data for web forms.

abstract Boolean

Gets whether there are any saved credentials for HTTP authentication.

abstract Boolean

Gets whether there are any saved username/password pairs for web forms.

abstract Unit
setHttpAuthUsernamePassword(host: String!, realm: String!, username: String!, password: String!)

Stores HTTP authentication credentials for a given host and realm to the WebViewDatabase instance.

Public constructors

WebViewDatabase

Added in API level 22
WebViewDatabase()

Deprecated: This class should not be constructed by applications, use getInstance(android.content.Context) instead to fetch the singleton instance.

Public methods

clearFormData

Added in API level 1
Deprecated in API level 26
abstract fun clearFormData(): Unit

Deprecated: Deprecated in Java.

Clears any saved data for web forms.

See Also

clearHttpAuthUsernamePassword

Added in API level 1
abstract fun clearHttpAuthUsernamePassword(): Unit

Clears any saved credentials for HTTP authentication. This method only clears the username and password stored in WebViewDatabase instance. The username and password are not read from the WebViewDatabase during WebViewClient#onReceivedHttpAuthRequest. It is up to the app to do this or not.

The username and password used for http authentication might be cached in the network stack itself, and are not cleared when this method is called. WebView does not provide a special mechanism to clear HTTP authentication for implementing client logout. The client logout mechanism should be implemented by the Web site designer (such as server sending a HTTP 401 for invalidating credentials).

clearUsernamePassword

Added in API level 1
Deprecated in API level 18
abstract fun clearUsernamePassword(): Unit

Deprecated: Saving passwords in WebView will not be supported in future versions.

Clears any saved username/password pairs for web forms. Note that these are unrelated to HTTP authentication credentials.

getHttpAuthUsernamePassword

Added in API level 26
abstract fun getHttpAuthUsernamePassword(
    host: String!,
    realm: String!
): Array<String!>?

Retrieves HTTP authentication credentials for a given host and realm from the WebViewDatabase instance.

Parameters
host String!: the host to which the credentials apply
realm String!: the realm to which the credentials apply
Return
Array<String!>? the credentials as a String array, if found. The first element is the username and the second element is the password. null if no credentials are found.

getInstance

Added in API level 1
open static fun getInstance(context: Context!): WebViewDatabase!

hasFormData

Added in API level 1
Deprecated in API level 26
abstract fun hasFormData(): Boolean

Deprecated: Deprecated in Java.

Gets whether there is any saved data for web forms.

Return
Boolean whether there is any saved data for web forms

See Also

hasHttpAuthUsernamePassword

Added in API level 1
abstract fun hasHttpAuthUsernamePassword(): Boolean

Gets whether there are any saved credentials for HTTP authentication.

Return
Boolean whether there are any saved credentials

hasUsernamePassword

Added in API level 1
Deprecated in API level 18
abstract fun hasUsernamePassword(): Boolean

Deprecated: Saving passwords in WebView will not be supported in future versions.

Gets whether there are any saved username/password pairs for web forms. Note that these are unrelated to HTTP authentication credentials.

Return
Boolean true if there are any saved username/password pairs

setHttpAuthUsernamePassword

Added in API level 26
abstract fun setHttpAuthUsernamePassword(
    host: String!,
    realm: String!,
    username: String!,
    password: String!
): Unit

Stores HTTP authentication credentials for a given host and realm to the WebViewDatabase instance.

To use HTTP authentication, the embedder application has to implement WebViewClient#onReceivedHttpAuthRequest, and call HttpAuthHandler#proceed with the correct username and password.

The embedder app can get the username and password any way it chooses, and does not have to use WebViewDatabase.

Notes:

  • WebViewDatabase is provided only as a convenience to store and retrieve http authentication credentials. WebView does not read from it during HTTP authentication.
  • WebView does not provide a special mechanism to clear HTTP authentication credentials for implementing client logout. The client logout mechanism should be implemented by the Web site designer (such as server sending a HTTP 401 for invalidating credentials).
  • Parameters
    host String!: the host to which the credentials apply
    realm String!: the realm to which the credentials apply
    username String!: the username
    password String!: the password