Class WebErrorEvent

java.lang.Object

java.util.EventObject

javafx.event.Event

javafx.scene.web.WebErrorEvent

All Implemented Interfaces:

Serializable, Cloneable

public final class WebErrorEvent
extends Event

An event indicating a WebEngine error. Holds an optional text message and an optional exception associated with the error.

Since:

JavaFX 8.0

See Also:

• WebEngine.onError
• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final EventType<WebErrorEvent>	ANY	Common supertype for all WebErrorEvent types.
static final EventType<WebErrorEvent>	USER_DATA_DIRECTORY_ALREADY_IN_USE	This event occurs when a WebEngine detects that its user data directory is already in use by a WebEngine running in a different VM.
static final EventType<WebErrorEvent>	USER_DATA_DIRECTORY_IO_ERROR	This event occurs when a WebEngine encounters an I/O error while trying to create or access the user data directory.
static final EventType<WebErrorEvent>	USER_DATA_DIRECTORY_SECURITY_ERROR	This event occurs when a WebEngine encounters a security error while trying to create or access the user data directory.

Fields declared in class Event

consumed, eventType, NULL_SOURCE_TARGET, target

Modifier and Type	Field	Description
protected boolean	consumed	Whether this event has been consumed by any filter or handler.
protected EventType<? extends Event>	eventType	Type of the event.
static final EventTarget	NULL_SOURCE_TARGET	The constant which represents an unknown event source / target.
protected EventTarget	target	Event target that defines the path through which the event will travel when posted.

Fields declared in class EventObject

source

Constructor Summary

Constructors

Constructor	Description
WebErrorEvent(Object source, EventType<WebErrorEvent> type, String message, Throwable exception)	Creates a new WebErrorEvent.

Method Summary

Modifier and Type	Method	Description
Throwable	getException()	Returns the exception associated with this event.
String	getMessage()	Returns the text message associated with this event.

Methods declared in class Event

clone, consume, copyFor, fireEvent, getEventType, getTarget, isConsumed

Modifier and Type	Method	Description
Object	clone()	Creates and returns a copy of this Event.
void	consume()	Marks this Event as consumed.
Event	copyFor(Object newSource, EventTarget newTarget)	Creates and returns a copy of this event with the specified event source and target.
static void	fireEvent(EventTarget eventTarget, Event event)	Fires the specified event.
EventType<? extends Event>	getEventType()	Gets the event type of this event.
EventTarget	getTarget()	Returns the event target of this event.
boolean	isConsumed()	Indicates whether this Event has been consumed by any filter or handler.

Methods declared in class EventObject

getSource, toString

Methods declared in class Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

ANY

public static final EventType<WebErrorEvent> ANY

Common supertype for all WebErrorEvent types.

USER_DATA_DIRECTORY_ALREADY_IN_USE

public static final EventType<WebErrorEvent> USER_DATA_DIRECTORY_ALREADY_IN_USE

This event occurs when a WebEngine detects that its user data directory is already in use by a WebEngine running in a different VM.

In general, multiple WebEngine instances may share a single user data directory as long as they run in the same VM. WebEngine instances running in different VMs are not allowed to share the same user data directory.

When a WebEngine is about to start loading a web page or executing a script for the first time, it checks whether its userDataDirectory is already in use by a WebEngine running in a different VM. If the latter is the case, the WebEngine invokes the WebEngine.onError event handler, if any, with a USER_DATA_DIRECTORY_ALREADY_IN_USE event. If the invoked event handler modifies the userDataDirectory property, the WebEngine retries with the new user data directory as soon as the handler returns. If the handler does not modify the userDataDirectory property (which is the default), the WebEngine continues without the user data directory.

USER_DATA_DIRECTORY_IO_ERROR

public static final EventType<WebErrorEvent> USER_DATA_DIRECTORY_IO_ERROR

This event occurs when a WebEngine encounters an I/O error while trying to create or access the user data 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 create or access its userDataDirectory. If the check fails with an I/O error (such as java.io.IOException), the WebEngine invokes the WebEngine.onError event handler, if any, with a USER_DATA_DIRECTORY_IO_ERROR event. If the invoked event handler modifies the userDataDirectory property, the WebEngine retries with the new user data directory as soon as the handler returns. If the handler does not modify the userDataDirectory property (which is the default), the WebEngine continues without the user data directory.

USER_DATA_DIRECTORY_SECURITY_ERROR

public static final EventType<WebErrorEvent> USER_DATA_DIRECTORY_SECURITY_ERROR

This event occurs when a WebEngine encounters a security error while trying to create or access the user data 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 create or access its userDataDirectory. If the check fails with a security error (such as java.lang.SecurityException), the WebEngine invokes the WebEngine.onError event handler, if any, with a USER_DATA_DIRECTORY_SECURITY_ERROR event. If the invoked event handler modifies the userDataDirectory property, the WebEngine retries with the new user data directory as soon as the handler returns. If the handler does not modify the userDataDirectory property (which is the default), the WebEngine continues without the user data directory.

Constructor Details

WebErrorEvent

public WebErrorEvent(Object source,
 EventType<WebErrorEvent> type,
 String message,
 Throwable exception)

Creates a new WebErrorEvent.

Parameters:

source - the event source which sent the event

type - the event type

message - the text message associated with the event; may be null

exception - the exception associated with the event; may be null

Method Details

getMessage

public String getMessage()

Returns the text message associated with this event.

Returns:

the text message associated with this event, or null if there is no such message

getException

public Throwable getException()

Returns the exception associated with this event.

Returns:

the exception associated with this event, or null if there is no such exception