public interface DOMError
DOMError
is an interface that describes an error.
See also the Document Object Model (DOM) Level 3 Core Specification.
static final short SEVERITY_WARNING
The severity of the error described by the DOMError
is warning. A SEVERITY_WARNING
will not cause the processing to stop, unless DOMErrorHandler.handleError()
returns false
.
static final short SEVERITY_ERROR
The severity of the error described by the DOMError
is error. A SEVERITY_ERROR
may not cause the processing to stop if the error can be recovered, unless DOMErrorHandler.handleError()
returns false
.
static final short SEVERITY_FATAL_ERROR
The severity of the error described by the DOMError
is fatal error. A SEVERITY_FATAL_ERROR
will cause the normal processing to stop. The return value of DOMErrorHandler.handleError()
is ignored unless the implementation chooses to continue, in which case the behavior becomes undefined.
short getSeverity()
The severity of the error, either SEVERITY_WARNING
, SEVERITY_ERROR
, or SEVERITY_FATAL_ERROR
.
String getMessage()
An implementation specific string describing the error that occurred.
String getType()
A DOMString
indicating which related data is expected in relatedData
. Users should refer to the specification of the error in order to find its DOMString
type and relatedData
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 a SEVERITY_WARNING
with type
"cdata-sections-splitted"
and the first CDATASection
node in document order resulting from the split is returned by the relatedData
attribute.
Object getRelatedException()
The related platform dependent exception if any.
Object getRelatedData()
The related DOMError.type
dependent data if any.
DOMLocator getLocation()
The location of the error.
© 1993–2017, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.