codeception/symfony1module

Module for symfony 1.x framework

Symfony1 Module

Codeception Module that interacts with Symfony 1.4 applications., _(*1)

Replaces functional testing framework from symfony. Authorization features uses Doctrine and sfDoctrineGuardPlugin. Uses native symfony connections and test classes. Provides additional informations on every actions., _(*2)

If test fails stores last shown page in 'log' dir., _(*3)

Installation

In composer.json, _(*4)

"require-dev": {
  "codeception/codeception": "~2.1",
  "codeception/symfony1module": "*"
}

Status

• Maintainer: davert
• Stability: stable
• Contact: codecept@davert.mail.ua

Configuration

• app required - application you want to test. In most cases it will be 'frontend'

Public Properties

• browser - current instance of sfBrowser class.

amLoggedAs

Log in as sfDoctrineGuardUser. Only name of user should be provided. Fetches user by it's username from sfGuardUser table., _(*5)

• param $name \Exception

amOnPage

Opens the page., _(*6)

• param $page

click

Click on link or button and move to next page. Either link text, css selector, or xpath can be passed, _(*7)

• param $link

clickSubmitButton

Emulates click on form's submit button. You don't need that action if you fill form by ->submitForm action., _(*8)

• param $selector

dontSee

Check if current page doesn't contain the text specified. Specify the css selector to match only specific region., _(*9)

Examples:, _(*10)

<?php
$I->dontSee('Login'); // I can suppose user is already logged in
$I->dontSee('Sign Up','h1'); // I can suppose it's not a signup page

• param $text
• param null $selector

dontSeeCheckboxIsChecked

Assert if the specified checkbox is unchecked. Use css selector or xpath to match., _(*11)

Example:, _(*12)

``` php <?php $I->dontSeeCheckboxIsChecked('#agree'); // I suppose user didn't agree to terms $I->seeCheckboxIsChecked('#signup_form input[type=checkbox]'); // I suppose user didn't check the first checkbox in form., <sub>(*13)</sub>

 * `param` $selector


### dontSeeLink

Checks if page doesn't contain the link with text specified.
Specify url to narrow the results.

Examples:

``` php
<?php
$I->dontSeeLink('Logout'); // I suppose user is not logged in

• param $text
• param null $url

see

Check if current page contains the text specified. Specify the css selector to match only specific region., <sub>(*14)</sub>

Examples:, <sub>(*15)</sub>

``` php <?php $I->see('Logout'); // I can suppose user is logged in $I->see('Sign Up','h1'); // I can suppose it's a signup page, <sub>(*16)</sub>

 * `param` $text
 * `param null` $selector


### seeCheckboxIsChecked

Assert if the specified checkbox is checked.
Use css selector or xpath to match.

Example:

``` php
<?php
$I->seeCheckboxIsChecked('#agree'); // I suppose user agreed to terms
$I->seeCheckboxIsChecked('#signup_form input[type=checkbox]'); // I suppose user agreed to terms, If there is only one checkbox in form.

• param $selector

seeEmailReceived

Checks if there were at least one email sent through Symfony test mailer., <sub>(*17)</sub>

seeErrorInField

Checks for invalid value in Symfony1 form. Matches the first sfForm instance from controller and returns getErrorSchema() values. Specify field which should contain error message., <sub>(*18)</sub>

• param $field

seeErrorsInForm

Performs validation of Symfony1 form. Matches the first sfForm instance from controller and returns getErrorSchema() values. Shows all errors in debug., <sub>(*19)</sub>

seeFormIsValid

Performs validation of Symfony1 form. Matches the first sfForm instance from controller and returns isValid() value., <sub>(*20)</sub>

seeLink

Checks if there is a link with text specified. Specify url to match link with exact this url., <sub>(*21)</sub>

Examples:, <sub>(*22)</sub>

``` php <?php $I->seeLink('Logout'); // matches Logout $I->seeLink('Logout','/logout'); // matches Logout, <sub>(*23)</sub>

 * `param` $text
 * `param null` $url


### sendAjaxGetRequest

If your page triggers an ajax request, you can perform it manually.
This action sends a GET ajax request with specified params.

See ->sendAjaxPostRequest for examples.

 * `param` $uri
 * `param` $params


### sendAjaxPostRequest

If your page triggers an ajax request, you can perform it manually.
This action sends a POST ajax request with specified params.
Additional params can be passed as array.

Example:

Imagine that by clicking checkbox you trigger ajax request which updates user settings.
We emulate that click by running this ajax request manually.

``` php
<?php
$I->sendAjaxPostRequest('/updateSettings', array('notifications' => true); // POST
$I->sendAjaxGetRequest('/updateSettings', array('notifications' => true); // GET

• param $uri
• param $params

signIn

Sign's user in with sfGuardAuth. Uses standard path: /sfGuardAuth/signin for authorization. Provide username and password., <sub>(*24)</sub>

• param $username
• param $password

signOut

Sign out is performing by triggering '/logout' url., <sub>(*25)</sub>

submitForm

Submits a form located on page. Specify the form by it's css or xpath selector. Fill the form fields values as array., <sub>(*26)</sub>

Skipped fields will be filled by their values from page. You don't need to click the 'Submit' button afterwards. This command itself triggers the request to form's action., <sub>(*27)</sub>

Examples:, <sub>(*28)</sub>

``` php <?php $I->submitForm('#login', array('login' => 'davert', 'password' => '123456'));, <sub>(*29)</sub>

For sample Sign Up form:

``` html
<form action="/sign_up">
    Login: <input type="text" name="user[login]" /><br/>
    Password: <input type="password" name="user[password]" /><br/>
    Do you agree to out terms? <input type="checkbox" name="user[agree]" /><br/>
    Select pricing plan <select name="plan"><option value="1">Free</option><option value="2" selected="selected">Paid</option></select>
    <input type="submit" value="Submit" />
</form>

I can write this:, <sub>(*30)</sub>

``` php <?php $I->submitForm('#userForm', array('user' => array('login' => 'Davert', 'password' => '123456', 'agree' => true)));, <sub>(*31)</sub>

``` Note, that pricing plan will be set to Paid, as it's selected on page., <sub>(*32)</sub>

• param $selector
• param $params