fix use of headings in integration test document
This commit is contained in:
parent
fa1f1dcd11
commit
5bc21c0467
|
@ -1,8 +1,9 @@
|
||||||
NetSurf Integration Testing
|
NetSurf Integration Testing
|
||||||
===========================
|
===========================
|
||||||
|
|
||||||
Overview
|
[TOC]
|
||||||
--------
|
|
||||||
|
# Overview
|
||||||
|
|
||||||
The monkey frontend is used to perform complex tests involving
|
The monkey frontend is used to perform complex tests involving
|
||||||
operating the browser as a user might (opening windows, navigating to
|
operating the browser as a user might (opening windows, navigating to
|
||||||
|
@ -26,8 +27,7 @@ known behaviours such as delays or returning specific content to
|
||||||
extend test capabilities.
|
extend test capabilities.
|
||||||
|
|
||||||
|
|
||||||
Running a test
|
# Running a test
|
||||||
--------------
|
|
||||||
|
|
||||||
An individual test can be run using the monkey_driver.py python script
|
An individual test can be run using the monkey_driver.py python script
|
||||||
from within the NetSurf repository
|
from within the NetSurf repository
|
||||||
|
@ -43,8 +43,7 @@ For example to wrap execution under valgrind memory checker
|
||||||
$ ./test/monkey_driver.py -m ./nsmonkey -w 'valgrind -v --track-origins=yes' -t test/monkey-tests/start-stop.yaml
|
$ ./test/monkey_driver.py -m ./nsmonkey -w 'valgrind -v --track-origins=yes' -t test/monkey-tests/start-stop.yaml
|
||||||
|
|
||||||
|
|
||||||
Running more than one test
|
# Running more than one test
|
||||||
--------------------------
|
|
||||||
|
|
||||||
Each test is a member of a group and the tests within each group are
|
Each test is a member of a group and the tests within each group are
|
||||||
run together. Groups are listed within division index files. A group
|
run together. Groups are listed within division index files. A group
|
||||||
|
@ -88,8 +87,7 @@ group to be executed.
|
||||||
=> Run test: resource-scheme.yaml
|
=> Run test: resource-scheme.yaml
|
||||||
PASS
|
PASS
|
||||||
|
|
||||||
Test files
|
# Test files
|
||||||
----------
|
|
||||||
|
|
||||||
Each test is a individual [YAML](https://en.wikipedia.org/wiki/YAML)
|
Each test is a individual [YAML](https://en.wikipedia.org/wiki/YAML)
|
||||||
file and consists of associative arrays (key/value pairs), lists and
|
file and consists of associative arrays (key/value pairs), lists and
|
||||||
|
@ -114,10 +112,9 @@ then quits it without ever opening a window to browse to a page
|
||||||
- action: quit
|
- action: quit
|
||||||
|
|
||||||
|
|
||||||
Actions
|
# Actions
|
||||||
-------
|
|
||||||
|
|
||||||
### launch
|
## launch
|
||||||
|
|
||||||
Start a browser instance. A test will generally have a single launch
|
Start a browser instance. A test will generally have a single launch
|
||||||
action paired with a quit action.
|
action paired with a quit action.
|
||||||
|
@ -145,18 +142,19 @@ The following launch action would start a browser:
|
||||||
* The user options `enable_javascript` and `send_referer` set to false.
|
* The user options `enable_javascript` and `send_referer` set to false.
|
||||||
* The `LANGUAGE` environment variable set to `en`
|
* The `LANGUAGE` environment variable set to `en`
|
||||||
|
|
||||||
- action: launch
|
```
|
||||||
launch-options:
|
- action: launch
|
||||||
- verbose
|
launch-options:
|
||||||
environment:
|
- verbose
|
||||||
NETSURFRES: /home/netsurf/resources
|
environment:
|
||||||
options:
|
NETSURFRES: /home/netsurf/resources
|
||||||
- enable_javascript=0
|
options:
|
||||||
- send_referer=0
|
- enable_javascript=0
|
||||||
language: en
|
- send_referer=0
|
||||||
|
language: en
|
||||||
|
```
|
||||||
|
|
||||||
|
## window-new
|
||||||
### window-new
|
|
||||||
|
|
||||||
Open a new browser window. The test may open as many browser windows
|
Open a new browser window. The test may open as many browser windows
|
||||||
as necessary and they are usually paired with a `window-close` action
|
as necessary and they are usually paired with a `window-close` action
|
||||||
|
@ -175,7 +173,7 @@ referred to with the win1 identifier:
|
||||||
tag: win1
|
tag: win1
|
||||||
|
|
||||||
|
|
||||||
### window-close
|
## window-close
|
||||||
|
|
||||||
Closes a previously opened window. The window is identified with the
|
Closes a previously opened window. The window is identified with the
|
||||||
`window` key, the value of this must be a previously created window
|
`window` key, the value of this must be a previously created window
|
||||||
|
@ -185,7 +183,7 @@ identifier or an assert will occur.
|
||||||
window: win1
|
window: win1
|
||||||
|
|
||||||
|
|
||||||
### navigate
|
## navigate
|
||||||
|
|
||||||
Cause a window to start navigating to a new URL.
|
Cause a window to start navigating to a new URL.
|
||||||
|
|
||||||
|
@ -215,7 +213,7 @@ navigation in a loop with different values.
|
||||||
repeaturl: urls
|
repeaturl: urls
|
||||||
|
|
||||||
|
|
||||||
### reload
|
## reload
|
||||||
|
|
||||||
Cause a window to (re)navigate to the current URL
|
Cause a window to (re)navigate to the current URL
|
||||||
|
|
||||||
|
@ -226,7 +224,7 @@ assert will occur.
|
||||||
- action: reload
|
- action: reload
|
||||||
window: win1
|
window: win1
|
||||||
|
|
||||||
### stop
|
## stop
|
||||||
|
|
||||||
Cause a window to immediately stop any navigation.
|
Cause a window to immediately stop any navigation.
|
||||||
|
|
||||||
|
@ -237,7 +235,7 @@ assert will occur.
|
||||||
- action: stop
|
- action: stop
|
||||||
window: win1
|
window: win1
|
||||||
|
|
||||||
### sleep-ms
|
## sleep-ms
|
||||||
|
|
||||||
Wait for time to pass before continuing to next action.
|
Wait for time to pass before continuing to next action.
|
||||||
|
|
||||||
|
@ -280,7 +278,7 @@ action is delaying.
|
||||||
- action: quit
|
- action: quit
|
||||||
|
|
||||||
|
|
||||||
### block
|
## block
|
||||||
|
|
||||||
Wait for conditions to be met before continuing. This is similar to
|
Wait for conditions to be met before continuing. This is similar to
|
||||||
the `sleep-ms` action except that it will wait forever for the
|
the `sleep-ms` action except that it will wait forever for the
|
||||||
|
@ -295,7 +293,7 @@ terminate the block.
|
||||||
status: complete
|
status: complete
|
||||||
|
|
||||||
|
|
||||||
### repeat
|
## repeat
|
||||||
|
|
||||||
Repeat a set of actions.
|
Repeat a set of actions.
|
||||||
|
|
||||||
|
@ -354,7 +352,7 @@ Note that `min` ,`step` and `max` are ignored if there is a `values` key
|
||||||
status: complete
|
status: complete
|
||||||
|
|
||||||
|
|
||||||
### timer-start
|
## timer-start
|
||||||
|
|
||||||
Start a timer.
|
Start a timer.
|
||||||
|
|
||||||
|
@ -364,7 +362,7 @@ The identifier for the timer is set with the `timer` key.
|
||||||
timer: timer1
|
timer: timer1
|
||||||
|
|
||||||
|
|
||||||
### timer-restart
|
## timer-restart
|
||||||
|
|
||||||
Re-start a timer
|
Re-start a timer
|
||||||
|
|
||||||
|
@ -373,7 +371,8 @@ The identifier for the timer is set with the `timer` key.
|
||||||
- action: timer-restart
|
- action: timer-restart
|
||||||
timer: timer1
|
timer: timer1
|
||||||
|
|
||||||
### timer-stop
|
|
||||||
|
## timer-stop
|
||||||
|
|
||||||
Stop a timer
|
Stop a timer
|
||||||
|
|
||||||
|
@ -383,7 +382,7 @@ The identifier for the timer is set with the `timer` key.
|
||||||
timer: timer1
|
timer: timer1
|
||||||
|
|
||||||
|
|
||||||
### timer-check
|
## timer-check
|
||||||
|
|
||||||
Check a timer meets a condition.
|
Check a timer meets a condition.
|
||||||
|
|
||||||
|
@ -392,7 +391,7 @@ The identifier for the timer is set with the `timer` key.
|
||||||
The conditional is set with the `condition` key which must be present.
|
The conditional is set with the `condition` key which must be present.
|
||||||
|
|
||||||
|
|
||||||
### plot-check
|
## plot-check
|
||||||
|
|
||||||
Perform a plot of a previously navigated window.
|
Perform a plot of a previously navigated window.
|
||||||
|
|
||||||
|
@ -422,7 +421,7 @@ The checks available are:
|
||||||
- bitmap-count: 1
|
- bitmap-count: 1
|
||||||
|
|
||||||
|
|
||||||
### click
|
## click
|
||||||
|
|
||||||
Perform a user mouse click on a specified window.
|
Perform a user mouse click on a specified window.
|
||||||
|
|
||||||
|
@ -449,7 +448,7 @@ not specified is `single`
|
||||||
text: "about:Choices"
|
text: "about:Choices"
|
||||||
|
|
||||||
|
|
||||||
### wait-loading
|
## wait-loading
|
||||||
|
|
||||||
Wait for the navigated page to start loading before moving to the next
|
Wait for the navigated page to start loading before moving to the next
|
||||||
action.
|
action.
|
||||||
|
@ -462,7 +461,7 @@ assert will occur.
|
||||||
window: win1
|
window: win1
|
||||||
|
|
||||||
|
|
||||||
### add-auth
|
## add-auth
|
||||||
|
|
||||||
Add basic authentication details for a navigation.
|
Add basic authentication details for a navigation.
|
||||||
|
|
||||||
|
@ -478,7 +477,7 @@ answer the challenge.
|
||||||
password: bar
|
password: bar
|
||||||
|
|
||||||
|
|
||||||
### remove-auth
|
## remove-auth
|
||||||
|
|
||||||
Remove a previously added authentication details.
|
Remove a previously added authentication details.
|
||||||
|
|
||||||
|
@ -489,17 +488,17 @@ Remove a previously added authentication details.
|
||||||
password: bar
|
password: bar
|
||||||
|
|
||||||
|
|
||||||
### add-cert
|
## add-cert
|
||||||
|
|
||||||
Add certificate error handler for a url.
|
Add certificate error handler for a url.
|
||||||
|
|
||||||
|
|
||||||
### remove-cert
|
## remove-cert
|
||||||
|
|
||||||
Remove certificate error handler for a url.
|
Remove certificate error handler for a url.
|
||||||
|
|
||||||
|
|
||||||
### clear-log
|
## clear-log
|
||||||
|
|
||||||
Clear log for a window.
|
Clear log for a window.
|
||||||
|
|
||||||
|
@ -508,7 +507,7 @@ value of this must be a previously created window identifier or an
|
||||||
assert will occur.
|
assert will occur.
|
||||||
|
|
||||||
|
|
||||||
### wait-log
|
## wait-log
|
||||||
|
|
||||||
Wait for string to appear in log output.
|
Wait for string to appear in log output.
|
||||||
|
|
||||||
|
@ -518,7 +517,7 @@ assert will occur.
|
||||||
|
|
||||||
The keys `source` `foldable` `level` and `substring` must be specified
|
The keys `source` `foldable` `level` and `substring` must be specified
|
||||||
|
|
||||||
### js-exec
|
## js-exec
|
||||||
|
|
||||||
Execute javascript in a window.
|
Execute javascript in a window.
|
||||||
|
|
||||||
|
@ -529,7 +528,7 @@ assert will occur.
|
||||||
The `cmd` key contains the javascript to execute.
|
The `cmd` key contains the javascript to execute.
|
||||||
|
|
||||||
|
|
||||||
### page-info-state
|
## page-info-state
|
||||||
|
|
||||||
Check the page information status matches an expected value.
|
Check the page information status matches an expected value.
|
||||||
|
|
||||||
|
@ -540,6 +539,6 @@ assert will occur.
|
||||||
The value of the `match` key is compared to the windows page
|
The value of the `match` key is compared to the windows page
|
||||||
information status and an assert occurs if there is a mismatch.
|
information status and an assert occurs if there is a mismatch.
|
||||||
|
|
||||||
### quit
|
## quit
|
||||||
|
|
||||||
This causes a previously launched browser instance to exit cleanly.
|
This causes a previously launched browser instance to exit cleanly.
|
||||||
|
|
Loading…
Reference in New Issue