RFR: 8267858: Document that title property in WebEngine gets updated asynchronously

[Johan Vos]

On Thu, 27 May 2021 17:25:27 GMT, Arun Joseph <ajoseph at openjdk.org> wrote:

> The title property is not guaranteed to be updated right after the page is loaded, but gets updated asynchronously.

modules/javafx.web/src/main/java/javafx/scene/web/WebEngine.java line 441:

> 439: 
> 440:     /*
> 441:      * The page title. This gets updated asynchronously.

Is there any more information or guarantee when the update is expected to be complete, or is it truly asynchronous? I we know that this will happen between the current pulse and the next one, that might be helpful to developers (although I agree waiting for the titleProperty to be changed is the better approach).
If there is no link beween the webkit thread that gets the title and the quantum renderer, it is really asynchronous and in that case tricks like waiting for a few pulses won't help either -- but it would be good to mention that so that developers don't create workarounds that might work in some cases and fail in others.

-------------

PR: https://git.openjdk.java.net/jfx/pull/522