[12.x] feat: Add whereNull and whereNotNull to Assertablejson (#55131)

* add whereNull to AssertableJson

* add whereNotNull to AssertableJson

* whereNull custom exception message

* Update Matching.php

---------

Co-authored-by: Taylor Otwell <[email protected]>

Author: faissaloux

src/Illuminate/Testing/Fluent/Concerns/Matching.php

@@ -92,6 +92,52 @@ public function whereNot(string $key, $expected): self
         return $this;
     }
 
+    /**
+     * Asserts that the property is null.
+     *
+     * @param  string  $key
+     * @return $this
+     */
+    public function whereNull(string $key): self
+    {
+        $this->has($key);
+
+        $actual = $this->prop($key);
+
+        PHPUnit::assertNull(
+            $actual,
+            sprintf(
+                'Property [%s] should be null.',
+                $this->dotPath($key),
+            )
+        );
+
+        return $this;
+    }
+
+    /**
+     * Asserts that the property is not null.
+     *
+     * @param  string  $key
+     * @return $this
+     */
+    public function whereNotNull(string $key): self
+    {
+        $this->has($key);
+
+        $actual = $this->prop($key);
+
+        PHPUnit::assertNotNull(
+            $actual,
+            sprintf(
+                'Property [%s] should not be null.',
+                $this->dotPath($key),
+            )
+        );
+
+        return $this;
+    }
+
     /**
      * Asserts that all properties match their expected values.
      *

tests/Testing/Fluent/AssertTest.php

@@ -580,6 +580,72 @@ public function testAssertWhereFailsUsingBackedEnum()
         $assert->where('bar', BackedEnum::test_empty);
     }
 
+    public function testAssertWhereNullMatchesValue()
+    {
+        $assert = AssertableJson::fromArray([
+            'bar' => null,
+        ]);
+
+        $assert->whereNull('bar');
+    }
+
+    public function testAssertWhereNullFailsWhenNotNull()
+    {
+        $assert = AssertableJson::fromArray([
+            'bar' => 'value',
+        ]);
+
+        $this->expectException(AssertionFailedError::class);
+        $this->expectExceptionMessage('Property [bar] should be null.');
+
+        $assert->whereNull('bar');
+    }
+
+    public function testAssertWhereNullFailsWhenMissing()
+    {
+        $assert = AssertableJson::fromArray([
+            'bar' => 'value',
+        ]);
+
+        $this->expectException(AssertionFailedError::class);
+        $this->expectExceptionMessage('Property [baz] does not exist.');
+
+        $assert->whereNull('baz');
+    }
+
+    public function testAssertWhereNotNullMatchesValue()
+    {
+        $assert = AssertableJson::fromArray([
+            'bar' => 'value',
+        ]);
+
+        $assert->whereNotNull('bar');
+    }
+
+    public function testAssertWhereNotNullFailsWhenNull()
+    {
+        $assert = AssertableJson::fromArray([
+            'bar' => null,
+        ]);
+
+        $this->expectException(AssertionFailedError::class);
+        $this->expectExceptionMessage('Property [bar] should not be null.');
+
+        $assert->whereNotNull('bar');
+    }
+
+    public function testAssertWhereNotNullFailsWhenMissing()
+    {
+        $assert = AssertableJson::fromArray([
+            'bar' => 'value',
+        ]);
+
+        $this->expectException(AssertionFailedError::class);
+        $this->expectExceptionMessage('Property [baz] does not exist.');
+
+        $assert->whereNotNull('baz');
+    }
+
     public function testAssertWhereContainsFailsWithEmptyValue()
     {
         $assert = AssertableJson::fromArray([]);