Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit db010230 authored by Nate Fischer's avatar Nate Fischer
Browse files

WebView: clarify shouldInterceptRequest docs 

No change to logic, this only changes documentation.

This clarifies how shouldInterceptRequest behaves for various URL
schemes as well as other edge cases (e.g., redirects).

Bug: 74841041
Test: make docs (manually verify)
Change-Id: Id59033590ea6025a00ae39c7b05486be082973e7
parent dcccfd97

core/java/android/webkit/WebViewClient.java

+16 −0
Original line number Diff line number Diff line
@@ -152,6 +152,14 @@ public class WebViewClient { 
     * will continue to load the resource as usual.  Otherwise, the return

     * response and data will be used.

     *

     * <p>This callback is invoked for a variety of URL schemes (e.g., {@code http(s):}, {@code

     * data:}, {@code file:}, etc.), not only those schemes which send requests over the network.

     * This is not called for {@code javascript:} URLs, {@code blob:} URLs, or for assets accessed

     * via {@code file:///android_asset/} or {@code file:///android_res/} URLs.

     *

     * <p>In the case of redirects, this is only called for the initial resource URL, not any

     * subsequent redirect URLs.

     *

     * <p class="note"><b>Note:</b> This method is called on a thread

     * other than the UI thread so clients should exercise caution

     * when accessing private data or the view system.
@@ -182,6 +190,14 @@ public class WebViewClient { 
     * will continue to load the resource as usual.  Otherwise, the return

     * response and data will be used.

     *

     * <p>This callback is invoked for a variety of URL schemes (e.g., {@code http(s):}, {@code

     * data:}, {@code file:}, etc.), not only those schemes which send requests over the network.

     * This is not called for {@code javascript:} URLs, {@code blob:} URLs, or for assets accessed

     * via {@code file:///android_asset/} or {@code file:///android_res/} URLs.

     *

     * <p>In the case of redirects, this is only called for the initial resource URL, not any

     * subsequent redirect URLs.

     *

     * <p class="note"><b>Note:</b> This method is called on a thread

     * other than the UI thread so clients should exercise caution

     * when accessing private data or the view system.