feature #60740 [Mailer] Add assertEmailAddressNotContains (santysisi)

nicolas-grekas · nicolas-grekas · commit c9500d8fb01c · 2025-06-16T08:39:18.000+02:00
This PR was merged into the 7.4 branch. Discussion ---------- [Mailer] Add `assertEmailAddressNotContains` | Q | A | ------------- | --- | Branch? | 7.4 | Bug fix? | no | New feature? | yes | Deprecations? | no | Issues | No | License | MIT This PR introduces a new assertion method `assertEmailAddressNotContains()` to the `MailerAssertionsTrait`. The new method complements the existing `assertEmailAddressContains()` by allowing developers to assert that a specific email address **does not** appear in a given header. This addition brings the `assertEmailAddressContains` in line with other similar assertion pairs already available in the trait, such as: - `assertEmailTextBodyContains` / `assertEmailTextBodyNotContains` - `assertEmailHtmlBodyContains` / `assertEmailHtmlBodyNotContains` - `assertEmailSubjectContains` / `assertEmailSubjectNotContains` ### Example usage ```php $this->assertEmailAddressNotContains($email, 'To', 'test@test.com'); ``` Commits ------- 9cc6a63 [Mailer] Add new `assertEmailAddressNotContains` method
diff --git a/src/Symfony/Bundle/FrameworkBundle/CHANGELOG.md b/src/Symfony/Bundle/FrameworkBundle/CHANGELOG.md
@@ -5,6 +5,7 @@ CHANGELOG
 ---
 
  * Deprecate `Symfony\Bundle\FrameworkBundle\Console\Application::add()` in favor of `Symfony\Bundle\FrameworkBundle\Console\Application::addCommand()`
+ * Add `assertEmailAddressNotContains()` to the `MailerAssertionsTrait`
 
 7.3
 ---
diff --git a/src/Symfony/Bundle/FrameworkBundle/Test/MailerAssertionsTrait.php b/src/Symfony/Bundle/FrameworkBundle/Test/MailerAssertionsTrait.php
@@ -90,6 +90,11 @@ public static function assertEmailAddressContains(RawMessage $email, string $hea
         self::assertThat($email, new MimeConstraint\EmailAddressContains($headerName, $expectedValue), $message);
     }
 
+    public static function assertEmailAddressNotContains(RawMessage $email, string $headerName, string $expectedValue, string $message = ''): void
+    {
+        self::assertThat($email, new LogicalNot(new MimeConstraint\EmailAddressContains($headerName, $expectedValue)), $message);
+    }
+
     public static function assertEmailSubjectContains(RawMessage $email, string $expectedValue, string $message = ''): void
     {
         self::assertThat($email, new MimeConstraint\EmailSubjectContains($expectedValue), $message);
diff --git a/src/Symfony/Bundle/FrameworkBundle/Tests/Functional/MailerTest.php b/src/Symfony/Bundle/FrameworkBundle/Tests/Functional/MailerTest.php
@@ -99,12 +99,15 @@ public function testMailerAssertions()
         $this->assertEmailHtmlBodyContains($email, 'Foo');
         $this->assertEmailHtmlBodyNotContains($email, 'Bar');
         $this->assertEmailAttachmentCount($email, 1);
+        $this->assertEmailAddressNotContains($email, 'To', 'thomas@symfony.com');
 
         $email = $this->getMailerMessage($second);
         $this->assertEmailSubjectContains($email, 'Foo');
         $this->assertEmailSubjectNotContains($email, 'Bar');
         $this->assertEmailAddressContains($email, 'To', 'fabien@symfony.com');
         $this->assertEmailAddressContains($email, 'To', 'thomas@symfony.com');
         $this->assertEmailAddressContains($email, 'Reply-To', 'me@symfony.com');
+        $this->assertEmailAddressNotContains($email, 'To', 'helene@symfony.com');
+        $this->assertEmailAddressNotContains($email, 'Reply-To', 'helene@symfony.com');
     }
 }

Original file line number	Diff line number	Diff line change
`@@ -90,6 +90,11 @@ public static function assertEmailAddressContains(RawMessage $email, string $hea`
`90`	`90`	`self::assertThat($email, new MimeConstraint\EmailAddressContains($headerName, $expectedValue), $message);`
`91`	`91`	`}`
`92`	`92`
	`93`	`+ public static function assertEmailAddressNotContains(RawMessage $email, string $headerName, string $expectedValue, string $message = ''): void`
	`94`	`+ {`
	`95`	`+ self::assertThat($email, new LogicalNot(new MimeConstraint\EmailAddressContains($headerName, $expectedValue)), $message);`
	`96`	`+ }`
	`97`	`+`
`93`	`98`	`public static function assertEmailSubjectContains(RawMessage $email, string $expectedValue, string $message = ''): void`
`94`	`99`	`{`
`95`	`100`	`self::assertThat($email, new MimeConstraint\EmailSubjectContains($expectedValue), $message);`