@xmldom/xmldom 0.9.2 → 0.9.4

package/CHANGELOG.md

@@ -4,6 +4,55 @@ All notable changes to this project will be documented in this file.
 
 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.4](https://github.com/xmldom/xmldom/compare/0.9.3...0.9.4)
+
+### Fixed
+
+- restore performance for large amount of child nodes [`#748`](https://github.com/xmldom/xmldom/issues/748) /  [`#760`](https://github.com/xmldom/xmldom/pull/760)
+- types: correct error handler level to `warning` (#759) [`#754`](https://github.com/xmldom/xmldom/issues/754) / [`#759`](https://github.com/xmldom/xmldom/pull/759)
+
+### Docs
+
+- test: verify BOM handling [`#758`](https://github.com/xmldom/xmldom/pull/758)
+
+Thank you,
+[@luffynando](https://github.com/luffynando),
+[@mattiasw](https://github.com/mattiasw),
+[@JoinerDev](https://github.com/JoinerDev),
+for your contributions.
+
+
+## [0.9.3](https://github.com/xmldom/xmldom/compare/0.9.2...0.9.3)
+
+### Fixed
+
+- restore more `Node` and `ProcessingInstruction` types [`#725`](https://github.com/xmldom/xmldom/issues/725) / [`#726`](https://github.com/xmldom/xmldom/pull/726)
+- `getElements*` methods return `LiveNodeList<Element>` [`#731`](https://github.com/xmldom/xmldom/issues/731) / [`#734`](https://github.com/xmldom/xmldom/pull/734)
+- Add more missing `Node` props [`#728`](https://github.com/xmldom/xmldom/pull/728), triggered by unclosed [`#724`](https://github.com/xmldom/xmldom/pull/724)
+
+### Docs
+
+- Update supported runtimes in readme (NodeJS >= 14.6 and other [ES5 compatible runtimes](https://compat-table.github.io/compat-table/es5/))
+
+### Chore
+
+- updates devDependencies
+
+Thank you,
+[@Ponynjaa](https://github.com/Ponynjaa),
+[@ayZagen](https://github.com/ayZagen),
+[@sserdyuk](https://github.com/sserdyuk),
+[@wydengyre](https://github.com/wydengyre),
+[@mykola-mokhnach](https://github.com/mykola-mokhnach),
+[@benkroeger](https://github.com/benkroeger),
+for your contributions.
+
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
 ## [0.9.2](https://github.com/xmldom/xmldom/compare/0.9.1...0.9.2)
 
 ### Feature

package/index.d.ts

@@ -333,6 +333,11 @@ declare module '@xmldom/xmldom' {
 		// instanceof post ts 5.3
 		[Symbol.hasInstance](val: unknown): val is T;
 	};
+
+	type GetRootNodeOptions = {
+		composed?: boolean;
+	};
+
 	/**
 	 * The DOM Node interface is an abstract base class upon which many other DOM API objects are
 	 * based, thus letting those object types to be used similarly and often interchangeably. As an
@@ -350,8 +355,7 @@ declare module '@xmldom/xmldom' {
 	 * cannot have children will throw an exception.
 	 *
 	 * **This behavior is slightly different from the in the specs**:
-	 * - undeclared properties: nodeType, baseURI, isConnected, parentElement, textContent
-	 * - missing methods: contains, getRootNode, isEqualNode, isSameNode
+	 * - unimplemented interfaces: EventTarget
 	 *
 	 * @see http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-1950641247
 	 * @see https://dom.spec.whatwg.org/#node
@@ -380,6 +384,18 @@ declare module '@xmldom/xmldom' {
 		 * The local part of the qualified name of this node.
 		 */
 		localName: string | null;
+		/**
+		 * Always returns `about:blank` currently.
+		 *
+		 * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Node/baseURI)
+		 */
+		readonly baseURI: 'about:blank';
+		/**
+		 * Returns true if this node is inside of a document or is the document node itself.
+		 *
+		 * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Node/isConnected)
+		 */
+		readonly isConnected: boolean;
 		/**
 		 * The namespace URI of this node.
 		 */
@@ -396,6 +412,12 @@ declare module '@xmldom/xmldom' {
 		 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Node/nodeName)
 		 */
 		readonly nodeName: string;
+		/**
+		 * Returns the type of node.
+		 *
+		 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Node/nodeType)
+		 */
+		readonly nodeType: number;
 		/** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Node/nodeValue) */
 		nodeValue: string | null;
 		/**
@@ -410,6 +432,12 @@ declare module '@xmldom/xmldom' {
 		 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Node/parentNode)
 		 */
 		readonly parentNode: Node | null;
+		/**
+		 * Returns the parent `Node` if it is of type `Element`, otherwise `null`.
+		 *
+		 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Node/parentElement)
+		 */
+		readonly parentElement: Element | null;
 		/**
 		 * The prefix of the namespace for this node.
 		 */
@@ -420,10 +448,57 @@ declare module '@xmldom/xmldom' {
 		 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Node/previousSibling)
 		 */
 		readonly previousSibling: Node | null;
+		/** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Node/textContent) */
+		textContent: string | null;
+
+		/**
+		 * Zero based line position inside the parsed source,
+		 * if the `locator` was not disabled.
+		 */
+		lineNumber?: number;
+		/**
+		 * One based column position inside the parsed source,
+		 * if the `locator` was not disabled.
+		 */
+		columnNumber?: number;
 
 		/** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Node/appendChild) */
 		appendChild(node: Node): Node;
 
+		/**
+		 * Checks whether `other` is an inclusive descendant of this node.
+		 *
+		 * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Node/contains)
+		 */
+		contains(other: Node | null | undefined): boolean;
+		/**
+		 * Searches for the root node of this node.
+		 *
+		 * **This behavior is slightly different from the one in the specs**:
+		 * - ignores `options.composed`, since `ShadowRoot`s are unsupported, therefore always
+		 * returning root.
+		 *
+		 * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Node/getRootNode)
+		 *
+		 * @see https://dom.spec.whatwg.org/#dom-node-getrootnode
+		 * @see https://dom.spec.whatwg.org/#concept-shadow-including-root
+		 */
+		getRootNode(options: GetRootNodeOptions): Node;
+
+		/**
+		 * Checks whether the given node is equal to this node.
+		 *
+		 * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Node/isEqualNode)
+		 */
+		isEqualNode(other: Node): boolean;
+
+		/**
+		 * Checks whether the given node is this node.
+		 *
+		 * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Node/isSameNode)
+		 */
+		isSameNode(other: Node): boolean;
+
 		/**
 		 * Returns a copy of node. If deep is true, the copy also includes the node's descendants.
 		 *
@@ -618,23 +693,12 @@ declare module '@xmldom/xmldom' {
 		 * Get an attribute by name. Note: Name is in lower case in case of HTML namespace and
 		 * document.
 		 *
-		 * @param {string} localName
-		 * The local name of the attribute.
-		 * @returns {Attr | null}
-		 * The attribute with the given local name, or null if no such attribute exists.
 		 * @see https://dom.spec.whatwg.org/#concept-element-attributes-get-by-name
 		 */
 		getNamedItem(qualifiedName: string): Attr | null;
 		/**
 		 * Get an attribute by namespace and local name.
 		 *
-		 * @param {string | null} namespaceURI
-		 * The namespace URI of the attribute.
-		 * @param {string} localName
-		 * The local name of the attribute.
-		 * @returns {Attr | null}
-		 * The attribute with the given namespace URI and local name, or null if no such attribute
-		 * exists.
 		 * @see https://dom.spec.whatwg.org/#concept-element-attributes-get-by-namespace
 		 */
 		getNamedItemNS(namespace: string | null, localName: string): Attr | null;
@@ -644,10 +708,6 @@ declare module '@xmldom/xmldom' {
 		/**
 		 * Removes an attribute specified by the local name.
 		 *
-		 * @param {string} localName
-		 * The local name of the attribute to be removed.
-		 * @returns {Attr}
-		 * The attribute node that was removed.
 		 * @throws {DOMException}
 		 * With code:
 		 * - {@link DOMException.NOT_FOUND_ERR} if no attribute with the given name is found.
@@ -658,12 +718,6 @@ declare module '@xmldom/xmldom' {
 		/**
 		 * Removes an attribute specified by the namespace and local name.
 		 *
-		 * @param {string | null} namespaceURI
-		 * The namespace URI of the attribute to be removed.
-		 * @param {string} localName
-		 * The local name of the attribute to be removed.
-		 * @returns {Attr}
-		 * The attribute node that was removed.
 		 * @throws {DOMException}
 		 * With code:
 		 * - {@link DOMException.NOT_FOUND_ERR} if no attribute with the given namespace URI and
@@ -675,11 +729,6 @@ declare module '@xmldom/xmldom' {
 		/**
 		 * Set an attribute.
 		 *
-		 * @param {Attr} attr
-		 * The attribute to set.
-		 * @returns {Attr | null}
-		 * The old attribute with the same local name and namespace URI as the new one, or null if no
-		 * such attribute exists.
 		 * @throws {DOMException}
 		 * With code:
 		 * - {@link INUSE_ATTRIBUTE_ERR} - If the attribute is already an attribute of another
@@ -691,11 +740,6 @@ declare module '@xmldom/xmldom' {
 		 * Set an attribute, replacing an existing attribute with the same local name and namespace
 		 * URI if one exists.
 		 *
-		 * @param {Attr} attr
-		 * The attribute to set.
-		 * @returns {Attr | null}
-		 * The old attribute with the same local name and namespace URI as the new one, or null if no
-		 * such attribute exists.
 		 * @throws {DOMException}
 		 * Throws a DOMException with the name "InUseAttributeError" if the attribute is already an
 		 * attribute of another element.
@@ -712,7 +756,7 @@ declare module '@xmldom/xmldom' {
 	 *
 	 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/NodeList)
 	 */
-	class NodeList implements Iterable<Node> {
+	class NodeList<T extends Node = Node> implements Iterable<T> {
 		/**
 		 * Returns the number of nodes in the collection.
 		 *
@@ -724,34 +768,40 @@ declare module '@xmldom/xmldom' {
 		 *
 		 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/NodeList/item)
 		 */
-		item(index: number): Node | null;
+		item(index: number): T | null;
 		/**
 		 * Returns a string representation of the NodeList.
 		 */
-		toString(nodeFilter: (node: Node) => Node | undefined): string;
+		toString(nodeFilter: (node: T) => T | undefined): string;
 		/**
 		 * Filters the NodeList based on a predicate.
 		 *
 		 * @private
 		 */
-		filter(predicate: (node: Node) => boolean): Node[];
+		filter(predicate: (node: T) => boolean): T[];
 		/**
 		 * Returns the first index at which a given node can be found in the NodeList, or -1 if it is
 		 * not present.
 		 *
 		 * @private
 		 */
-		indexOf(node: Node): number;
-		[index: number]: Node | undefined;
+		indexOf(node: T): number;
 
-		[Symbol.iterator](): Iterator<Node>;
+		/**
+		 * Index based access returns `undefined`, when accessing indexes >= `length`.
+		 * But it would break a lot of code (like `Array.from` usages),
+		 * if it would be typed as `T | undefined`.
+		 */
+		[index: number]: T;
+
+		[Symbol.iterator](): Iterator<T>;
 	}
 
 	/**
 	 * Represents a live collection of nodes that is automatically updated when its associated
 	 * document changes.
 	 */
-	interface LiveNodeList extends NodeList {}
+	interface LiveNodeList<T extends Node = Node> extends NodeList<T> {}
 	/**
 	 * Represents a live collection of nodes that is automatically updated when its associated
 	 * document changes.
@@ -819,7 +869,7 @@ declare module '@xmldom/xmldom' {
 		 * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/getElementsByClassName
 		 * @see https://dom.spec.whatwg.org/#concept-getelementsbyclassname
 		 */
-		getElementsByClassName(classNames: string): LiveNodeList;
+		getElementsByClassName(classNames: string): LiveNodeList<Element>;
 
 		/**
 		 * Returns a LiveNodeList of elements with the given qualifiedName.
@@ -843,7 +893,7 @@ declare module '@xmldom/xmldom' {
 		 * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/getElementsByTagName
 		 * @see https://dom.spec.whatwg.org/#concept-getelementsbytagname
 		 */
-		getElementsByTagName(qualifiedName: string): LiveNodeList;
+		getElementsByTagName(qualifiedName: string): LiveNodeList<Element>;
 
 		/**
 		 * Returns a `LiveNodeList` of elements with the given tag name belonging to the given
@@ -855,7 +905,7 @@ declare module '@xmldom/xmldom' {
 		getElementsByTagNameNS(
 			namespaceURI: string | null,
 			localName: string
-		): LiveNodeList;
+		): LiveNodeList<Element>;
 
 		getQualifiedName(): string;
 		/**
@@ -956,12 +1006,7 @@ declare module '@xmldom/xmldom' {
 	 *
 	 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CharacterData)
 	 */
-	var CharacterData: {
-		// instanceof pre ts 5.3
-		(val: unknown): val is CharacterData;
-		// instanceof post ts 5.3
-		[Symbol.hasInstance](val: unknown): val is CharacterData;
-	};
+	var CharacterData: InstanceOf<CharacterData>;
 
 	/**
 	 * The textual content of Element or Attr. If an element has no markup within its content, it has
@@ -1059,8 +1104,20 @@ declare module '@xmldom/xmldom' {
 	}
 	var Notation: InstanceOf<Notation>;
 
-	interface ProcessingInstruction extends Node {
+	interface ProcessingInstruction extends CharacterData {
 		nodeType: typeof Node.PROCESSING_INSTRUCTION_NODE;
+		/**
+		 * A string representing the textual data contained in this object.
+		 * For `ProcessingInstruction`, that means everything that goes after the `target`, excluding
+		 * `?>`.
+		 *
+		 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CharacterData/data)
+		 */
+		data: string;
+		/**
+		 * A string containing the name of the application.
+		 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ProcessingInstruction/target) */
+		readonly target: string;
 	}
 	var ProcessingInstruction: InstanceOf<ProcessingInstruction>;
 
@@ -1081,7 +1138,6 @@ declare module '@xmldom/xmldom' {
 		/**
 		 * The implementation that created this document.
 		 *
-		 * @type DOMImplementation
 		 * @readonly
 		 */
 		readonly implementation: DOMImplementation;
@@ -1099,9 +1155,6 @@ declare module '@xmldom/xmldom' {
 		/**
 		 * Creates an attribute object with a specified name.
 		 *
-		 * @param name
-		 * String that sets the attribute object's name.
-		 *
 		 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/createAttribute)
 		 */
 		createAttribute(localName: string): Attr;
@@ -1119,9 +1172,6 @@ declare module '@xmldom/xmldom' {
 		/**
 		 * Creates a comment object with the specified data.
 		 *
-		 * @param data
-		 * Sets the comment object's data.
-		 *
 		 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/createComment)
 		 */
 		createComment(data: string): Comment;
@@ -1156,6 +1206,23 @@ declare module '@xmldom/xmldom' {
 		 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/createElementNS)
 		 */
 		createElementNS(namespace: string | null, qualifiedName: string): Element;
+		/**
+		 * Creates an EntityReference object.
+		 * The current implementation does not fill the `childNodes` with those of the corresponding
+		 * `Entity`
+		 *
+		 * The name of the entity to reference. No namespace well-formedness checks are performed.
+		 *
+		 * @deprecated
+		 * In DOM Level 4.
+		 * @returns {EntityReference}
+		 * @throws {DOMException}
+		 * With code `INVALID_CHARACTER_ERR` when `name` is not valid.
+		 * @throws {DOMException}
+		 * with code `NOT_SUPPORTED_ERR` when the document is of type `html`
+		 * @see https://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-392B75AE
+		 */
+		createEntityReference(name: string): EntityReference;
 
 		/**
 		 * Returns a ProcessingInstruction node whose target is target and data is data. If target does
@@ -1182,9 +1249,6 @@ declare module '@xmldom/xmldom' {
 
 		/**
 		 * Returns a reference to the first object with the specified value of the ID attribute.
-		 *
-		 * @param elementId
-		 * String that specifies the ID value.
 		 */
 		getElementById(elementId: string): Element | null;
 
@@ -1203,7 +1267,7 @@ declare module '@xmldom/xmldom' {
 		 * @see https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementsByClassName
 		 * @see https://dom.spec.whatwg.org/#concept-getelementsbyclassname
 		 */
-		getElementsByClassName(classNames: string): LiveNodeList;
+		getElementsByClassName(classNames: string): LiveNodeList<Element>;
 
 		/**
 		 * Returns a LiveNodeList of elements with the given qualifiedName.
@@ -1227,7 +1291,7 @@ declare module '@xmldom/xmldom' {
 		 * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/getElementsByTagName
 		 * @see https://dom.spec.whatwg.org/#concept-getelementsbytagname
 		 */
-		getElementsByTagName(qualifiedName: string): LiveNodeList;
+		getElementsByTagName(qualifiedName: string): LiveNodeList<Element>;
 
 		/**
 		 * Returns a `LiveNodeList` of elements with the given tag name belonging to the given
@@ -1242,7 +1306,7 @@ declare module '@xmldom/xmldom' {
 		getElementsByTagNameNS(
 			namespaceURI: string | null,
 			localName: string
-		): LiveNodeList;
+		): LiveNodeList<Element>;
 		/**
 		 * Returns a copy of node. If deep is true, the copy also includes the node's descendants.
 		 *
@@ -1368,7 +1432,6 @@ declare module '@xmldom/xmldom' {
 	class XMLSerializer {
 		serializeToString(node: Node, nodeFilter?: (node: Node) => boolean): string;
 	}
-
 	// END ./lib/dom.js
 
 	// START ./lib/dom-parser.js
@@ -1502,7 +1565,11 @@ declare module '@xmldom/xmldom' {
 	}
 
 	interface ErrorHandlerFunction {
-		(level: 'warn' | 'error' | 'fatalError', msg: string, context: any): void;
+		(
+			level: 'warning' | 'error' | 'fatalError',
+			msg: string,
+			context: any
+		): void;
 	}
 
 	/**

package/lib/dom.js

@@ -22,6 +22,7 @@ var PDC = Symbol();
 
 var errors = require('./errors');
 var DOMException = errors.DOMException;
+var DOMExceptionName = errors.DOMExceptionName;
 
 var g = require('./grammar');
 
@@ -870,7 +871,7 @@ DOMImplementation.prototype = {
 	 * Creates an empty DocumentType node. Entity declarations and notations are not made
 	 * available. Entity reference expansions and default attribute additions do not occur.
 	 *
-	 * **This behavior is slightly different from the in the specs**:
+	 * **This behavior is slightly different from the one in the specs**:
 	 * - `encoding`, `mode`, `origin`, `url` fields are currently not declared.
 	 * - `publicId` and `systemId` contain the raw data including any possible quotes,
 	 *   so they can always be serialized back to the original value
@@ -919,6 +920,7 @@ DOMImplementation.prototype = {
 		node.publicId = publicId || '';
 		node.systemId = systemId || '';
 		node.internalSubset = internalSubset || '';
+		node.childNodes = new NodeList();
 
 		return node;
 	},
@@ -979,8 +981,7 @@ DOMImplementation.prototype = {
  * cannot have children will throw an exception.
  *
  * **This behavior is slightly different from the in the specs**:
- * - undeclared properties: nodeType, baseURI, isConnected, parentElement, textContent
- * - missing methods: contains, getRootNode, isEqualNode, isSameNode
+ * - unimplemented interfaces: `EventTarget`
  *
  * @class
  * @abstract
@@ -1024,10 +1025,18 @@ Node.prototype = {
 	 * @type {Node | null}
 	 */
 	parentNode: null,
+	/**
+	 * The parent element of this node.
+	 *
+	 * @type {Element | null}
+	 */
+	get parentElement() {
+		return this.parentNode && this.parentNode.nodeType === this.ELEMENT_NODE ? this.parentNode : null;
+	},
 	/**
 	 * The child nodes of this node.
 	 *
-	 * @type {NodeList | null}
+	 * @type {NodeList}
 	 */
 	childNodes: null,
 	/**
@@ -1060,6 +1069,131 @@ Node.prototype = {
 	 * @type {string | null}
 	 */
 	localName: null,
+	/**
+	 * The baseURI is currently always `about:blank`,
+	 * since that's what happens when you create a document from scratch.
+	 *
+	 * @type {'about:blank'}
+	 */
+	baseURI: 'about:blank',
+	/**
+	 * Is true if this node is part of a document.
+	 *
+	 * @type {boolean}
+	 */
+	get isConnected() {
+		var rootNode = this.getRootNode();
+		return rootNode && rootNode.nodeType === rootNode.DOCUMENT_NODE;
+	},
+	/**
+	 * Checks whether `other` is an inclusive descendant of this node.
+	 *
+	 * @param {Node | null | undefined} other
+	 * The node to check.
+	 * @returns {boolean}
+	 * True if `other` is an inclusive descendant of this node; false otherwise.
+	 * @see https://dom.spec.whatwg.org/#dom-node-contains
+	 */
+	contains: function (other) {
+		if (!other) return false;
+		var parent = other;
+		do {
+			if (this === parent) return true;
+			parent = other.parentNode;
+		} while (parent);
+		return false;
+	},
+	/**
+	 * @typedef GetRootNodeOptions
+	 * @property {boolean} [composed=false]
+	 */
+	/**
+	 * Searches for the root node of this node.
+	 *
+	 * **This behavior is slightly different from the in the specs**:
+	 * - ignores `options.composed`, since `ShadowRoot`s are unsupported, always returns root.
+	 *
+	 * @param {GetRootNodeOptions} [options]
+	 * @returns {Node}
+	 * Root node.
+	 * @see https://dom.spec.whatwg.org/#dom-node-getrootnode
+	 * @see https://dom.spec.whatwg.org/#concept-shadow-including-root
+	 */
+	getRootNode: function (options) {
+		var parent = this;
+		do {
+			if (!parent.parentNode) {
+				return parent;
+			}
+			parent = parent.parentNode;
+		} while (parent);
+	},
+	/**
+	 * Checks whether the given node is equal to this node.
+	 *
+	 * @param {Node} [otherNode]
+	 * @see https://dom.spec.whatwg.org/#concept-node-equals
+	 */
+	isEqualNode: function (otherNode) {
+		if (!otherNode) return false;
+
+		if (this.nodeType !== otherNode.nodeType) return false;
+
+		switch (this.nodeType) {
+			case this.DOCUMENT_TYPE_NODE:
+				if (this.name !== otherNode.name) return false;
+				if (this.publicId !== otherNode.publicId) return false;
+				if (this.systemId !== otherNode.systemId) return false;
+				break;
+			case this.ELEMENT_NODE:
+				if (this.namespaceURI !== otherNode.namespaceURI) return false;
+				if (this.prefix !== otherNode.prefix) return false;
+				if (this.localName !== otherNode.localName) return false;
+				if (this.attributes.length !== otherNode.attributes.length) return false;
+				for (var i = 0; i < this.attributes.length; i++) {
+					var attr = this.attributes.item(i);
+					if (!attr.isEqualNode(otherNode.getAttributeNodeNS(attr.namespaceURI, attr.localName))) {
+						return false;
+					}
+				}
+				break;
+			case this.ATTRIBUTE_NODE:
+				if (this.namespaceURI !== otherNode.namespaceURI) return false;
+				if (this.localName !== otherNode.localName) return false;
+				if (this.value !== otherNode.value) return false;
+
+				break;
+			case this.PROCESSING_INSTRUCTION_NODE:
+				if (this.target !== otherNode.target || this.data !== otherNode.data) {
+					return false;
+				}
+				break;
+			case this.TEXT_NODE:
+			case this.COMMENT_NODE:
+				if (this.data !== otherNode.data) return false;
+				break;
+		}
+
+		if (this.childNodes.length !== otherNode.childNodes.length) {
+			return false;
+		}
+
+		for (var i = 0; i < this.childNodes.length; i++) {
+			if (!this.childNodes[i].isEqualNode(otherNode.childNodes[i])) {
+				return false;
+			}
+		}
+
+		return true;
+	},
+	/**
+	 * Checks whether or not the given node is this node.
+	 *
+	 * @param {Node} [otherNode]
+	 */
+	isSameNode: function (otherNode) {
+		return this === otherNode;
+	},
 	/**
 	 * Inserts a node before a reference node as a child of this node.
 	 *
@@ -1545,7 +1679,6 @@ function _removeChild(parentNode, child) {
 	if (parentNode !== child.parentNode) {
 		throw new DOMException(DOMException.NOT_FOUND_ERR, "child's parent is not parent");
 	}
-	//var index = parentNode.childNodes.
 	var oldPreviousSibling = child.previousSibling;
 	var oldNextSibling = child.nextSibling;
 	if (oldPreviousSibling) {
@@ -1587,12 +1720,13 @@ function hasValidParentNodeType(node) {
 function hasInsertableNodeType(node) {
 	return (
 		node &&
-		(isElementNode(node) ||
-			node instanceof CharacterData ||
-			isDocTypeNode(node) ||
-			node.nodeType === Node.DOCUMENT_FRAGMENT_NODE ||
+		(node.nodeType === Node.CDATA_SECTION_NODE ||
 			node.nodeType === Node.COMMENT_NODE ||
-			node.nodeType === Node.PROCESSING_INSTRUCTION_NODE)
+			node.nodeType === Node.DOCUMENT_FRAGMENT_NODE ||
+			node.nodeType === Node.DOCUMENT_TYPE_NODE ||
+			node.nodeType === Node.ELEMENT_NODE ||
+			node.nodeType === Node.PROCESSING_INSTRUCTION_NODE ||
+			node.nodeType === Node.TEXT_NODE)
 	);
 }
 
@@ -1920,11 +2054,11 @@ function _insertBefore(parent, node, child, _inDocumentAssertion) {
 	do {
 		newFirst.parentNode = parent;
 	} while (newFirst !== newLast && (newFirst = newFirst.nextSibling));
-	_onUpdateChild(parent.ownerDocument || parent, parent);
-	//console.log(parent.lastChild.nextSibling == null)
+	_onUpdateChild(parent.ownerDocument || parent, parent, node);
 	if (node.nodeType == DOCUMENT_FRAGMENT_NODE) {
 		node.firstChild = node.lastChild = null;
 	}
+
 	return node;
 }
 
@@ -2038,33 +2172,57 @@ Document.prototype = {
 		attrs._ownerElement = node;
 		return node;
 	},
+	/**
+	 * @returns {DocumentFragment}
+	 */
 	createDocumentFragment: function () {
 		var node = new DocumentFragment(PDC);
 		node.ownerDocument = this;
 		node.childNodes = new NodeList();
 		return node;
 	},
+	/**
+	 * @param {string} data
+	 * @returns {Text}
+	 */
 	createTextNode: function (data) {
 		var node = new Text(PDC);
 		node.ownerDocument = this;
+		node.childNodes = new NodeList();
 		node.appendData(data);
 		return node;
 	},
+	/**
+	 * @param {string} data
+	 * @returns {Comment}
+	 */
 	createComment: function (data) {
 		var node = new Comment(PDC);
 		node.ownerDocument = this;
+		node.childNodes = new NodeList();
 		node.appendData(data);
 		return node;
 	},
+	/**
+	 * @param {string} data
+	 * @returns {CDATASection}
+	 */
 	createCDATASection: function (data) {
 		var node = new CDATASection(PDC);
 		node.ownerDocument = this;
+		node.childNodes = new NodeList();
 		node.appendData(data);
 		return node;
 	},
+	/**
+	 * @param {string} target
+	 * @param {string} data
+	 * @returns {ProcessingInstruction}
+	 */
 	createProcessingInstruction: function (target, data) {
 		var node = new ProcessingInstruction(PDC);
 		node.ownerDocument = this;
+		node.childNodes = new NodeList();
 		node.nodeName = node.target = target;
 		node.nodeValue = node.data = data;
 		return node;
@@ -2095,19 +2253,49 @@ Document.prototype = {
 	_createAttribute: function (name) {
 		var node = new Attr(PDC);
 		node.ownerDocument = this;
+		node.childNodes = new NodeList();
 		node.name = name;
 		node.nodeName = name;
 		node.localName = name;
 		node.specified = true;
 		return node;
 	},
+	/**
+	 * Creates an EntityReference object.
+	 * The current implementation does not fill the `childNodes` with those of the corresponding
+	 * `Entity`
+	 *
+	 * @deprecated
+	 * In DOM Level 4.
+	 * @param {string} name
+	 * The name of the entity to reference. No namespace well-formedness checks are performed.
+	 * @returns {EntityReference}
+	 * @throws {DOMException}
+	 * With code `INVALID_CHARACTER_ERR` when `name` is not valid.
+	 * @throws {DOMException}
+	 * with code `NOT_SUPPORTED_ERR` when the document is of type `html`
+	 * @see https://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-392B75AE
+	 */
 	createEntityReference: function (name) {
+		if (!g.Name.test(name)) {
+			throw new DOMException(DOMException.INVALID_CHARACTER_ERR, 'not a valid xml name "' + name + '"');
+		}
+		if (this.type === 'html') {
+			throw new DOMException('document is an html document', DOMExceptionName.NotSupportedError);
+		}
+
 		var node = new EntityReference(PDC);
 		node.ownerDocument = this;
+		node.childNodes = new NodeList();
 		node.nodeName = name;
 		return node;
 	},
 	// Introduced in DOM Level 2:
+	/**
+	 * @param {string} namespaceURI
+	 * @param {string} qualifiedName
+	 * @returns {Element}
+	 */
 	createElementNS: function (namespaceURI, qualifiedName) {
 		var validated = validateAndExtract(namespaceURI, qualifiedName);
 		var node = new Element(PDC);
@@ -2123,10 +2311,16 @@ Document.prototype = {
 		return node;
 	},
 	// Introduced in DOM Level 2:
+	/**
+	 * @param {string} namespaceURI
+	 * @param {string} qualifiedName
+	 * @returns {Attr}
+	 */
 	createAttributeNS: function (namespaceURI, qualifiedName) {
 		var validated = validateAndExtract(namespaceURI, qualifiedName);
 		var node = new Attr(PDC);
 		node.ownerDocument = this;
+		node.childNodes = new NodeList();
 		node.nodeName = qualifiedName;
 		node.name = qualifiedName;
 		node.specified = true;
@@ -2481,7 +2675,7 @@ function ProcessingInstruction(symbol) {
 	checkSymbol(symbol);
 }
 ProcessingInstruction.prototype.nodeType = PROCESSING_INSTRUCTION_NODE;
-_extends(ProcessingInstruction, Node);
+_extends(ProcessingInstruction, CharacterData);
 function XMLSerializer() {}
 XMLSerializer.prototype.serializeToString = function (node, nodeFilter) {
 	return nodeSerializeToString.call(node, nodeFilter);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xmldom/xmldom",
-	"version": "0.9.2",
+	"version": "0.9.4",
 	"description": "A pure JavaScript W3C standard-based (XML DOM Level 2 Core) DOMParser and XMLSerializer module.",
 	"keywords": [
 		"w3c",
@@ -40,22 +40,22 @@
 		"release": "np --no-yarn --test-script testrelease"
 	},
 	"engines": {
-		"node": ">=14.0.0"
+		"node": ">=14.6"
 	},
 	"devDependencies": {
 		"@homer0/prettier-plugin-jsdoc": "9.0.2",
 		"@jazzer.js/core": "2.1.0",
 		"@jazzer.js/jest-runner": "2.1.0",
-		"auto-changelog": "2.4.0",
-		"eslint": "8.57.0",
+		"auto-changelog": "2.5.0",
+		"eslint": "8.57.1",
 		"eslint-config-prettier": "9.1.0",
 		"eslint-plugin-anti-trojan-source": "1.1.1",
 		"eslint-plugin-es5": "1.5.0",
-		"eslint-plugin-n": "17.10.2",
+		"eslint-plugin-n": "17.11.1",
 		"eslint-plugin-prettier": "5.2.1",
 		"get-stream": "6.0.1",
 		"jest": "29.7.0",
-		"nodemon": "3.1.4",
+		"nodemon": "3.1.7",
 		"np": "8.0.4",
 		"prettier": "3.3.3",
 		"rxjs": "7.8.1",

package/readme.md

@@ -34,7 +34,7 @@ xmldom is a javascript [ponyfill](https://ponyfill.com/) to provide the followin
   new XMLSerializer().serializeToString(node) => string
   ```
 
-The target runtimes `xmldom` supports are currently Node >= v10 (ES5) and Rhino ([not tested as part of CI](https://github.com/xmldom/xmldom/discussions/214)).
+The target runtimes `xmldom` supports are currently Node >= v14.6 (and very likely any other [ES5 compatible runtime](https://compat-table.github.io/compat-table/es5/)).
 
 When deciding how to fix bugs or implement features, `xmldom` tries to stay as close  as possible to the various [related specifications/standards](#specs).  
 As indicated by the version starting with `0.`, this implementation is not feature complete and some implemented features differ from what the specifications describe.  
@@ -99,7 +99,7 @@ import { DOMParser } from '@xmldom/xmldom'
   readonly class properties (aka `NodeType`),  
   these can be accessed from any `Node` instance `node`:  
   `if (node.nodeType === node.ELEMENT_NODE) {...`
-  
+
     1. `ELEMENT_NODE` (`1`)
     2. `ATTRIBUTE_NODE` (`2`)
     3. `TEXT_NODE` (`3`)
@@ -112,14 +112,14 @@ import { DOMParser } from '@xmldom/xmldom'
     10. `DOCUMENT_TYPE_NODE` (`10`)
     11. `DOCUMENT_FRAGMENT_NODE` (`11`)
     12. `NOTATION_NODE` (`12`)
-  
+
   attribute:
-    - `nodeValue` | `prefix`
-  
+    - `nodeValue` | `prefix` | `textContent`
+
   readonly attribute:
-    - `nodeName` | `nodeType` | `parentNode` | `childNodes` | `firstChild` | `lastChild` | `previousSibling` | `nextSibling` | `attributes` | `ownerDocument` | `namespaceURI` | `localName`
-  
-  method:	
+    - `nodeName` | `nodeType` | `parentNode` | `parentElement` | `childNodes` | `firstChild` | `lastChild` | `previousSibling` | `nextSibling` | `attributes` | `ownerDocument` | `namespaceURI` | `localName` | `isConnected` | `baseURI`
+
+  method:
     * `insertBefore(newChild, refChild)`
     * `replaceChild(newChild, oldChild)`
     * `removeChild(oldChild)`
@@ -127,6 +127,10 @@ import { DOMParser } from '@xmldom/xmldom'
     * `hasChildNodes()`
     * `cloneNode(deep)`
     * `normalize()`
+    * `contains(otherNode)`
+    * `getRootNode()`
+    * `isEqualNode(otherNode)`
+    * `isSameNode(otherNode)`
     * `isSupported(feature, version)`
     * `hasAttributes()`
 * [DOMException](http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/ecma-script-binding.html)
@@ -149,7 +153,7 @@ import { DOMParser } from '@xmldom/xmldom'
   - `INVALID_MODIFICATION_ERR` (`13`)
   - `NAMESPACE_ERR` (`14`)
   - `INVALID_ACCESS_ERR` (`15`)
-   
+
   attributes:
   -  `code` with a value matching one of the above constants.
 
@@ -183,7 +187,7 @@ import { DOMParser } from '@xmldom/xmldom'
 
 * [DocumentFragment](http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-B63ED1A3) : Node
 * [Element](http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/core.html#ID-745549614) : Node
-		
+
   readonly attribute:
   - `tagName`
 
@@ -317,23 +321,23 @@ The original author claims that xmldom implements [DOM Level 2] in a "fully comp
 In the past, there have been multiple (even breaking) changes to align xmldom with the living standard,
 so if you find a difference that is not documented, any contribution to resolve the difference is very welcome (even just reporting it as an issue). 
 
-xmldom implements the following interfaces (only the ones marked with `*` are currently exposed):
-- `Attr` *
+xmldom implements the following interfaces:
+- `Attr`
 - `CDATASection`
 - `CharacterData`
 - `Comment`
-- `Document` *
+- `Document`
 - `DocumentFragment`
-- `DocumentType` *
-- `DOMException` * 
-- `DOMImplementation` *
-- `Element` *
+- `DocumentType`
+- `DOMException` 
+- `DOMImplementation`
+- `Element`
 - `Entity`
 - `EntityReference`
 - `LiveNodeList`
-- `NamedNodeMap` *
-- `Node` *
-- `NodeList` *
+- `NamedNodeMap`
+- `Node`
+- `NodeList`
 - `Notation`
 - `ProcessingInstruction`
 - `Text`