Added htmldoc::tag() to enable the tag name to be retrieved from the first item in a collection.

Added tests.

Author: hexydec

src/htmldoc.php

@@ -463,12 +463,26 @@ public function parent() : htmldoc {
 		return $doc->collection($nodes);
 	}
 
+	/**
+	 * Retrieves the tag name from the first tag object in the collection
+	 * 
+	 * @return ?string The name of the tag, or null if there are no tags in the collection
+	 */
+	public function tag() : ?string {
+		foreach ($this->children AS $item) {
+			if (\get_class($item) === 'hexydec\\html\\tag') {
+				return $item->tagName;
+			}
+		}
+		return null;
+	}
+
 	/**
 	 * Retrieves the specified attribute value from the first tag in the collection or update the attribute on all matching tags
 	 *
 	 * @param string $key The name of the attribute to retrieve
 	 * @param string $value The value of the attribute to update
-	 * @return string The value of the attribute or null if the attribute doesn't exist
+	 * @return ?string The value of the attribute or null if the attribute doesn't exist
 	 */
 	public function attr(string $key, ?string $value = null) : ?string {
 		foreach ($this->children AS $item) {

tests/findHtmldocTest.php

@@ -103,6 +103,16 @@ public function testCanTraverseElements() {
 		}
 	}
 
+	public function testCanReadTagNames() {
+		$doc = new htmldoc();
+		if ($doc->open(__DIR__.'/templates/find.html')) {
+			$this->assertEquals('div', $doc->find('.find')->tag());
+			$this->assertEquals('p', $doc->find('.find__paragraph')->tag());
+			$this->assertEquals('h1', $doc->find('.find__heading')->tag());
+			$this->assertEquals(null, $doc->find('.find__nothing')->tag());
+		}
+	}
+
 	public function testCanReadAttributes() {
 		$doc = new htmldoc();
 		if ($doc->open(__DIR__.'/templates/find.html')) {