add Json::maybeDecode()

CHANGELOG.md

@@ -5,6 +5,7 @@
 ### Added
 
 - `Innmind\Json\Json::encode()` and `::decode()` are now declared pure
+- `Innmind\Json\Json::maybeDecode()`
 
 ### Removed
 

composer.json

@@ -16,7 +16,8 @@
     },
     "require": {
         "php": "~8.2",
-        "ext-json": "*"
+        "ext-json": "*",
+        "innmind/immutable": "~5.3"
     },
     "autoload": {
         "psr-4": {

src/Json.php

@@ -7,6 +7,7 @@
     MaximumDepthExceeded,
     StateMismatch,
     CharacterControlError,
+    Exception,
     SyntaxError,
     MalformedUTF8,
     RecursiveReference,
@@ -15,6 +16,7 @@
     PropertyCannotBeEncoded,
     MalformedUTF16,
 };
+use Innmind\Immutable\Maybe;
 
 final class Json
 {
@@ -43,6 +45,20 @@ public static function decode(string $string)
         }
     }
 
+    /**
+     * @psalm-pure
+     *
+     * @return Maybe<mixed>
+     */
+    public static function maybeDecode(string $string): Maybe
+    {
+        try {
+            return Maybe::just(self::decode($string));
+        } catch (Exception $e) {
+            return Maybe::nothing();
+        }
+    }
+
     /**
      * @psalm-pure
      *

tests/JsonTest.php

@@ -59,13 +59,31 @@ public function testDecode()
         $this->assertSame(['foo' => 'bar'], $content);
     }
 
+    public function testMaybeDecode()
+    {
+        $content = Json::maybeDecode('{"foo":"bar"}');
+
+        $this->assertSame(['foo' => 'bar'], $content->match(
+            static fn($content) => $content,
+            static fn() => null,
+        ));
+    }
+
     public function testThrowOnSyntaxError()
     {
         $this->expectException(SyntaxError::class);
 
         Json::decode('{"foo"');
     }
 
+    public function testReturnNothingOnDecodingError()
+    {
+        $this->assertFalse(Json::maybeDecode('{"foo"')->match(
+            static fn() => true,
+            static fn() => false,
+        ));
+    }
+
     public function testThrowOnMaximumDepthExceeded()
     {
         $this->expectException(MaximumDepthExceeded::class);