Stay organized with collections
Save and categorize content based on your preferences.
DOMErrorHandler
public
interface
DOMErrorHandler
org.w3c.dom.DOMErrorHandler
|
DOMErrorHandler
is a callback interface that the DOM
implementation can call when reporting errors that happens while
processing XML data, or when doing some other processing (e.g. validating
a document). A DOMErrorHandler
object can be attached to a
Document
using the "error-handler" on the
DOMConfiguration
interface. If more than one error needs to
be reported during an operation, the sequence and numbers of the errors
passed to the error handler are implementation dependent.
The application that is using the DOM implementation is expected to
implement this interface.
See also the Document Object Model (DOM) Level 3 Core Specification.
Summary
Public methods |
abstract
boolean
|
handleError(DOMError error)
This method is called on the error handler when an error occurs.
|
Public methods
handleError
public abstract boolean handleError (DOMError error)
This method is called on the error handler when an error occurs.
If an exception is thrown from this method, it is considered to be
equivalent of returning true
.
Parameters |
error |
DOMError : The error object that describes the error. This object
may be reused by the DOM implementation across multiple calls to
the handleError method. |
Returns |
boolean |
If the handleError method returns
false , the DOM implementation should stop the current
processing when possible. If the method returns true ,
the processing may continue depending on
DOMError.severity . |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-02-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-10 UTC."],[],[],null,["# DOMErrorHandler\n\nAdded in [API level 8](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\nDOMErrorHandler\n===============\n\n\n`\npublic\n\n\ninterface\nDOMErrorHandler\n`\n\n\n`\n\n\n`\n\n|-----------------------------|\n| org.w3c.dom.DOMErrorHandler |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\n`DOMErrorHandler` is a callback interface that the DOM\nimplementation can call when reporting errors that happens while\nprocessing XML data, or when doing some other processing (e.g. validating\na document). A `DOMErrorHandler` object can be attached to a\n`Document` using the \"error-handler\" on the\n`DOMConfiguration` interface. If more than one error needs to\nbe reported during an operation, the sequence and numbers of the errors\npassed to the error handler are implementation dependent.\n\nThe application that is using the DOM implementation is expected to\nimplement this interface.\n\nSee also the [Document Object Model (DOM) Level 3 Core Specification](http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407).\n\nSummary\n-------\n\n| ### Public methods ||\n|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` abstract boolean` | ` `[handleError](/reference/org/w3c/dom/DOMErrorHandler#handleError(org.w3c.dom.DOMError))`(`[DOMError](/reference/org/w3c/dom/DOMError)` error) ` This method is called on the error handler when an error occurs. |\n\nPublic methods\n--------------\n\n### handleError\n\nAdded in [API level 8](/guide/topics/manifest/uses-sdk-element#ApiLevels) \n\n```\npublic abstract boolean handleError (DOMError error)\n```\n\nThis method is called on the error handler when an error occurs.\n\nIf an exception is thrown from this method, it is considered to be\nequivalent of returning `true`.\n\n\u003cbr /\u003e\n\n| Parameters ||\n|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `error` | `DOMError`: The error object that describes the error. This object may be reused by the DOM implementation across multiple calls to the `handleError` method. \u003cbr /\u003e |\n\n| Returns ||\n|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `boolean` | If the `handleError` method returns `false`, the DOM implementation should stop the current processing when possible. If the method returns `true`, the processing may continue depending on `DOMError.severity`. \u003cbr /\u003e |"]]