https://github.com/xp-framework/webtest
Web tests for the XP Framework
https://github.com/xp-framework/webtest
unittest xp-framework
Last synced: 5 months ago
JSON representation
Web tests for the XP Framework
- Host: GitHub
- URL: https://github.com/xp-framework/webtest
- Owner: xp-framework
- Created: 2015-07-31T17:00:13.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2022-03-04T09:05:01.000Z (almost 4 years ago)
- Last Synced: 2025-01-20T19:22:27.363Z (12 months ago)
- Topics: unittest, xp-framework
- Language: PHP
- Size: 60.5 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog.md
Awesome Lists containing this project
README
Webtest
=======
[](https://github.com/xp-framework/webtest/actions)
[](https://github.com/xp-framework/core)
[](https://github.com/xp-framework/core/blob/master/LICENCE.md)
[](http://php.net/)
[](http://php.net/)
[](https://packagist.org/packages/xp-framework/webtest)
Web tests for the XP Framework
Example
-------
The following web test case consists of opening GitHub's homepage and asserting the title to equal the company's name:
```php
use unittest\web\{WebTestCase, Webtest};
use unittest\Test;
#[Webtest(url: 'https://github.com/')]
class GitHubTestCase extends WebTestCase {
#[Test]
public function home() {
$this->beginAt('/');
$this->assertStatus(200);
$this->assertTitleEquals('GitHub: Where the world builds software · GitHub');
}
}
```
Running it works as with normal test cases:
```sh
$ xp test GitHubTestCase
[.]
✓: 1/1 run (0 skipped), 1 succeeded, 0 failed
Memory used: 1861.12 kB (2474.66 kB peak)
Time taken: 1.225 seconds
```
To overwrite the default URL specified in the annotation, supply it as command line argument, e.g. `unittest GitHubTestCase -a https://github.staging.lan/`.
Assertion methods
-----------------
On top of the assertion methods provided by the unittest library, the following response-related assertions are available:
```php
public void assertStatus(int $status)
public void assertUrlEquals(peer.URL $url)
public void assertContentType(string $ctype)
public void assertHeader(string $header, string $value)
public void assertElementPresent(string $id)
public void assertTextPresent(string $text)
public void assertImagePresent(string $src)
public void assertLinkPresent(string $url)
public void assertLinkPresentWithText(string $text)
public void assertFormPresent(string $name= null)
public void assertTitleEquals($title)
```
Navigation
----------
To follow links inside a page, a web test can utilize the click methods:
```php
protected void clickLink(string $id);
protected void clickLinkWithText(string $text);
```
Forms
-----
To work with forms, the `getForm()` method can be used:
```php
use unittest\web\{WebTestCase, Webtest};
use unittest\Test;
#[Webtest(url: 'https://github.com/')]
class GitHubTestCase extends WebTestCase {
#[Test]
public function search_for() {
$this->beginAt('/');
$form= $this->getForm();
$form->getField('q')->setValue('XP Framework');
$form->submit();
$this->assertStatus(200);
$this->assertTitleEquals('Search · XP Framework · GitHub');
}
}
```
See also
--------
https://github.com/xp-framework/rfc/issues/169