org.openqa.selenium.remote

Class ErrorHandler

java.lang.Object

org.openqa.selenium.remote.ErrorHandler

public class ErrorHandler
extends java.lang.Object

Maps exceptions to status codes for sending over the wire.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	ErrorHandler.FrameInfoToStackFrame Function that can rebuild a StackTraceElement from the frame info included with a WebDriver JSON response.
static class	ErrorHandler.UnknownServerException Exception used as a place holder if the server returns an error without a stack trace.

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.String	CLASS
private static java.lang.String	CLASS_NAME
private ErrorCodes	errorCodes
private static java.lang.String	FILE_NAME
private boolean	includeServerErrors
private static java.lang.String	LINE_NUMBER
private static java.lang.String	MESSAGE
private static java.lang.String	METHOD_NAME
private static java.lang.String	SCREEN_SHOT
private static java.lang.String	STACK_TRACE
private static java.lang.String	UNKNOWN_CLASS
private static java.lang.String	UNKNOWN_FILE
private static java.lang.String	UNKNOWN_METHOD

Constructor Summary

Constructors

Constructor and Description
ErrorHandler()
ErrorHandler(boolean includeServerErrors)
ErrorHandler(ErrorCodes codes, boolean includeServerErrors)

Method Summary

Modifier and Type	Method and Description
private <T extends java.lang.Throwable> T	createThrowable(java.lang.Class<T> clazz, java.lang.Class<?>[] parameterTypes, java.lang.Object[] parameters)
private org.openqa.selenium.UnhandledAlertException	createUnhandledAlertException(java.lang.Object value)
private java.lang.String	duration(long duration)
boolean	isIncludeServerErrors()
private java.lang.Throwable	rebuildServerError(java.util.Map<java.lang.String,java.lang.Object> rawErrorData, int responseStatus)
void	setIncludeServerErrors(boolean includeServerErrors)
Response	throwIfResponseFailed(Response response, long duration)

Methods inherited from class java.lang.Object

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

Field Detail

MESSAGE

private static final java.lang.String MESSAGE

See Also:

Constant Field Values

SCREEN_SHOT

private static final java.lang.String SCREEN_SHOT

See Also:

Constant Field Values

CLASS

private static final java.lang.String CLASS

See Also:

Constant Field Values

STACK_TRACE

private static final java.lang.String STACK_TRACE

See Also:

Constant Field Values

LINE_NUMBER

private static final java.lang.String LINE_NUMBER

See Also:

Constant Field Values

METHOD_NAME

private static final java.lang.String METHOD_NAME

See Also:

Constant Field Values

CLASS_NAME

private static final java.lang.String CLASS_NAME

See Also:

Constant Field Values

FILE_NAME

private static final java.lang.String FILE_NAME

See Also:

Constant Field Values

UNKNOWN_CLASS

private static final java.lang.String UNKNOWN_CLASS

See Also:

Constant Field Values

UNKNOWN_METHOD

private static final java.lang.String UNKNOWN_METHOD

See Also:

Constant Field Values

UNKNOWN_FILE

private static final java.lang.String UNKNOWN_FILE

errorCodes

private ErrorCodes errorCodes

includeServerErrors

private boolean includeServerErrors

Constructor Detail

ErrorHandler

public ErrorHandler()

ErrorHandler

public ErrorHandler(boolean includeServerErrors)

Parameters:

includeServerErrors - Whether to include server-side details in thrown exceptions if the information is available.

ErrorHandler

public ErrorHandler(ErrorCodes codes,
                    boolean includeServerErrors)

Parameters:

includeServerErrors - Whether to include server-side details in thrown exceptions if the information is available.

codes - The ErrorCodes object to use for linking error codes to exceptions.

Method Detail

isIncludeServerErrors

public boolean isIncludeServerErrors()

setIncludeServerErrors

public void setIncludeServerErrors(boolean includeServerErrors)

throwIfResponseFailed

public Response throwIfResponseFailed(Response response,
                                      long duration)
                               throws java.lang.RuntimeException

Throws:

java.lang.RuntimeException

createUnhandledAlertException

private org.openqa.selenium.UnhandledAlertException createUnhandledAlertException(java.lang.Object value)

duration

private java.lang.String duration(long duration)

createThrowable

private <T extends java.lang.Throwable> T createThrowable(java.lang.Class<T> clazz,
                                                          java.lang.Class<?>[] parameterTypes,
                                                          java.lang.Object[] parameters)

rebuildServerError

private java.lang.Throwable rebuildServerError(java.util.Map<java.lang.String,java.lang.Object> rawErrorData,
                                               int responseStatus)