Appendix A: Changes

Editor:: Philippe Le Hégaret, W3C

A.1 New sections
A.2 Changes to DOM Level 2 Core interfaces and exceptions
A.3 New DOM features
A.4 New types
A.5 New interfaces
A.6 Objects

This section summarizes the changes between [DOM Level 2 Core] and this new version of the Core specification.

A.1 New sections

The following new sections have been added:

DOM Architecture: a global overview of the DOM Level 3 modules;
DOM URIs: general considerations on the URI handling in DOM Level 3;
Base URIs: How the [base URI] property defined in [XML Information Set] has been exposed in DOM Level 3;
Mixed DOM implementations: general considerations on DOM implementation extensions;
DOM Features: overview of the DOM features and how they relate to the DOM modules;
Bootstrapping: general introduction to the DOM Level 3 bootstrapping mechanisms;
Namespaces Algorithms: how namespace URIs and prefixes are resolved in DOM Level 3;
Infoset mapping: relation between DOM Level 3 and [XML Information Set];
Configuration Settings: relations between parameters as used in DOMConfiguration;

A.2 Changes to DOM Level 2 Core interfaces and exceptions

Interface Attr: The Attr interface has two new attributes, Attr.schemaTypeInfo, and Attr.isId.
Interface Document: The Document interface has seven new attributes: Document.inputEncoding, Document.xmlEncoding, Document.xmlStandalone, Document.xmlVersion, Document.strictErrorChecking, Document.documentURI, and Document.domConfig. It has three new methods: Document.adoptNode(source), Document.normalizeDocument(), and Document.renameNode(n, namespaceURI, qualifiedName). The attribute Document.doctype has been modified.
Exception DOMException: The DOMException has two new exception codes: VALIDATION_ERR and TYPE_MISMATCH_ERR.
Interface DOMImplementation: The DOMImplementation interface has one new method, DOMImplementation.getFeature(feature, version).
Interface Entity: The Document interface has three new attributes: Entity.inputEncoding, Entity.xmlEncoding, and Entity.xmlVersion.
Interface Element: The Element interface has one new attribute, Element.schemaTypeInfo, and three new methods: Element.setIdAttribute(name, isId), Element.setIdAttributeNS(namespaceURI, localName, isId), and Element.setIdAttributeNode(idAttr, isId).
Interface Node: The Node interface has two new attributes, Node.baseURI and Node.textContent. It has nine new methods: Node.compareDocumentPosition(other), Node.isSameNode(other), Node.lookupPrefix(namespaceURI), Node.isDefaultNamespace(namespaceURI), Node.lookupNamespaceURI(prefix), Node.isEqualNode(arg), Node.getFeature(feature, version), Node.setUserData(key, data, handler), Node.getUserData(key). It introduced 6 new constants: Node.DOCUMENT_POSITION_DISCONNECTED, Node.DOCUMENT_POSITION_PRECEDING, Node.DOCUMENT_POSITION_FOLLOWING, Node.DOCUMENT_POSITION_CONTAINS, Node.DOCUMENT_POSITION_CONTAINED_BY, and Node.DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC. The methods Node.insertBefore(newChild, refChild), Node.replaceChild(newChild, oldChild) and Node.removeChild(oldChild) have been modified.
Interface Text: The Text interface has two new attributes, Text.wholeText and Text.isElementContentWhitespace, and one new method, Text.replaceWholeText(content).

A.3 New DOM features

"XMLVersion": The "XMLVersion" DOM feature was introduced to represent if an implementation is able to support [XML 1.0] or [XML 1.1]. See Document.xmlVersion.

A.4 New types

DOMUserData: The DOMUserData type was added to the Core module.
DOMObject: The DOMObject type was added to the Core module.

A.5 New interfaces

DOMStringList: The DOMStringList interface has one attribute, DOMStringList.length, and one method, DOMStringList.item(index).
NameList: The NameList interface has one attribute, NameList.length, and two methods, NameList.getName(index) and NameList.getNamespaceURI(index).
DOMImplementationList: The DOMImplementationList interface has one attribute, DOMImplementationList.length, and one method, DOMImplementationList.item(index).
DOMImplementationSource: The DOMImplementationSource interface has two methods, DOMImplementationSource.getDOMImplementation(features), and DOMImplementationSource.getDOMImplementationList(features).
TypeInfo: The TypeInfo interface has two attributes, TypeInfo.typeName, and TypeInfo.typeNamespace.
UserDataHandler: The UserDataHandler interface has one method, UserDataHandler.handle(operation, key, data, src, dst), and four constants: UserDataHandler.NODE_CLONED, UserDataHandler.NODE_IMPORTED, UserDataHandler.NODE_DELETED, and UserDataHandler.NODE_RENAMED.
DOMError: The DOMError interface has six attributes: DOMError.severity, DOMError.message, DOMError.type, DOMError.relatedException, DOMError.relatedData, and DOMError.location. It has four constants: DOMError.SEVERITY_WARNING, DOMError.SEVERITY_ERROR, and DOMError.SEVERITY_FATAL_ERROR.
DOMErrorHandler: The DOMErrorHandler interface has one method: DOMErrorHandler.handleError(error).
DOMLocator: The DOMLocator interface has seven attributes: DOMLocator.lineNumber, DOMLocator.columnNumber, DOMLocator.byteOffset, DOMLocator.utf16Offset, DOMLocator.relatedNode, DOMLocator.uri, and DOMLocator.lineNumber.
DOMConfiguration: The DOMConfiguration interface has one attribute: DOMConfiguration.parameterNames. It also has three methods: DOMConfiguration.setParameter(name, value), DOMConfiguration.getParameter(name), and DOMConfiguration.canSetParameter(name, value).

A.6 Objects

This specification defines one object, only provided in the bindings:

DOMImplementationRegistry: The DOMImplementationRegistry object has two methods, DOMImplementationRegistry.getDOMImplementation(features), and DOMImplementationRegistry.getDOMImplementationList(features).