WebEngine

java.lang.Object
- javafx.scene.web.WebEngine

public final class WebEngine
extends java.lang.Object

WebEngine is a non-visual object capable of managing one Web page at a time. It loads Web pages, creates their document models, applies styles as necessary, and runs JavaScript on pages. It provides access to the document model of the current page, and enables two-way communication between a Java application and JavaScript code of the page.

Loading Web Pages

The WebEngine class provides two ways to load content into a WebEngine object:

From an arbitrary URL using the load(java.lang.String) method. This method uses the java.net package for network access and protocol handling.
From an in-memory String using the loadContent(java.lang.String, java.lang.String) and loadContent(java.lang.String) methods.

Loading always happens on a background thread. Methods that initiate loading return immediately after scheduling a background job. To track progress and/or cancel a job, use the javafx.concurrent.Worker instance available from the getLoadWorker() method.

The following example changes the stage title when loading completes successfully:


    import javafx.concurrent.Worker.State;
    final Stage stage;
    webEngine.getLoadWorker().stateProperty().addListener(
        new ChangeListener<State>() {
            public void changed(ObservableValue ov, State oldState, State newState) {
                if (newState == State.SUCCEEDED) {
                    stage.setTitle(webEngine.getLocation());
                }
            }
        });
    webEngine.load("http://javafx.com");

User Interface Callbacks

A number of user interface callbacks may be registered with a WebEngine object. These callbacks are invoked when a script running on the page requests a user interface operation to be performed, for example, opens a popup window or changes status text. A WebEngine object cannot handle such requests internally, so it passes the request to the corresponding callbacks. If no callback is defined for a specific operation, the request is silently ignored.

The table below shows JavaScript user interface methods and properties with their corresponding WebEngine callbacks:

JavaScript Callback Table
JavaScript method/property	WebEngine callback
`window.alert()`	`onAlert`
`window.confirm()`	`confirmHandler`
`window.open()`	`createPopupHandler`
`window.open()` and `window.close()`	`onVisibilityChanged`
`window.prompt()`	`promptHandler`
Setting `window.status`	`onStatusChanged`
Setting any of the following: `window.innerWidth`, `window.innerHeight`, `window.outerWidth`, `window.outerHeight`, `window.screenX`, `window.screenY`, `window.screenLeft`, `window.screenTop`	`onResized`

The following example shows a callback that resizes a browser window:


    Stage stage;
    webEngine.setOnResized(
        new EventHandler<WebEvent<Rectangle2D>>() {
            public void handle(WebEvent<Rectangle2D> ev) {
                Rectangle2D r = ev.getData();
                stage.setWidth(r.getWidth());
                stage.setHeight(r.getHeight());
            }
        });

Access to Document Model

The WebEngine objects create and manage a Document Object Model (DOM) for their Web pages. The model can be accessed and modified using Java DOM Core classes. The getDocument() method provides access to the root of the model. Additionally DOM Event specification is supported to define event handlers in Java code.

The following example attaches a Java event listener to an element of a Web page. Clicking on the element causes the application to exit:


    EventListener listener = new EventListener() {
        public void handleEvent(Event ev) {
            Platform.exit();
        }
    };

    Document doc = webEngine.getDocument();
    Element el = doc.getElementById("exit-app");
    ((EventTarget) el).addEventListener("click", listener, false);

Evaluating JavaScript expressions

It is possible to execute arbitrary JavaScript code in the context of the current page using the executeScript(java.lang.String) method. For example:


    webEngine.executeScript("history.back()");

The execution result is returned to the caller, as described in the next section.

Mapping JavaScript values to Java objects

JavaScript values are represented using the obvious Java classes: null becomes Java null; a boolean becomes a java.lang.Boolean; and a string becomes a java.lang.String. A number can be java.lang.Double or a java.lang.Integer, depending. The undefined value maps to a specific unique String object whose value is "undefined".

If the result is a JavaScript object, it is wrapped as an instance of the netscape.javascript.JSObject class. (As a special case, if the JavaScript object is a JavaRuntimeObject as discussed in the next section, then the original Java object is extracted instead.) The JSObject class is a proxy that provides access to methods and properties of its underlying JavaScript object. The most commonly used JSObject methods are getMember (to read a named property), setMember (to set or define a property), and call (to call a function-valued property).

A DOM Node is mapped to an object that both extends JSObject and implements the appropriate DOM interfaces. To get a JSObject object for a Node just do a cast:

 JSObject jdoc = (JSObject) webEngine.getDocument();

In some cases the context provides a specific Java type that guides the conversion. For example if setting a Java String field from a JavaScript expression, then the JavaScript value is converted to a string.

Mapping Java objects to JavaScript values

