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
Modifier and TypeFieldDescriptionstatic final short
The severity of the error described by theDOMError
is error.static final short
The severity of the error described by theDOMError
is fatal error.static final short
The severity of the error described by theDOMError
is warning. -
Method Summary
Modifier and TypeMethodDescriptionThe location of the error.An implementation specific string describing the error that occurred.The relatedDOMError.type
dependent data if any.The related platform dependent exception if any.short
The severity of the error, eitherSEVERITY_WARNING
,SEVERITY_ERROR
, orSEVERITY_FATAL_ERROR
.getType()
ADOMString
indicating which related data is expected inrelatedData
.
-
Field Details
-
SEVERITY_WARNING
static final short SEVERITY_WARNINGThe severity of the error described by theDOMError
is warning. ASEVERITY_WARNING
will not cause the processing to stop, unlessDOMErrorHandler.handleError()
returnsfalse
.- See Also:
-
SEVERITY_ERROR
static final short SEVERITY_ERRORThe 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:
-
SEVERITY_FATAL_ERROR
static final short SEVERITY_FATAL_ERRORThe 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:
-
-
Method Details
-
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.
-