Why use Test.setCurrentPage() method in a unit test?

What is the purpose of the Test.setCurrentPage(..) method and why would I use it in my apex controller unit tests?

According to the salesforce docs,
https://www.salesforce.com/us/developer/docs/apexcode/Content/apex_methods_system_test.htm#apex_System_Test_setCurrentPage, the method is used to set the current PageReference for the controller being tested.

However, I’m not sure why that is important — I’m looking for use cases so that I might incorporate them into my own unit tests.



This method sets the page context for your unit test method .

Use cases could be you are trying to assert your pagereference behaviour .Good example can be below code

public PageReference save() {
            PageReference p = null;

            if (this.qp == null || !'yyyy'.equals(this.qp)) {
                p = Page.failure;
                p.getParameters().put('error', 'noParam');
            } else {
                try {
                    Lead newlead = new Lead(LastName=this.lastName, 
                    insert newlead;
                } catch (Exception e) {
                    p = Page.failure;
                    p.getParameters().put('error', 'noInsert');

            if (p == null) {
                p = Page.success;

            return p;

The above code is taken from the VF guide


Now there are multiple scenarios to assert the logic .One common use case is verifying the URL after save action has happened .Unit test is below for above code


  public class thecontrollerTests {

   public static testMethod void testMyController() {
    PageReference pageRef = Page.success;//Observe how we set the Page here
    Test.setCurrentPage(pageRef);//Applying page context here

    thecontroller controller = new thecontroller();
    String nextPage = controller.save().getUrl();

    // Verify that page fails without parameters
    System.assertEquals('/apex/failure?error=noParam', nextPage);

    // Add parameters to page URL
    ApexPages.currentPage().getParameters().put('qp', 'yyyy');//Observe how helpful it was to set the parameters in your page from Unit test 

    // Instantiate a new controller with all parameters in the page
    controller = new thecontroller(); 
    nextPage = controller.save().getUrl();

    // Verify that the success page displays
    System.assertEquals('/apex/success', nextPage);
    Lead[] leads = [select id, email from lead where Company = 'acme'];
    System.assertEquals('firstlast@acme.com', leads[0].email);

In short once you set context of the Page using method described ,your controller is executing with parameters referred from the page context .

You basically indicate to your Unit test class the page you are testing your controller logic for .Your controller can be bound to multiple page and setting page context for unit test makes it crystal clear you are testing for specific page behavior.

Source : Link , Question Author : Doug Ayers , Answer Author : Pasan Eeriyagama

Leave a Comment