The arguments of the JSObject methods setMember and call pass Java objects to the JavaScript environment. This is roughly the inverse of the JavaScript-to-Java mapping described above: Java String, Number, or Boolean objects are converted to the obvious JavaScript values. A JSObject object is converted to the original wrapped JavaScript object. Otherwise a JavaRuntimeObject is created. This is a JavaScript object that acts as a proxy for the Java object, in that accessing properties of the JavaRuntimeObject causes the Java field or method with the same name to be accessed.

Note that the Java objects bound using JSObject.setMember, JSObject.setSlot, and JSObject.call are implemented using weak references. This means that the Java object can be garbage collected, causing subsequent accesses to the JavaScript objects to have no effect.

Calling back to Java from JavaScript

The JSObject.setMember method is useful to enable upcalls from JavaScript into Java code, as illustrated by the following example. The Java code establishes a new JavaScript object named app. This object has one public member, the method exit.


public class JavaApplication {
    public void exit() {
        Platform.exit();
    }
}
...
JavaApplication javaApp = new JavaApplication();
JSObject window = (JSObject) webEngine.executeScript("window");
window.setMember("app", javaApp);

You can then refer to the object and the method from your HTML page:


    <a href="" onclick="app.exit()">Click here to exit application</a>

When a user clicks the link the application is closed.

Note that in the above example, the application holds a reference to the JavaApplication instance. This is required for the callback from JavaScript to execute the desired method.

In the following example, the application does not hold a reference to the Java object:


 JSObject window = (JSObject) webEngine.executeScript("window");
 window.setMember("app", new JavaApplication());

In this case, since the property value is a local object, "new JavaApplication()", the value may be garbage collected in next GC cycle.

When a user clicks the link, it does not guarantee to execute the callback method exit.

If there are multiple Java methods with the given name, then the engine selects one matching the number of parameters in the call. (Varargs are not handled.) An unspecified one is chosen if there are multiple ones with the correct number of parameters.

You can pick a specific overloaded method by listing the parameter types in an "extended method name", which has the form "method_name(param_type1,...,param_typen)". Typically you'd write the JavaScript expression:

 receiver["method_name(param_type1,...,param_typeN)"](arg1,...,argN)

The Java class and method must both be declared public.

Deploying an Application as a Module

If any Java class passed to JavaScript is in a named module, then it must be reflectively accessible to the javafx.web module. A class is reflectively accessible if the module opens the containing package to at least the javafx.web module. Otherwise, the method will not be called, and no error or warning will be produced.

For example, if com.foo.MyClass is in the foo.app module, the module-info.java might look like this:

 module foo.app {
    opens com.foo to javafx.web;
}

Alternatively, a class is reflectively accessible if the module exports the containing package unconditionally.

Threading

WebEngine objects must be created and accessed solely from the JavaFX Application thread. This rule also applies to any DOM and JavaScript objects obtained from the WebEngine object.

Since:: JavaFX 2.0

Property Summary

All Methods Instance Methods Concrete Methods
Type	Property and Description
`<any>`	`confirmHandler` JavaScript `confirm` handler property.
`<any>`	`createPopupHandler` JavaScript popup handler property.
`<any>`	`document` Document object for the current Web page.
`BooleanProperty`	`javaScriptEnabled` Specifies whether JavaScript execution is enabled.
`ReadOnlyStringProperty`	`location` URL of the current Web page.
`<any>`	`onAlert` JavaScript `alert` handler property.
`<any>`	`onError` The event handler called when an error occurs.
`<any>`	`onResized` JavaScript window resize handler property.
`<any>`	`onStatusChanged` JavaScript status handler property.
`<any>`	`onVisibilityChanged` JavaScript window visibility handler property.
`<any>`	`promptHandler` JavaScript `prompt` handler property.
`ReadOnlyStringProperty`	`title` Title of the current Web page.
`StringProperty`	`userAgent` Specifies user agent ID string.
`<any>`	`userDataDirectory` Specifies the directory to be used by this `WebEngine` to store local user data.
`StringProperty`	`userStyleSheetLocation` Location of the user stylesheet as a string URL.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`private static class`	`WebEngine.AccessorImpl`
`private class`	`WebEngine.DebuggerImpl` The debugger implementation.
`private class`	`WebEngine.DocumentProperty`
`private static class`	`WebEngine.InspectorClientImpl` The inspector client implementation.
`private class`	`WebEngine.LoadWorker`
`private static class`	`WebEngine.PageLoadListener` The page load event listener.
`private static class`	`WebEngine.PulseTimer` Drives the `Timer` when `Timer.Mode.PLATFORM_TICKS` is set.
`private static class`	`WebEngine.SelfDisposer`

Field Summary

