The exists() method

CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog
 
+## 0.3.9 - 2024-08-08
+- Implementing the `exists()` method
+
 ## 0.3.8 - 2024-08-03
 - Implementing the `applyField()` method
 

README.md

@@ -538,6 +538,21 @@ $grouped->dumpJson();
 */
 ```
 
+### The `exists()` method
+
+You can use the `exists()` method to check if an element that meets a certain condition exists. This method is a convenient way to determine if any records match your query without needing to count them explicitly.
+
+Here’s how you can use it:
+
+```php
+$has = $composerContent
+    ->getBlock("story.content.body")->where(
+        "component",
+        "banner",
+    )->exists();
+```
+
+This will return true if a banner component exists, and false if it does not.
 
 ## Looping Data
 The Block class implements the Iterator interface.

src/Traits/QueryableBlock.php

@@ -16,20 +16,27 @@ public static function like(mixed $value1, mixed $value2): bool
         return str_contains($strValue1, $strValue2);
     }
 
+    public function exists(): bool
+    {
+        return $this->count() > 0;
+    }
+
     public function where(
         string|int $field,
         mixed $operator = null,
         mixed $value = null,
         bool $preseveKeys = true,
     ): self {
+
         if (func_num_args() === 1) {
             $value = true;
             $operator = '==';
         }
         if (func_num_args() === 2) {
             $value = $operator;
-            $operator = '===';
+            $operator = '==';
         }
+
         $returnData = [];
 
         foreach ($this as $key => $element) {

tests/Feature/QueryBlockTest.php

@@ -113,3 +113,31 @@
     expect($posts->get("0.id"))->toBe(1);
     expect($posts->get("0.reactions.likes"))->toBe(192);
 });
+
+test('Query Block with has', function (): void {
+    $jsonString = file_get_contents("./tests/data/story.json");
+    $composerContent = Block::fromJsonString($jsonString);
+    $has = $composerContent->getBlock("story.content.body")->where(
+        "component",
+        "==",
+        "banner",
+    )->exists();
+    expect($has)->toBeTrue();
+    $has = $composerContent->getBlock("story.content.body")->where(
+        "component",
+        "!=",
+        "banner",
+    )->exists();
+    expect($has)->toBeTrue();
+    $has = $composerContent->getBlock("story.content.body")->where(
+        "component",
+        "==",
+        "bannerXXX",
+    )->exists();
+    expect($has)->toBeFalse();
+    $has = $composerContent->getBlock("story.content.body")->where(
+        "component",
+        "banner",
+    )->exists();
+    expect($has)->toBeTrue();
+});