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
FieldsModifier and TypeFieldDescriptionstatic final shortThe severity of the error described by theDOMErroris error.static final shortThe severity of the error described by theDOMErroris fatal error.static final shortThe severity of the error described by theDOMErroris warning. -
Method Summary
Modifier and TypeMethodDescriptionThe location of the error.An implementation specific string describing the error that occurred.The relatedDOMError.typedependent data if any.The related platform dependent exception if any.shortThe severity of the error, eitherSEVERITY_WARNING,SEVERITY_ERROR, orSEVERITY_FATAL_ERROR.getType()ADOMStringindicating which related data is expected inrelatedData.
-
Field Details
-
SEVERITY_WARNING
static final short SEVERITY_WARNINGThe severity of the error described by theDOMErroris warning. ASEVERITY_WARNINGwill not cause the processing to stop, unlessDOMErrorHandler.handleError()returnsfalse.- See Also:
-
SEVERITY_ERROR
static final short SEVERITY_ERRORThe severity of the error described by theDOMErroris error. ASEVERITY_ERRORmay 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 theDOMErroris fatal error. ASEVERITY_FATAL_ERRORwill 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()ADOMStringindicating which related data is expected inrelatedData. Users should refer to the specification of the error in order to find itsDOMStringtype andrelatedDatadefinitions 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_WARNINGwithtype"cdata-sections-splitted"and the firstCDATASectionnode in document order resulting from the split is returned by therelatedDataattribute. -
getRelatedException
Object getRelatedException()The related platform dependent exception if any. -
getRelatedData
Object getRelatedData()The relatedDOMError.typedependent data if any. -
getLocation
DOMLocator getLocation()The location of the error.
-