Fields
Modifier and Type	Field and Description
`private <any>`	`confirmHandler`
`private <any>`	`createPopupHandler`
`private WebEngine.DebuggerImpl`	`debugger`
`private WebEngine.SelfDisposer`	`disposer`
`private WebEngine.DocumentProperty`	`document`
`private WebHistory`	`history`
`private static int`	`instanceCount` The number of instances of this class.
`private BooleanProperty`	`javaScriptEnabled` Specifies whether JavaScript execution is enabled.
`private WebEngine.LoadWorker`	`loadWorker` The Worker which shows progress of the web engine as it loads pages.
`private ReadOnlyStringWrapper`	`location`
`private static PlatformLogger`	`logger`
`private <any>`	`onAlert`
`private <any>`	`onError` The event handler called when an error occurs.
`private <any>`	`onResized`
`private <any>`	`onStatusChanged`
`private <any>`	`onVisibilityChanged`
`private WebPage`	`page` The object that provides interaction with the native webkit core.
`private <any>`	`promptHandler`
`private ReadOnlyStringWrapper`	`title`
`private StringProperty`	`userAgent` Specifies user agent ID string.
`private <any>`	`userDataDirectory` Specifies the directory to be used by this `WebEngine` to store local user data.
`private boolean`	`userDataDirectoryApplied`
`private StringProperty`	`userStyleSheetLocation` Location of the user stylesheet as a string URL.
`private <any>`	`view` The node associated with this engine.

Constructor Summary

Constructors
Modifier	Constructor and Description
	`WebEngine()` Creates a new engine.
	`WebEngine(java.lang.String url)` Creates a new engine and loads a Web page into it.
