From ce222afda74698f7435155fd9064fc44cd002478 Mon Sep 17 00:00:00 2001 From: Shimi Zhang Date: Fri, 22 Feb 2019 17:47:28 -0800 Subject: [PATCH] onPageFinished javadoc cleanup PictureListener was deprecated, we need to replace its mentioning in onPageFinished() javadoc with postVisualStateCallback(). Bug: 125939241 Test: make ds-docs Change-Id: I7c1641c86632bb6c8214fd701e052096952deeec --- core/java/android/webkit/WebViewClient.java | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/core/java/android/webkit/WebViewClient.java b/core/java/android/webkit/WebViewClient.java index a29d449665404..26c21753a23f9 100644 --- a/core/java/android/webkit/WebViewClient.java +++ b/core/java/android/webkit/WebViewClient.java @@ -102,9 +102,11 @@ public class WebViewClient { /** * Notify the host application that a page has finished loading. This method - * is called only for main frame. When onPageFinished() is called, the - * rendering picture may not be updated yet. To get the notification for the - * new Picture, use {@link WebView.PictureListener#onNewPicture}. + * is called only for main frame. Receiving an {@code onPageFinished()} callback does not + * guarantee that the next frame drawn by WebView will reflect the state of the DOM at this + * point. In order to be notified that the current DOM state is ready to be rendered, request a + * visual state callback with {@link WebView#postVisualStateCallback} and wait for the supplied + * callback to be triggered. * * @param view The WebView that is initiating the callback. * @param url The url of the page.