From 7477b2c11249d274484e0467bc4af80f3dc4c766 Mon Sep 17 00:00:00 2001 From: "Torne (Richard Coles)" Date: Thu, 3 Mar 2022 13:09:22 -0500 Subject: [PATCH] Update WebSettings useragent docs. Update the WebSettings.setUserAgentString API docs to explicitly specify the effect it has on user agent client hints and related JS APIs. This is not a behaviour change for WebView, just making the docs describe what already happens. Test: make offline-sdk-docs Change-Id: I2db282efc4ee42b931824175abe627e871c4a86c --- core/java/android/webkit/WebSettings.java | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/core/java/android/webkit/WebSettings.java b/core/java/android/webkit/WebSettings.java index 40b38c0d0c6a2..3160057e062f2 100644 --- a/core/java/android/webkit/WebSettings.java +++ b/core/java/android/webkit/WebSettings.java @@ -1366,7 +1366,10 @@ public abstract class WebSettings { * Sets the WebView's user-agent string. If the string is {@code null} or empty, * the system default value will be used. * - * Note that starting from {@link android.os.Build.VERSION_CODES#KITKAT} Android + *

If the user-agent is overridden in this way, the values of the User-Agent Client Hints + * headers and {@code navigator.userAgentData} for this WebView will be empty. + * + *

Note that starting from {@link android.os.Build.VERSION_CODES#KITKAT} Android * version, changing the user-agent while loading a web page causes WebView * to initiate loading once again. *