`private`	`WebEngine(java.lang.String url, boolean callLoad)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`private void`	`applyUserDataDirectory()`
`(package private) static void`	`checkThread()`
`<any>`	`confirmHandlerProperty()` JavaScript `confirm` handler property.
`private static void`	`createDirectories(java.io.File directory)`
`<any>`	`createPopupHandlerProperty()` JavaScript popup handler property.
`private static java.io.File`	`defaultUserDataDirectory()`
`(package private) void`	`dispose()`
`<any>`	`documentProperty()` Document object for the current Web page.
`java.lang.Object`	`executeScript(java.lang.String script)` Executes a script in the context of the current page.
`private void`	`fireError(<any> eventType, java.lang.String message, java.lang.Throwable exception)`
`<any>`	`getConfirmHandler()` Gets the value of the property confirmHandler.
`<any>`	`getCreatePopupHandler()` Gets the value of the property createPopupHandler.
`(package private) Debugger`	`getDebugger()`
`org.w3c.dom.Document`	`getDocument()` Gets the value of the property document.
`WebHistory`	`getHistory()` Returns the session history object.
`<any>`	`getLoadWorker()` Returns a `javafx.concurrent.Worker` object that can be used to track loading progress.
`java.lang.String`	`getLocation()` Gets the value of the property location.
`private long`	`getMainFrame()`
`<any>`	`getOnAlert()` Gets the value of the property onAlert.
`<any>`	`getOnError()` Gets the value of the property onError.
`<any>`	`getOnResized()` Gets the value of the property onResized.
`<any>`	`getOnStatusChanged()` Gets the value of the property onStatusChanged.
`<any>`	`getOnVisibilityChanged()` Gets the value of the property onVisibilityChanged.
`(package private) WebPage`	`getPage()`
`<any>`	`getPromptHandler()` Gets the value of the property promptHandler.
`java.lang.String`	`getTitle()` Gets the value of the property title.
`java.lang.String`	`getUserAgent()` Gets the value of the property userAgent.
`java.io.File`	`getUserDataDirectory()` Gets the value of the property userDataDirectory.
`java.lang.String`	`getUserStyleSheetLocation()` Gets the value of the property userStyleSheetLocation.
`boolean`	`isJavaScriptEnabled()` Gets the value of the property javaScriptEnabled.
`BooleanProperty`	`javaScriptEnabledProperty()` Specifies whether JavaScript execution is enabled.
`void`	`load(java.lang.String url)` Loads a Web page into this engine.
`void`	`loadContent(java.lang.String content)` Loads the given HTML content directly.
`void`	`loadContent(java.lang.String content, java.lang.String contentType)` Loads the given content directly.
`ReadOnlyStringProperty`	`locationProperty()` URL of the current Web page.
`<any>`	`onAlertProperty()` JavaScript `alert` handler property.
`<any>`	`onErrorProperty()` The event handler called when an error occurs.
`<any>`	`onResizedProperty()` JavaScript window resize handler property.
`<any>`	`onStatusChangedProperty()` JavaScript status handler property.
`<any>`	`onVisibilityChangedProperty()` JavaScript window visibility handler property.
`void`	`print(PrinterJob job)` Prints the current Web page using the given printer job.
`private static boolean`	`printStatusOK(PrinterJob job)`
`<any>`	`promptHandlerProperty()` JavaScript `prompt` handler property.
`private byte[]`	`readFully(java.io.BufferedInputStream in)`
`void`	`reload()` Reloads the current page, whether loaded from URL or directly from a String in one of the `loadContent` methods.
`void`	`setConfirmHandler(<any> handler)` Sets the value of the property confirmHandler.
`void`	`setCreatePopupHandler(<any> handler)` Sets the value of the property createPopupHandler.
`void`	`setJavaScriptEnabled(boolean value)` Sets the value of the property javaScriptEnabled.
`void`	`setOnAlert(<any> handler)` Sets the value of the property onAlert.
`void`	`setOnError(<any> handler)` Sets the value of the property onError.
`void`	`setOnResized(<any> handler)` Sets the value of the property onResized.
`void`	`setOnStatusChanged(<any> handler)` Sets the value of the property onStatusChanged.
`void`	`setOnVisibilityChanged(<any> handler)` Sets the value of the property onVisibilityChanged.
`void`	`setPromptHandler(<any> handler)` Sets the value of the property promptHandler.
`void`	`setUserAgent(java.lang.String value)` Sets the value of the property userAgent.
`void`	`setUserDataDirectory(java.io.File value)` Sets the value of the property userDataDirectory.
`void`	`setUserStyleSheetLocation(java.lang.String value)` Sets the value of the property userStyleSheetLocation.
`(package private) void`	`setView(WebView view)`
`private void`	`stop()`
`ReadOnlyStringProperty`	`titleProperty()` Title of the current Web page.
`private void`	`updateLocation(java.lang.String value)`
`private void`	`updateTitle()`
`StringProperty`	`userAgentProperty()` Specifies user agent ID string.
`<any>`	`userDataDirectoryProperty()` Specifies the directory to be used by this `WebEngine` to store local user data.
`StringProperty`	`userStyleSheetLocationProperty()` Location of the user stylesheet as a string URL.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Property Detail
  - document
```
public final <any> documentProperty
```
    Document object for the current Web page. The value is null if the Web page failed to load.
    
    See Also:
    
    getDocument()
  - location
```
public final ReadOnlyStringProperty locationProperty
```
    URL of the current Web page. If the current page has no URL, the value is an empty String.
    
    See Also:
    
    getLocation()
  - title
```
public final ReadOnlyStringProperty titleProperty
```
    Title of the current Web page. If the current page has no title, the value is null.
    
    See Also:
    
    getTitle()
  - javaScriptEnabled
```
public final BooleanProperty javaScriptEnabledProperty
```
    Specifies whether JavaScript execution is enabled.
    
    Since:
    
    JavaFX 2.2
    
    See Also:
    
    isJavaScriptEnabled(), setJavaScriptEnabled(boolean)
  - userStyleSheetLocation
```
public final StringProperty userStyleSheetLocationProperty
```
    Location of the user stylesheet as a string URL.
    This should be a local URL, i.e. either 'data:', 'file:', or 'jar:'. Remote URLs are not allowed for security reasons.
    
    Since:
    
    JavaFX 2.2
    
    See Also:
    
    getUserStyleSheetLocation(), setUserStyleSheetLocation(String)
  - userDataDirectory
```
public final <any> userDataDirectoryProperty
```
    Specifies the directory to be used by this WebEngine to store local user data.
    If the value of this property is not null, the WebEngine will attempt to store local user data in the respective directory. If the value of this property is null, the WebEngine will attempt to store local user data in an automatically selected system-dependent user- and application-specific directory.
    When a WebEngine is about to start loading a web page or executing a script for the first time, it checks whether it can actually use the directory specified by this property. If the check fails for some reason, the WebEngine invokes the WebEngine.onError event handler, if any, with a WebErrorEvent describing the reason. If the invoked event handler modifies the userDataDirectory property, the WebEngine retries with the new value as soon as the handler returns. If the handler does not modify the userDataDirectory property (which is the default), the WebEngine continues without local user data.
    Once the WebEngine has started loading a web page or executing a script, changes made to this property have no effect on where the WebEngine stores or will store local user data.
    Currently, the directory specified by this property is used only to store the data that backs the window.localStorage objects. In the future, more types of data can be added.
    
    Since:
    
    JavaFX 8.0
    
    See Also:
    
    getUserDataDirectory(), setUserDataDirectory(File)
  - userAgent
```
public final StringProperty userAgentProperty
```
    Specifies user agent ID string. This string is the value of the User-Agent HTTP header.
    
    Since:
    
    JavaFX 8.0
    
    See Also:
    
    getUserAgent(), setUserAgent(String)
  - onAlert
```
public final <any> onAlertProperty
```
    JavaScript alert handler property. This handler is invoked when a script running on the Web page calls the alert function.
    
    See Also:
    
    getOnAlert(), #setOnAlert()
  - onStatusChanged
```
public final <any> onStatusChangedProperty
```
    JavaScript status handler property. This handler is invoked when a script running on the Web page sets window.status property.
    
    See Also:
    
    getOnStatusChanged(), #setOnStatusChanged()
  - onResized
```
public final <any> onResizedProperty
```
    JavaScript window resize handler property. This handler is invoked when a script running on the Web page moves or resizes the window object.
    
    See Also:
    
    getOnResized(), #setOnResized()
  - onVisibilityChanged
```
public final <any> onVisibilityChangedProperty
```
    JavaScript window visibility handler property. This handler is invoked when a script running on the Web page changes visibility of the window object.
    
    See Also:
    
    getOnVisibilityChanged(), #setOnVisibilityChanged()
  - createPopupHandler
```
public final <any> createPopupHandlerProperty
```
    JavaScript popup handler property. This handler is invoked when a script running on the Web page requests a popup to be created.
    To satisfy this request a handler may create a new WebEngine, attach a visibility handler and optionally a resize handler, and return the newly created engine. To block the popup, a handler should return null.
    By default, a popup handler is installed that opens popups in this WebEngine.
    
    See Also:
    
    getCreatePopupHandler(), #setCreatePopupHandler()
  - confirmHandler
```
public final <any> confirmHandlerProperty
```
    JavaScript confirm handler property. This handler is invoked when a script running on the Web page calls the confirm function.
    An implementation may display a dialog box with Yes and No options, and return the user's choice.
    
    See Also:
    
    getConfirmHandler(), #setConfirmHandler()
  - promptHandler
```
public final <any> promptHandlerProperty
```
    JavaScript prompt handler property. This handler is invoked when a script running on the Web page calls the prompt function.
    An implementation may display a dialog box with an text field, and return the user's input.
    
    See Also:
    
    getPromptHandler(), #setPromptHandler()
  - onError
```
public final <any> onErrorProperty
```
    The event handler called when an error occurs.
    
    Since:
    
    JavaFX 8.0
    
    See Also:
    
    getOnError(), #setOnError()
- Field Detail
  - logger
```
private static final PlatformLogger logger
```
  - instanceCount
```
private static int instanceCount
```
    The number of instances of this class. Used to start and stop the pulse timer.
  - view
```
private final <any> view
```
    The node associated with this engine. There is a one-to-one correspondence between the WebView and its WebEngine (although not all WebEngines have a WebView, every WebView has one and only one WebEngine).
  - loadWorker
```
private final WebEngine.LoadWorker loadWorker
```
    The Worker which shows progress of the web engine as it loads pages.
  - page
```
private final WebPage page
```
    The object that provides interaction with the native webkit core.
  - disposer
```
private final WebEngine.SelfDisposer disposer
```
  - debugger
```
private final WebEngine.DebuggerImpl debugger
```
  - userDataDirectoryApplied
```
private boolean userDataDirectoryApplied
```
  - document
```
private final WebEngine.DocumentProperty document
```
  - location
```
private final ReadOnlyStringWrapper location
```
  - title
```
private final ReadOnlyStringWrapper title
```
  - javaScriptEnabled
```
private BooleanProperty javaScriptEnabled
```
    Specifies whether JavaScript execution is enabled.
    
    Since:
    
    JavaFX 2.2
  - userStyleSheetLocation
```
private StringProperty userStyleSheetLocation
```
    Location of the user stylesheet as a string URL.
    This should be a local URL, i.e. either 'data:', 'file:', or 'jar:'. Remote URLs are not allowed for security reasons.
    
    Since:
    
    JavaFX 2.2
  - userDataDirectory
```
private final <any> userDataDirectory
```
    Specifies the directory to be used by this WebEngine to store local user data.
    If the value of this property is not null, the WebEngine will attempt to store local user data in the respective directory. If the value of this property is null, the WebEngine will attempt to store local user data in an automatically selected system-dependent user- and application-specific directory.
    When a WebEngine is about to start loading a web page or executing a script for the first time, it checks whether it can actually use the directory specified by this property. If the check fails for some reason, the WebEngine invokes the WebEngine.onError event handler, if any, with a WebErrorEvent describing the reason. If the invoked event handler modifies the userDataDirectory property, the WebEngine retries with the new value as soon as the handler returns. If the handler does not modify the userDataDirectory property (which is the default), the WebEngine continues without local user data.
    Once the WebEngine has started loading a web page or executing a script, changes made to this property have no effect on where the WebEngine stores or will store local user data.
    Currently, the directory specified by this property is used only to store the data that backs the window.localStorage objects. In the future, more types of data can be added.
    
    Since:
    
    JavaFX 8.0
  - userAgent
```
private StringProperty userAgent
```
    Specifies user agent ID string. This string is the value of the User-Agent HTTP header.
    
    Since:
    
    JavaFX 8.0
  - onAlert
```
private final <any> onAlert
```
  - onStatusChanged
```
private final <any> onStatusChanged
```
  - onResized
```
private final <any> onResized
```
  - onVisibilityChanged
```
private final <any> onVisibilityChanged
```
  - createPopupHandler
```
private final <any> createPopupHandler
```
  - confirmHandler
```
private final <any> confirmHandler
```
  - promptHandler
```
private final <any> promptHandler
```
  - onError
```
private final <any> onError
```
    The event handler called when an error occurs.
    
    Since:
    
    JavaFX 8.0
  - history
```
private final WebHistory history
```
- Constructor Detail
  - WebEngine
```
public WebEngine()
```
    Creates a new engine.
  - WebEngine
```
public WebEngine(java.lang.String url)
```
    Creates a new engine and loads a Web page into it.
    
    Parameters:
    
    url - the URL of the web page to load
  - WebEngine
```
private WebEngine(java.lang.String url,
                  boolean callLoad)
