Stay organized with collections
Save and categorize content based on your preferences.
DOMErrorHandler
interface 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 |
This method is called on the error handler when an error occurs.
|
Public methods
handleError
abstract fun handleError(error: DOMError!): Boolean
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. |
Return |
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](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)\n\nDOMErrorHandler\n===============\n\n```\ninterface DOMErrorHandler\n```\n\n|----------------------------------|\n| [org.w3c.dom.DOMErrorHandler](#) |\n\n`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.\n\nThe application that is using the DOM implementation is expected to implement 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](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | [handleError](#handleError(org.w3c.dom.DOMError))`(`error:` `[DOMError](https://kotlinlang.org/api/latest/jvm/stdlib/org.w3c.dom/-d-o-m-error/index.html)!`)` 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](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels) \n\n```\nabstract fun handleError(error: DOMError!): Boolean\n```\n\nThis method is called on the error handler when an error occurs. \nIf an exception is thrown from this method, it is considered to be equivalent of returning `true`.\n\n| Parameters ||\n|---------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `error` | [DOMError](https://kotlinlang.org/api/latest/jvm/stdlib/org.w3c.dom/-d-o-m-error/index.html)!: The error object that describes the error. This object may be reused by the DOM implementation across multiple calls to the `handleError` method. |\n\n| Return ||\n|------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html) | 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`. |"]]