Summary

Document that title property in WebEngine gets updated asynchronously.

Problem

The title property is not guaranteed to be updated right after the page is loaded, but gets updated asynchronously. This may cause getTitle() to return empty string instead of the title of the page when called just after the page is loaded.

Solution

Update the WebEngine javadoc mentioning that the value gets updated asynchronously.

Specification

Changed the javadoc of javafx.scene.web.WebEngine::titleProperty to:

     /**
      * Title of the current Web page. If the current page has no title,
-     * the value is {@code null}.
+     * the value is {@code null}. This property will be updated
+     * asynchronously some time after the page is loaded. Applications
+     * should not rely on any particular timing, but should listen for
+     * changes to this property, or bind to it, to know when it has
+     * been updated.
      *
      * @return the title property
      */