```
- Method Detail
  - getLoadWorker
```
public final <any> getLoadWorker()
```
    Returns a javafx.concurrent.Worker object that can be used to track loading progress.
    
    Returns:
    
    the Worker object
  - getDocument
```
public final org.w3c.dom.Document getDocument()
```
    Gets the value of the property document.
  - documentProperty
```
public final <any> documentProperty()
```
    Document object for the current Web page. The value is null if the Web page failed to load.
    
    See Also:
    
    getDocument()
  - getLocation
```
public final java.lang.String getLocation()
```
    Gets the value of the property location.
  - locationProperty
```
public final ReadOnlyStringProperty locationProperty()
```
    URL of the current Web page. If the current page has no URL, the value is an empty String.
    
    See Also:
    
    getLocation()
  - updateLocation
```
private void updateLocation(java.lang.String value)
```
  - getTitle
```
public final java.lang.String getTitle()
```
    Gets the value of the property title.
  - titleProperty
```
public final ReadOnlyStringProperty titleProperty()
```
    Title of the current Web page. If the current page has no title, the value is null.
    
    See Also:
    
    getTitle()
  - updateTitle
```
private void updateTitle()
```
  - setJavaScriptEnabled
```
public final void setJavaScriptEnabled(boolean value)
```
    Sets the value of the property javaScriptEnabled.
    
    Since:
    
    JavaFX 2.2
  - isJavaScriptEnabled
```
public final boolean isJavaScriptEnabled()
```
    Gets the value of the property javaScriptEnabled.
    
    Since:
    
    JavaFX 2.2
  - javaScriptEnabledProperty
```
public final BooleanProperty javaScriptEnabledProperty()
```
    Specifies whether JavaScript execution is enabled.
    
    Since:
    
    JavaFX 2.2
    
    See Also:
    
    isJavaScriptEnabled(), setJavaScriptEnabled(boolean)
  - setUserStyleSheetLocation
```
public final void setUserStyleSheetLocation(java.lang.String value)
```
    Sets the value of the property userStyleSheetLocation.
    
    Since:
    
    JavaFX 2.2
  - getUserStyleSheetLocation
```
public final java.lang.String getUserStyleSheetLocation()
```
    Gets the value of the property userStyleSheetLocation.
    
    Since:
    
    JavaFX 2.2
  - readFully
```
private byte[] readFully(java.io.BufferedInputStream in)
                  throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - userStyleSheetLocationProperty
