-
public interface DOMError
DOMError
is an interface that describes an error.See also the Document Object Model (DOM) Level 3 Core Specification.
- Since:
- 1.5, DOM Level 3
-
-
Field Summary
Fields Modifier and Type Field Description static short
SEVERITY_ERROR
The severity of the error described by theDOMError
is error.static short
SEVERITY_FATAL_ERROR
The severity of the error described by theDOMError
is fatal error.static short
SEVERITY_WARNING
The severity of the error described by theDOMError
is warning.
-
Method Summary
Modifier and Type Method Description DOMLocator
getLocation()
The location of the error.String
getMessage()
An implementation specific string describing the error that occurred.Object
getRelatedData()
The relatedDOMError.type
dependent data if any.Object
getRelatedException()
The related platform dependent exception if any.short
getSeverity()
The severity of the error, eitherSEVERITY_WARNING
,SEVERITY_ERROR
, orSEVERITY_FATAL_ERROR
.String
getType()
ADOMString
indicating which related data is expected inrelatedData
.
-
-
-
Field Detail
-
SEVERITY_WARNING
static final short SEVERITY_WARNING
The severity of the error described by theDOMError
is warning. ASEVERITY_WARNING
will not cause the processing to stop, unlessDOMErrorHandler.handleError()
returnsfalse
.- See Also:
- Constant Field Values
-
SEVERITY_ERROR
static final short SEVERITY_ERROR
The severity of the error described by theDOMError
is error. ASEVERITY_ERROR
may not cause the processing to stop if the error can be recovered, unlessDOMErrorHandler.handleError()
returnsfalse
.- See Also:
- Constant Field Values
-
SEVERITY_FATAL_ERROR
static final short SEVERITY_FATAL_ERROR
The severity of the error described by theDOMError
is fatal error. ASEVERITY_FATAL_ERROR
will cause the normal processing to stop. The return value ofDOMErrorHandler.handleError()
is ignored unless the implementation chooses to continue, in which case the behavior becomes undefined.- See Also:
- Constant Field Values
-
-
Method Detail
-
getSeverity
short getSeverity()
The severity of the error, eitherSEVERITY_WARNING
,SEVERITY_ERROR
, orSEVERITY_FATAL_ERROR
.
-
getMessage
String getMessage()
An implementation specific string describing the error that occurred.
-
getType
String getType()
ADOMString
indicating which related data is expected inrelatedData
. Users should refer to the specification of the error in order to find itsDOMString
type andrelatedData
definitions if any.Note: As an example,
Document.normalizeDocument()
does generate warnings when the "split-cdata-sections" parameter is in use. Therefore, the method generates aSEVERITY_WARNING
withtype
"cdata-sections-splitted"
and the firstCDATASection
node in document order resulting from the split is returned by therelatedData
attribute.
-
getRelatedException
Object getRelatedException()
The related platform dependent exception if any.
-
getRelatedData
Object getRelatedData()
The relatedDOMError.type
dependent data if any.
-
getLocation
DOMLocator getLocation()
The location of the error.
-
-