[8.x] Add AssertableJson::each() method (#38684)

* add AssertableJson::each() method

* add tests for new method

Author: Gummibeer

src/Illuminate/Testing/Fluent/AssertableJson.php

@@ -117,6 +117,32 @@ public function first(Closure $callback): self
         return $this->scope($key, $callback);
     }
 
+    /**
+     * Instantiate a new "scope" on each child element.
+     *
+     * @param  \Closure  $callback
+     * @return $this
+     */
+    public function each(Closure $callback): self
+    {
+        $props = $this->prop();
+
+        $path = $this->dotPath();
+
+        PHPUnit::assertNotEmpty($props, $path === ''
+            ? 'Cannot scope directly onto each element of the root level because it is empty.'
+            : sprintf('Cannot scope directly onto each element of property [%s] because it is empty.', $path)
+        );
+
+        foreach (array_keys($props) as $key) {
+            $this->interactsWith($key);
+
+            $this->scope($key, $callback);
+        }
+
+        return $this;
+    }
+
     /**
      * Create a new instance from an array.
      *

tests/Testing/Fluent/AssertTest.php

@@ -699,6 +699,64 @@ public function testFirstScopeFailsWhenPropSingleValue()
         });
     }
 
+    public function testEachScope()
+    {
+        $assert = AssertableJson::fromArray([
+            'foo' => [
+                'key' => 'first',
+            ],
+            'bar' => [
+                'key' => 'second',
+            ],
+        ]);
+
+        $assert->each(function (AssertableJson $item) {
+            $item->whereType('key', 'string');
+        });
+    }
+
+    public function testEachScopeFailsWhenNoProps()
+    {
+        $assert = AssertableJson::fromArray([]);
+
+        $this->expectException(AssertionFailedError::class);
+        $this->expectExceptionMessage('Cannot scope directly onto each element of the root level because it is empty.');
+
+        $assert->each(function (AssertableJson $item) {
+            //
+        });
+    }
+
+    public function testEachNestedScopeFailsWhenNoProps()
+    {
+        $assert = AssertableJson::fromArray([
+            'foo' => [],
+        ]);
+
+        $this->expectException(AssertionFailedError::class);
+        $this->expectExceptionMessage('Cannot scope directly onto each element of property [foo] because it is empty.');
+
+        $assert->has('foo', function (AssertableJson $assert) {
+            $assert->each(function (AssertableJson $item) {
+                //
+            });
+        });
+    }
+
+    public function testEachScopeFailsWhenPropSingleValue()
+    {
+        $assert = AssertableJson::fromArray([
+            'foo' => 'bar',
+        ]);
+
+        $this->expectException(AssertionFailedError::class);
+        $this->expectExceptionMessage('Property [foo] is not scopeable.');
+
+        $assert->each(function (AssertableJson $item) {
+            //
+        });
+    }
+
     public function testFailsWhenNotInteractingWithAllPropsInScope()
     {
         $assert = AssertableJson::fromArray([