```
public final StringProperty userStyleSheetLocationProperty()
```
    Location of the user stylesheet as a string URL.
    This should be a local URL, i.e. either 'data:', 'file:', or 'jar:'. Remote URLs are not allowed for security reasons.
    
    Since:
    
    JavaFX 2.2
    
    See Also:
    
    getUserStyleSheetLocation(), setUserStyleSheetLocation(String)
  - getUserDataDirectory
```
public final java.io.File getUserDataDirectory()
```
    Gets the value of the property userDataDirectory.
    
    Since:
    
    JavaFX 8.0
  - setUserDataDirectory
```
public final void setUserDataDirectory(java.io.File value)
```
    Sets the value of the property userDataDirectory.
    
    Since:
    
    JavaFX 8.0
  - userDataDirectoryProperty
```
public final <any> userDataDirectoryProperty()
```
    Specifies the directory to be used by this WebEngine to store local user data.
    If the value of this property is not null, the WebEngine will attempt to store local user data in the respective directory. If the value of this property is null, the WebEngine will attempt to store local user data in an automatically selected system-dependent user- and application-specific directory.
    When a WebEngine is about to start loading a web page or executing a script for the first time, it checks whether it can actually use the directory specified by this property. If the check fails for some reason, the WebEngine invokes the WebEngine.onError event handler, if any, with a WebErrorEvent describing the reason. If the invoked event handler modifies the userDataDirectory property, the WebEngine retries with the new value as soon as the handler returns. If the handler does not modify the userDataDirectory property (which is the default), the WebEngine continues without local user data.
    Once the WebEngine has started loading a web page or executing a script, changes made to this property have no effect on where the WebEngine stores or will store local user data.
    Currently, the directory specified by this property is used only to store the data that backs the window.localStorage objects. In the future, more types of data can be added.
    
    Since:
    
    JavaFX 8.0
    
    See Also:
    
    getUserDataDirectory(), setUserDataDirectory(File)
  - setUserAgent
