[12.x] Add support for callback evaluation in containsOneItem method

fernandokbs · fernandokbs · commit e728b73bc771 · 2025-05-01T10:31:36.000-06:00
diff --git a/src/Illuminate/Collections/Collection.php b/src/Illuminate/Collections/Collection.php
@@ -711,13 +711,18 @@ public function isEmpty()
         return empty($this->items);
     }
 
-    /**
-     * Determine if the collection contains a single item.
+    /** 
+     * Determine if the collection contains exactly one item. If a callback is provided, it checks if exactly one item matches the condition.
      *
+     * @param  (callable(TValue, TKey): bool)|null  $callback
      * @return bool
      */
-    public function containsOneItem()
+    public function containsOneItem(?callable $callback = null): bool
     {
+        if ($callback) {
+            return $this->filter($callback)->count() === 1;
+        }
+    
         return $this->count() === 1;
     }
 
diff --git a/tests/Support/SupportCollectionTest.php b/tests/Support/SupportCollectionTest.php
@@ -838,6 +838,10 @@ public function testContainsOneItem($collection)
         $this->assertFalse((new $collection([]))->containsOneItem());
         $this->assertTrue((new $collection([1]))->containsOneItem());
         $this->assertFalse((new $collection([1, 2]))->containsOneItem());
+
+        $this->assertFalse((collect([1, 2, 2])->containsOneItem(fn($number) => $number === 2)));
+        $this->assertTrue((collect(['ant', 'bear', 'cat'])->containsOneItem(fn($word) => strlen($word) === 4)));
+        $this->assertFalse((collect(['ant', 'bear', 'cat'])->containsOneItem(fn($word) => strlen($word) > 4)));
     }
 
     public function testIterable()

Original file line number	Diff line number	Diff line change
`@@ -711,13 +711,18 @@ public function isEmpty()`
`711`	`711`	`return empty($this->items);`
`712`	`712`	`}`
`713`	`713`
`714`		`- /**`
`715`		`- * Determine if the collection contains a single item.`
	`714`	`+ /**`
	`715`	`+ * Determine if the collection contains exactly one item. If a callback is provided, it checks if exactly one item matches the condition.`
`716`	`716`	`*`
	`717`	`+ * @param (callable(TValue, TKey): bool)\|null $callback`
`717`	`718`	`* @return bool`
`718`	`719`	`*/`
`719`		`- public function containsOneItem()`
	`720`	`+ public function containsOneItem(?callable $callback = null): bool`
`720`	`721`	`{`
	`722`	`+ if ($callback) {`
	`723`	`+ return $this->filter($callback)->count() === 1;`
	`724`	`+ }`
	`725`	`+`
`721`	`726`	`return $this->count() === 1;`
`722`	`727`	`}`
`723`	`728`