WebDriverTest.php

<?php
/**
 * Copyright 2014 Anthon Pang. All Rights Reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * @package WebDriver
 *
 * @author Anthon Pang <apang@softwaredevelopment.ca>
 */

namespace Test\WebDriver;

use WebDriver\WebDriver;

/**
 * Test WebDriver\WebDriver class
 *
 * @package WebDriver
 */
class WebDriverTest extends \PHPUnit_Framework_TestCase
{
    private $driver;
    private $session;
    private $testDocumentRootUrl = 'http://localhost';
    private $testSeleniumRootUrl = 'http://localhost:4444/wd/hub';

    /**
     * {@inheritdoc}
     */
    protected function setUp()
    {
        if ($url = getenv('ROOT_URL')) {
            $this->testDocumentRootUrl = $url;
        }
        if ($url = getenv('SELENIUM_URL')) {
            $this->testSeleniumRootUrl = $url;
        }
        $this->driver  = new WebDriver($this->getTestSeleniumRootUrl());
        $this->session = null;
    }

    /**
     * {@inheritdoc}
     */
    protected function tearDown()
    {
        if ($this->session) {
            $this->session->close();
        }
    }

    /**
     * Returns the full url to the test site (corresponding to the root dir of the library).
     * You can set this via env var ROOT_URL
     * @return string
     */
    protected function getTestDocumentRootUrl()
    {
        return $this->testDocumentRootUrl;
    }

    /**
     * Returns the full url to the Selenium server used for functional tests
     * @return string
     *
     * @todo make this configurable via env var
     */
    protected function getTestSeleniumRootUrl()
    {
        return $this->testSeleniumRootUrl;
    }

    protected function isSeleniumDown($exception)
    {
        return preg_match('/Failed to connect to .* Connection refused/', $exception->getMessage()) != false
            || strpos($exception->getMessage(), 'couldn\'t connect to host') !== false;
    }

    /**
     * @group Functional
     */
    public function testSessions()
    {
        try {
        $this->assertCount(0, $this->driver->sessions());

            $this->session = $this->driver->session();
        } catch (\Exception $e) {
            if ($this->isSeleniumDown($e)) {
                $this->markTestSkipped('selenium server not running');
            } else {
                throw $e;
            }
        }

        $this->assertCount(1, $this->driver->sessions());
        $this->assertEquals($this->getTestSeleniumRootUrl(), $this->driver->getUrl());
    }

    /**
     * @group Functional
     */
    public function testStatus()
    {
        try {
            $status = $this->driver->status();
        } catch (\Exception $e) {
            if ($this->isSeleniumDown($e)) {
                $this->markTestSkipped('selenium server not running');
            } else {
                throw $e;
            }
        }

        $this->assertCount(3, $status);
        $this->assertTrue(isset($status['java']));
        $this->assertTrue(isset($status['os']));
        $this->assertTrue(isset($status['build']));
    }

    /**
     * Checks that an error connecting to Selenium gives back the expected exception
     * @group Functional
     */
    public function testSeleniumError()
    {
        try {
            $this->driver = new WebDriver($this->getTestSeleniumRootUrl().'/../invalidurl');
            $status = $this->driver->status();

            $this->fail('Exception not thrown while connecting to invalid Selenium url');
        } catch (\Exception $e) {
            if ($this->isSeleniumDown($e)) {
                $this->markTestSkipped('selenium server not running');
            } else {
                $this->assertEquals('WebDriver\Exception\CurlExec', get_class($e));
            }
        }
    }

    /**
     * Checks that a successful command to Selenium which returns an http error response gives back the expected exception
     * @group Functional
     */
    public function testSeleniumErrorResponse()
    {
        $this->markTestSkipped('this test is currently broken'); // see https://github.com/instaclick/php-webdriver/issues/77
        return;

        try {
            $status = $this->driver->status();
        } catch (\Exception $e) {
            if ($this->isSeleniumDown($e)) {
                $this->markTestSkipped('selenium server not running');
            } else {
                throw $e;
            }
        }

        try {
            $this->session = $this->driver->session();
            $this->session->open($this->getTestDocumentRootUrl().'/test/Assets/index.html');
            $element = $this->session->element('id', 'a-quite-unlikely-html-element-id');

            $this->fail('Exception not thrown while looking for missing element in page');
        } catch (\Exception $e) {
            $this->assertEquals('WebDriver\Exception\NoSuchElement', get_class($e));
        }
    }

    /**
     * Checks that a successful command to Selenium which returns 'nothing' according to spec does not raise an error
     * @group Functional
     */
    public function testSeleniumNoResponse()
    {
        try {
            $status = $this->driver->status();
        } catch (\Exception $e) {
            if ($this->isSeleniumDown($e)) {
                $this->markTestSkipped('selenium server not running');
            } else {
                throw $e;
            }
        }

        $this->session = $this->driver->session();
        $timeouts = $this->session->timeouts();
        $out = $timeouts->async_script(array('type' => 'implicit', 'ms' => 1000));
        $this->assertEquals(null, $out);
    }
}