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

title	summary
How to write a FunctionalTest	Expand your testing capabilities with integrations tests

How to Write a FunctionalTest

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 HTTPRequest and receiving 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.

app/tests/HomePageTest.php

use SilverStripe\Security\Member;

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, [
            'Email' => 'test@example.com',
            'Password' => 'wrongpassword'
        ]);

        // wrong details, should now see an error message
        $this->assertExactHTMLMatchBySelector("#LoginForm p.error", [
            "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", [
            'Welcome Back'
        ]);
    }
}

Related Documentation

• Functional Testing
• Unit Testing

API Documentation

• FunctionalTest