silverstripe-framework/docs/en/02_Developer_Guides/06_Testing/How_Tos/01_Write_a_FunctionalTest.md

title: How to write a FunctionalTest

How to Write a FunctionalTest

[api:FunctionalTest] test your applications Controller instances and anything else which requires a web request. The core of these tests are the same as SapphireTest unit tests but add several methods for creating [api:SS_HTTPRequest] and receiving [api:SS_HTTPResponse] objects. In this How To, we'll see how to write a test to query a page, check the response and modify the session within a test.

mysite/tests/HomePageTest.php

:::php
<?php

class HomePageTest extends FunctionalTest {

	/**
	 * Test generation of the view
	 */
	public function testViewHomePage() {
		$page = $this->get('home/');

		// Home page should load..
		$this->assertEquals(200, $page->getStatusCode());

		// We should see a login form
		$login = $this->submitForm("LoginFormID", null, array(
			'Email' => 'test@test.com',
			'Password' => 'wrongpassword'
		));

		// wrong details, should now see an error message
		$this->assertExactHTMLMatchBySelector("#LoginForm p.error", array(
			"That email address is invalid."
		));

		// If we login as a user we should see a welcome message
		$me = Member::get()->first();

		$this->logInAs($me);
		$page = $this->get('home/');

		$this->assertExactHTMLMatchBySelector("#Welcome", array(
			'Welcome Back'
		));
	}
}

Related Documentation

• Functional Testing
• Unit Testing

API Documentation

• [api:FunctionalTest]