@xmldom/xmldom 0.9.1 → 0.9.2

package/CHANGELOG.md

@@ -4,6 +4,19 @@ 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
+
+- add `Element.getElementsByClassName` [`#722`](https://github.com/xmldom/xmldom/pull/722)
+
+### Fixed
+
+- add missing types for `Document.documentElement` and `Element.tagName` [`#721`](https://github.com/xmldom/xmldom/pull/721) [`#720`](https://github.com/xmldom/xmldom/issues/720)
+
+Thank you, [@censujiang](https://github.com/censujiang), [@Mathias-S](https://github.com/Mathias-S), for your contributions
+
+
 ## [0.9.1](https://github.com/xmldom/xmldom/compare/0.9.0...0.9.1)
 
 ### Fixed
@@ -16,8 +29,7 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 - minimum tested node version is 14 [`#710`](https://github.com/xmldom/xmldom/pull/710)
 
-Thank you, [@krystofwoldrich](https://github.com/krystofwoldrich), [@marvinruder](https://github.com/marvinruder), 
-[@amacneil](https://github.com/amacneil), [@defunctzombie](https://github.com/defunctzombie), 
+Thank you, [@krystofwoldrich](https://github.com/krystofwoldrich), [@marvinruder](https://github.com/marvinruder), [@amacneil](https://github.com/amacneil), [@defunctzombie](https://github.com/defunctzombie), 
 [@tjhorner](https://github.com/tjhorner), [@danon](https://github.com/danon), for your contributions
 
 

package/index.d.ts

@@ -770,6 +770,13 @@ declare module '@xmldom/xmldom' {
 
 		/** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/attributes) */
 		readonly attributes: NamedNodeMap;
+		/**
+		 * Returns the HTML-uppercased qualified name.
+		 *
+		 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/tagName)
+		 */
+		readonly tagName: string;
+
 		/**
 		 * Returns element's first attribute whose qualified name is qualifiedName, and null if there
 		 * is no such attribute otherwise.
@@ -797,7 +804,22 @@ declare module '@xmldom/xmldom' {
 			namespace: string | null,
 			localName: string
 		): Attr | null;
-		/** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/getBoundingClientRect) */
+		/**
+		 * Returns a LiveNodeList of all child elements which have **all** of the given class
+		 * name(s).
+		 *
+		 * Returns an empty list if `classNames` is an empty string or only contains HTML white space
+		 * characters.
+		 *
+		 * Warning: This returns a live LiveNodeList.
+		 * Changes in the DOM will reflect in the array as the changes occur.
+		 * If an element selected by this array no longer qualifies for the selector,
+		 * it will automatically be removed. Be aware of this for iteration purposes.
+		 *
+		 * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/getElementsByClassName
+		 * @see https://dom.spec.whatwg.org/#concept-getelementsbyclassname
+		 */
+		getElementsByClassName(classNames: string): LiveNodeList;
 
 		/**
 		 * Returns a LiveNodeList of elements with the given qualifiedName.
@@ -1067,6 +1089,12 @@ declare module '@xmldom/xmldom' {
 		readonly nodeName: '#document';
 		readonly nodeType: typeof Node.DOCUMENT_NODE;
 		readonly doctype: DocumentType | null;
+		/**
+		 * Gets a reference to the root node of the document.
+		 *
+		 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/documentElement)
+		 */
+		readonly documentElement: Element | null;
 
 		/**
 		 * Creates an attribute object with a specified name.
@@ -1105,7 +1133,6 @@ declare module '@xmldom/xmldom' {
 		 */
 		createDocumentFragment(): DocumentFragment;
 
-
 		createElement(tagName: string): Element;
 
 		/**
@@ -1128,10 +1155,7 @@ declare module '@xmldom/xmldom' {
 		 *
 		 * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/createElementNS)
 		 */
-		createElementNS(
-			namespace: string | null,
-			qualifiedName: string,
-		): Element;
+		createElementNS(namespace: string | null, qualifiedName: string): Element;
 
 		/**
 		 * Returns a ProcessingInstruction node whose target is target and data is data. If target does
@@ -1165,20 +1189,17 @@ declare module '@xmldom/xmldom' {
 		getElementById(elementId: string): Element | null;
 
 		/**
-		 * The `getElementsByClassName` method of `Document` interface returns an array-like object
-		 * of all child elements which have **all** of the given class name(s).
+		 * Returns a LiveNodeList of all child elements which have **all** of the given class
+		 * name(s).
 		 *
-		 * Returns an empty list if `classeNames` is an empty string or only contains HTML white
-		 * space characters.
+		 * Returns an empty list if `classNames` is an empty string or only contains HTML white space
+		 * characters.
 		 *
-		 * Warning: This is a live LiveNodeList.
+		 * Warning: This returns a live LiveNodeList.
 		 * Changes in the DOM will reflect in the array as the changes occur.
 		 * If an element selected by this array no longer qualifies for the selector,
 		 * it will automatically be removed. Be aware of this for iteration purposes.
 		 *
-		 * @param {string} classNames
-		 * Is a string representing the class name(s) to match; multiple class names are separated by
-		 * (ASCII-)whitespace.
 		 * @see https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementsByClassName
 		 * @see https://dom.spec.whatwg.org/#concept-getelementsbyclassname
 		 */

package/lib/dom.js

@@ -2003,51 +2003,6 @@ Document.prototype = {
 		return rtv;
 	},
 
-	/**
-	 * The `getElementsByClassName` method of `Document` interface returns an array-like object of
-	 * all child elements which have **all** of the given class name(s).
-	 *
-	 * Returns an empty list if `classeNames` is an empty string or only contains HTML white space
-	 * characters.
-	 *
-	 * Warning: This is a live LiveNodeList.
-	 * Changes in the DOM will reflect in the array as the changes occur.
-	 * If an element selected by this array no longer qualifies for the selector,
-	 * it will automatically be removed. Be aware of this for iteration purposes.
-	 *
-	 * @param {string} classNames
-	 * Is a string representing the class name(s) to match; multiple class names are separated by
-	 * (ASCII-)whitespace.
-	 * @see https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementsByClassName
-	 * @see https://dom.spec.whatwg.org/#concept-getelementsbyclassname
-	 */
-	getElementsByClassName: function (classNames) {
-		var classNamesSet = toOrderedSet(classNames);
-		return new LiveNodeList(this, function (base) {
-			var ls = [];
-			if (classNamesSet.length > 0) {
-				_visitNode(base.documentElement, function (node) {
-					if (node !== base && node.nodeType === ELEMENT_NODE) {
-						var nodeClassNames = node.getAttribute('class');
-						// can be null if the attribute does not exist
-						if (nodeClassNames) {
-							// before splitting and iterating just compare them for the most common case
-							var matches = classNames === nodeClassNames;
-							if (!matches) {
-								var nodeClassNamesSet = toOrderedSet(nodeClassNames);
-								matches = classNamesSet.every(arrayIncludes(nodeClassNamesSet));
-							}
-							if (matches) {
-								ls.push(node);
-							}
-						}
-					}
-				});
-			}
-			return ls;
-		});
-	},
-
 	/**
 	 * Creates a new `Element` that is owned by this `Document`.
 	 * In HTML Documents `localName` is the lower cased `tagName`,
@@ -2302,6 +2257,51 @@ Element.prototype = {
 		return this.attributes.getNamedItemNS(namespaceURI, localName);
 	},
 
+	/**
+	 * Returns a LiveNodeList of all child elements which have **all** of the given class name(s).
+	 *
+	 * Returns an empty list if `classNames` is an empty string or only contains HTML white space
+	 * characters.
+	 *
+	 * Warning: This returns a live LiveNodeList.
+	 * Changes in the DOM will reflect in the array as the changes occur.
+	 * If an element selected by this array no longer qualifies for the selector,
+	 * it will automatically be removed. Be aware of this for iteration purposes.
+	 *
+	 * @param {string} classNames
+	 * Is a string representing the class name(s) to match; multiple class names are separated by
+	 * (ASCII-)whitespace.
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/getElementsByClassName
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementsByClassName
+	 * @see https://dom.spec.whatwg.org/#concept-getelementsbyclassname
+	 */
+	getElementsByClassName: function (classNames) {
+		var classNamesSet = toOrderedSet(classNames);
+		return new LiveNodeList(this, function (base) {
+			var ls = [];
+			if (classNamesSet.length > 0) {
+				_visitNode(base, function (node) {
+					if (node !== base && node.nodeType === ELEMENT_NODE) {
+						var nodeClassNames = node.getAttribute('class');
+						// can be null if the attribute does not exist
+						if (nodeClassNames) {
+							// before splitting and iterating just compare them for the most common case
+							var matches = classNames === nodeClassNames;
+							if (!matches) {
+								var nodeClassNamesSet = toOrderedSet(nodeClassNames);
+								matches = classNamesSet.every(arrayIncludes(nodeClassNamesSet));
+							}
+							if (matches) {
+								ls.push(node);
+							}
+						}
+					}
+				});
+			}
+			return ls;
+		});
+	},
+
 	/**
 	 * Returns a LiveNodeList of elements with the given qualifiedName.
 	 * Searching for all descendants can be done by passing `*` as `qualifiedName`.
@@ -2365,6 +2365,7 @@ Element.prototype = {
 		});
 	},
 };
+Document.prototype.getElementsByClassName = Element.prototype.getElementsByClassName;
 Document.prototype.getElementsByTagName = Element.prototype.getElementsByTagName;
 Document.prototype.getElementsByTagNameNS = Element.prototype.getElementsByTagNameNS;
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xmldom/xmldom",
-	"version": "0.9.1",
+	"version": "0.9.2",
 	"description": "A pure JavaScript W3C standard-based (XML DOM Level 2 Core) DOMParser and XMLSerializer module.",
 	"keywords": [
 		"w3c",