Skip to content

Latest commit

 

History

History
92 lines (70 loc) · 2.57 KB

functional_tests_assertions.rst

File metadata and controls

92 lines (70 loc) · 2.57 KB
.. index::
   single: Tests; Assertions

Functional Test specific Assertions

When doing functional tests, sometimes you need to make complex assertions in order to check whether the Request, the Response or the Crawler contain the expected information to make your test succeed.

The following example uses plain PHPUnit to assert that the response redirects to a certain URL:

$this->assertSame(301, $client->getResponse()->getStatusCode());
$this->assertSame('https://example.com/', $client->getResponse()->headers->get('Location'));

This is the same example using the assertions provided by Symfony:

$this->assertResponseRedirects('https://example.com/', 301);

Note

These assertions only work if a request has been made with the Client in a test case extending the WebTestCase class.

Assertions Reference

Response

  • assertResponseIsSuccessful()
  • assertResponseStatusCodeSame()
  • assertResponseRedirects()
  • assertResponseHasHeader()
  • assertResponseNotHasHeader()
  • assertResponseHeaderSame()
  • assertResponseHeaderNotSame()
  • assertResponseHasCookie()
  • assertResponseNotHasCookie()
  • assertResponseCookieValueSame()

Request

  • assertRequestAttributeValueSame()
  • assertRouteSame()

Browser

  • assertBrowserHasCookie()
  • assertBrowserNotHasCookie()
  • assertBrowserCookieValueSame()

Crawler

Note

You cannot use the :doc:`Crawler </components/dom_crawler>` assertions, when using symfony/panther for end-to-end testing.

  • assertSelectorExists()
  • assertSelectorNotExists()
  • assertSelectorTextContains() (note: it only checks the first selector occurrence)
  • assertSelectorTextSame() (note: it only checks the first selector occurrence)
  • assertSelectorTextNotContains() (note: it only checks the first selector occurrence)
  • assertPageTitleSame()
  • assertPageTitleContains()
  • assertInputValueSame()
  • assertInputValueNotSame()

Mailer

  • assertEmailCount()
  • assertQueuedEmailCount()
  • assertEmailIsQueued()
  • assertEmailIsNotQueued()
  • assertEmailAttachementCount()
  • assertEmailTextBodyContains()
  • assertEmailTextBodyNotContains()
  • assertEmailHtmlBodyContains()
  • assertEmailHtmlBodyNotContains()
  • assertEmailHasHeader()
  • assertEmailNotHasHeader()
  • assertEmailHeaderSame()
  • assertEmailHeaderNotSame()
  • assertEmailAddressContains()