Allow values of other types than array to be passed to assertIsList()

Author: sebastianbergmann

ChangeLog-10.0.md

@@ -2,6 +2,12 @@
 
 All notable changes of the PHPUnit 10.0 release series are documented in this file using the [Keep a CHANGELOG](https://keepachangelog.com/) principles.
 
+## [10.0.12] - 2023-MM-DD
+
+### Changed
+
+* Values of other types than `array` may now be passed to `assertIsList()`
+
 ## [10.0.11] - 2023-02-20
 
 ### Fixed
@@ -210,6 +216,7 @@ All notable changes of the PHPUnit 10.0 release series are documented in this fi
 * PHP 7.3, PHP 7.4, and PHP 8.0 are no longer supported
 * `phpunit/php-code-coverage` [no longer supports PHPDBG and Xdebug 2](https://github.com/sebastianbergmann/php-code-coverage/blob/10.0.0/ChangeLog.md#1000---2023-02-03)
 
+[10.0.12]: https://github.com/sebastianbergmann/phpunit/compare/10.0.11...10.0
 [10.0.11]: https://github.com/sebastianbergmann/phpunit/compare/10.0.10...10.0.11
 [10.0.10]: https://github.com/sebastianbergmann/phpunit/compare/10.0.9...10.0.10
 [10.0.9]: https://github.com/sebastianbergmann/phpunit/compare/10.0.8...10.0.9

src/Framework/Assert.php

@@ -103,7 +103,7 @@ final public static function assertArrayNotHasKey(int|string $key, array|ArrayAc
     /**
      * @throws ExpectationFailedException
      */
-    final public static function assertIsList(array $array, string $message = ''): void
+    final public static function assertIsList(mixed $array, string $message = ''): void
     {
         static::assertThat(
             $array,

src/Framework/Assert/Functions.php

@@ -111,7 +111,7 @@ function assertArrayNotHasKey(int|string $key, array|ArrayAccess $array, string
      *
      * @see Assert::assertIsList
      */
-    function assertIsList(array $array, string $message = ''): void
+    function assertIsList(mixed $array, string $message = ''): void
     {
         Assert::assertIsList(...func_get_args());
     }

tests/unit/Framework/AssertTest.php

@@ -251,6 +251,13 @@ public function testAssertIsListFailsWithStringKeys(): void
         $this->assertIsList(['string' => 0]);
     }
 
+    public function testAssertIsListFailsForTypesOtherThanArray(): void
+    {
+        $this->expectException(AssertionFailedError::class);
+
+        $this->assertIsList(null);
+    }
+
     public function testAssertArrayContainsOnlyIntegers(): void
     {
         $this->assertContainsOnly('integer', [1, 2, 3]);