```
public final void setUserAgent(java.lang.String value)
```
    Sets the value of the property userAgent.
    
    Since:
    
    JavaFX 8.0
  - getUserAgent
```
public final java.lang.String getUserAgent()
```
    Gets the value of the property userAgent.
    
    Since:
    
    JavaFX 8.0
  - userAgentProperty
```
public final StringProperty userAgentProperty()
```
    Specifies user agent ID string. This string is the value of the User-Agent HTTP header.
    
    Since:
    
    JavaFX 8.0
    
    See Also:
    
    getUserAgent(), setUserAgent(String)
  - getOnAlert
```
public final <any> getOnAlert()
```
    Gets the value of the property onAlert.
  - setOnAlert
```
public final void setOnAlert(<any> handler)
```
    Sets the value of the property onAlert.
  - onAlertProperty
```
public final <any> onAlertProperty()
```
    JavaScript alert handler property. This handler is invoked when a script running on the Web page calls the alert function.
    
    See Also:
    
    getOnAlert(), #setOnAlert()
  - getOnStatusChanged
```
public final <any> getOnStatusChanged()
```
    Gets the value of the property onStatusChanged.
  - setOnStatusChanged
```
public final void setOnStatusChanged(<any> handler)
```
    Sets the value of the property onStatusChanged.
  - onStatusChangedProperty
```
public final <any> onStatusChangedProperty()
```
    JavaScript status handler property. This handler is invoked when a script running on the Web page sets window.status property.
    
    See Also:
    
    getOnStatusChanged(), #setOnStatusChanged()
  - getOnResized
```
public final <any> getOnResized()
```
    Gets the value of the property onResized.
  - setOnResized
```
public final void setOnResized(<any> handler)
```
    Sets the value of the property onResized.
  - onResizedProperty
```
public final <any> onResizedProperty()
```
    JavaScript window resize handler property. This handler is invoked when a script running on the Web page moves or resizes the window object.
    
    See Also:
    
    getOnResized(), #setOnResized()
  - getOnVisibilityChanged
```
public final <any> getOnVisibilityChanged()
```
    Gets the value of the property onVisibilityChanged.
  - setOnVisibilityChanged
```
public final void setOnVisibilityChanged(<any> handler)
```
    Sets the value of the property onVisibilityChanged.
  - onVisibilityChangedProperty
```
public final <any> onVisibilityChangedProperty()
```
    JavaScript window visibility handler property. This handler is invoked when a script running on the Web page changes visibility of the window object.
    
    See Also:
    
    getOnVisibilityChanged(), #setOnVisibilityChanged()
  - getCreatePopupHandler
```
public final <any> getCreatePopupHandler()
```
    Gets the value of the property createPopupHandler.
  - setCreatePopupHandler
```
public final void setCreatePopupHandler(<any> handler)
```
    Sets the value of the property createPopupHandler.
  - createPopupHandlerProperty
```
public final <any> createPopupHandlerProperty()
```
    JavaScript popup handler property. This handler is invoked when a script running on the Web page requests a popup to be created.
    To satisfy this request a handler may create a new WebEngine, attach a visibility handler and optionally a resize handler, and return the newly created engine. To block the popup, a handler should return null.
    By default, a popup handler is installed that opens popups in this WebEngine.
    
    See Also:
    
    getCreatePopupHandler(), #setCreatePopupHandler()
  - getConfirmHandler
```
public final <any> getConfirmHandler()
```
    Gets the value of the property confirmHandler.
  - setConfirmHandler
```
public final void setConfirmHandler(<any> handler)
```
    Sets the value of the property confirmHandler.
  - confirmHandlerProperty
```
public final <any> confirmHandlerProperty()
```
    JavaScript confirm handler property. This handler is invoked when a script running on the Web page calls the confirm function.
    An implementation may display a dialog box with Yes and No options, and return the user's choice.
    
    See Also:
    
    getConfirmHandler(), #setConfirmHandler()
  - getPromptHandler
```
public final <any> getPromptHandler()
```
    Gets the value of the property promptHandler.
  - setPromptHandler
```
public final void setPromptHandler(<any> handler)
```
    Sets the value of the property promptHandler.
  - promptHandlerProperty
```
public final <any> promptHandlerProperty()
```
    JavaScript prompt handler property. This handler is invoked when a script running on the Web page calls the prompt function.
    An implementation may display a dialog box with an text field, and return the user's input.
    
    See Also:
    
    getPromptHandler(), #setPromptHandler()
  - getOnError
```
public final <any> getOnError()
```
    Gets the value of the property onError.
    
    Since:
    
    JavaFX 8.0
  - setOnError
