feat: added forEach method for NodeLists

Author: vardumper

docs/phpmd.md

@@ -13,4 +13,4 @@ layout: home
 ## Design
 
 
-Fri Nov 28 18:29:15 CET 2025
+Fri Nov 28 18:57:10 CET 2025

src/Delegator/NodeListDelegator.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace Html\Delegator;
 
 use AllowDynamicProperties;
@@ -144,4 +146,15 @@ final public function count(): int
     {
         return $this->delegated->length;
     }
+
+    /**
+     * Applies callback to each item in the node list.
+     * @param callable $callback function($element, $index, $list)
+     */
+    public function forEach(callable $callback): void
+    {
+        foreach ($this as $i => $item) {
+            $callback($item, $i, $this);
+        }
+    }
 }

tests/Delegator/NodeListDelegatorTest.php

@@ -39,7 +39,8 @@
     $element = $document->createElement('div', 'example content');
     $document->appendChild($element);
     $item = $delegator->item(0);
-    expect($item instanceof NodeDelegator || strpos(get_class($item), 'Html\\Element\\') === 0)->toBeTrue();
+    expect($item instanceof NodeDelegator || strpos(get_class($item), 'Html\\Element\\') === 0)
+        ->toBeTrue();
 });
 
 test('item count', function () {
@@ -76,3 +77,21 @@
     expect(iterator_to_array($delegator->getIterator()))
         ->toHaveCount(0);
 });
+
+test('forEach applies callback to all elements', function () {
+    $document = HTMLDocumentDelegator::createEmpty();
+    $a1 = $document->createElement('a');
+    $a2 = $document->createElement('a');
+    $document->appendChild($a1);
+    $document->appendChild($a2);
+    $list = new NodeListDelegator($document->documentElement->getElementsByTagName('a'));
+    $list->forEach(function ($element, $i) {
+        $element->setAttribute('data-tracking-id', 'id-' . $i);
+    });
+    $ids = [];
+    foreach ($list as $i => $el) {
+        $ids[] = $el->getAttribute('data-tracking-id');
+    }
+    expect($ids)
+        ->toBe(['id-0', 'id-1']);
+});