symfony · alexandre-daubois · Jun 2, 2025
diff --git a/src/Symfony/Component/JsonPath/CHANGELOG.md b/src/Symfony/Component/JsonPath/CHANGELOG.md
@@ -1,6 +1,11 @@
 CHANGELOG
 =========
 
+7.4
+---
+
+ * Add `CrawlerFactoryInterface` and `JsonCrawlerFactory`
+
 7.3
 ---
 

diff --git a/src/Symfony/Component/JsonPath/CrawlerFactoryInterface.php b/src/Symfony/Component/JsonPath/CrawlerFactoryInterface.php
@@ -0,0 +1,25 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\JsonPath;
+
+/**
+ * @author Alexandre Daubois <alex.daubois@gmail.com>
+ *
+ * @experimental
+ */
+interface CrawlerFactoryInterface
+{
+    /**
+     * @param string|resource $data
+     */
+    public function createFromData(mixed $data): CrawlerInterface;
+}
diff --git a/...mponent/JsonPath/JsonCrawlerInterface.php → ...y/Component/JsonPath/CrawlerInterface.php b/...mponent/JsonPath/JsonCrawlerInterface.php → ...y/Component/JsonPath/CrawlerInterface.php
@@ -19,7 +19,7 @@
  *
  * @experimental
  */
-interface JsonCrawlerInterface
+interface CrawlerInterface
 {
     /**
      * @return list<array|string|float|int|bool|null>

diff --git a/src/Symfony/Component/JsonPath/JsonCrawler.php b/src/Symfony/Component/JsonPath/JsonCrawler.php
@@ -28,7 +28,7 @@
  *
  * @experimental
  */
-final class JsonCrawler implements JsonCrawlerInterface
+final class JsonCrawler implements CrawlerInterface
 {
     private const RFC9535_FUNCTIONS = [
         'length' => true,
@@ -40,12 +40,14 @@ final class JsonCrawler implements JsonCrawlerInterface
 
     /**
      * @param resource|string $raw
+     *
+     * @throws \TypeError When the input is not a string or a resource
      */
     public function __construct(
         private readonly mixed $raw,
     ) {
         if (!\is_string($raw) && !\is_resource($raw)) {
-            throw new InvalidArgumentException(\sprintf('Expected string or resource, got "%s".', get_debug_type($raw)));
+            throw new \TypeError(\sprintf('Expected string or resource, got "%s".', get_debug_type($raw)));
         }
     }
 

diff --git a/src/Symfony/Component/JsonPath/JsonCrawlerFactory.php b/src/Symfony/Component/JsonPath/JsonCrawlerFactory.php
@@ -0,0 +1,28 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\JsonPath;
+
+/**
+ * @author Alexandre Daubois <alex.daubois@gmail.com>
+ *
+ * @experimental
+ */
+final class JsonCrawlerFactory implements CrawlerFactoryInterface
+{
+    /**
+     * @throws \TypeError When the data is not a string or a resource
+     */
+    public function createFromData(mixed $data): JsonCrawler
+    {
+        return new JsonCrawler($data);
+    }
+}
diff --git a/src/Symfony/Component/JsonPath/Tests/JsonCrawlerFactoryTest.php b/src/Symfony/Component/JsonPath/Tests/JsonCrawlerFactoryTest.php
@@ -0,0 +1,26 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <fabien@symfony.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\JsonPath\Tests;
+
+use PHPUnit\Framework\TestCase;
+use Symfony\Component\JsonPath\JsonCrawlerFactory;
+
+class JsonCrawlerFactoryTest extends TestCase
+{
+    public function testCreateCrawler()
+    {
+        $factory = new JsonCrawlerFactory();
+        $crawler = $factory->createFromData('{"foo": "bar"}');
+
+        $this->assertSame(['bar'], $crawler->find('$.foo'), '->createFromData() provides data to the crawler');
+    }
+}
diff --git a/src/Symfony/Component/JsonPath/Tests/JsonCrawlerTest.php b/src/Symfony/Component/JsonPath/Tests/JsonCrawlerTest.php
@@ -22,7 +22,7 @@ class JsonCrawlerTest extends TestCase
 {
     public function testNotStringOrResourceThrows()
     {
-        $this->expectException(InvalidArgumentException::class);
+        $this->expectException(\TypeError::class);
         $this->expectExceptionMessage('Expected string or resource, got "int".');
 
         new JsonCrawler(42);