```
public final void setOnError(<any> handler)
```
    Sets the value of the property onError.
    
    Since:
    
    JavaFX 8.0
  - onErrorProperty
```
public final <any> onErrorProperty()
```
    The event handler called when an error occurs.
    
    Since:
    
    JavaFX 8.0
    
    See Also:
    
    getOnError(), #setOnError()
  - load
```
public void load(java.lang.String url)
```
    Loads a Web page into this engine. This method starts asynchronous loading and returns immediately.
    
    Parameters:
    
    url - URL of the web page to load
  - loadContent
```
public void loadContent(java.lang.String content)
```
    Loads the given HTML content directly. This method is useful when you have an HTML String composed in memory, or loaded from some system which cannot be reached via a URL (for example, the HTML text may have come from a database). As with load(String), this method is asynchronous.
    
    Parameters:
    
    content - the HTML content to load
  - loadContent
```
public void loadContent(java.lang.String content,
                        java.lang.String contentType)
```
    Loads the given content directly. This method is useful when you have content composed in memory, or loaded from some system which cannot be reached via a URL (for example, the SVG text may have come from a database). As with load(String), this method is asynchronous. This method also allows you to specify the content type of the string being loaded, and so may optionally support other types besides just HTML.
    
    Parameters:
    
    content - the HTML content to load
    
    contentType - the type of content to load
  - reload
```
public void reload()
```
    Reloads the current page, whether loaded from URL or directly from a String in one of the loadContent methods.
  - getHistory
```
public WebHistory getHistory()
```
    Returns the session history object.
    
    Returns:
    
    history object
    
    Since:
    
    JavaFX 2.2
  - executeScript
```
public java.lang.Object executeScript(java.lang.String script)
```
    Executes a script in the context of the current page.
    Parameters:
    
    script - the script
    
    Returns:
    execution result, converted to a Java object using the following rules:
    
    JavaScript Int32 is converted to java.lang.Integer
    Other JavaScript numbers to java.lang.Double
    JavaScript string to java.lang.String
    JavaScript boolean to java.lang.Boolean
    JavaScript null to null
    Most JavaScript objects get wrapped as netscape.javascript.JSObject
    JavaScript JSNode objects get mapped to instances of netscape.javascript.JSObject, that also implement org.w3c.dom.Node
    A special case is the JavaScript class JavaRuntimeObject which is used to wrap a Java object as a JavaScript value - in this case we just extract the original Java value.
  - getMainFrame
```
private long getMainFrame()
```
  - getPage
```
WebPage getPage()
```
  - setView
```
void setView(WebView view)
```
  - stop
```
private void stop()
```
  - applyUserDataDirectory
```
private void applyUserDataDirectory()
```
  - defaultUserDataDirectory
```
private static java.io.File defaultUserDataDirectory()
```
  - createDirectories
```
private static void createDirectories(java.io.File directory)
                               throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - fireError
```
private void fireError(<any> eventType,
                       java.lang.String message,
                       java.lang.Throwable exception)
```
  - dispose
```
void dispose()
```
  - checkThread
```
static void checkThread()
```
  - getDebugger
```
Debugger getDebugger()
```
  - printStatusOK
```
private static final boolean printStatusOK(PrinterJob job)
```
  - print
```
public void print(PrinterJob job)
```
    Prints the current Web page using the given printer job.
    This method does not modify the state of the job, nor does it call PrinterJob#endJob, so the job may be safely reused afterwards.
    
    Parameters:
    
    job - printer job used for printing
    
    Since:
    
    JavaFX 8.0

Class WebEngine

Property Summary

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Property Detail

document

location

title

javaScriptEnabled

userStyleSheetLocation

userDataDirectory

userAgent

onAlert

onStatusChanged

onResized

onVisibilityChanged

createPopupHandler

confirmHandler

promptHandler

onError

Field Detail

logger

instanceCount

view

loadWorker

page

disposer

debugger

userDataDirectoryApplied

document

location

title

javaScriptEnabled

userStyleSheetLocation

userDataDirectory

userAgent

onAlert

onStatusChanged

onResized

onVisibilityChanged

createPopupHandler

confirmHandler

promptHandler

onError

history

Constructor Detail

WebEngine

WebEngine

WebEngine

Method Detail

getLoadWorker

getDocument

documentProperty

getLocation

locationProperty

updateLocation

getTitle

titleProperty

updateTitle

setJavaScriptEnabled

isJavaScriptEnabled

javaScriptEnabledProperty

setUserStyleSheetLocation

getUserStyleSheetLocation

readFully

userStyleSheetLocationProperty

getUserDataDirectory

setUserDataDirectory

userDataDirectoryProperty

setUserAgent

getUserAgent

userAgentProperty

getOnAlert

setOnAlert

onAlertProperty

getOnStatusChanged

setOnStatusChanged