Browser¶

Steps for using a web UI in a real Chromium, the way a person does: by what the page shows

Multi-line Content

Steps ending with : accept multi-line content using Gherkin's docstring syntax ("""). See examples below each section.

Step	Description
`"alice" opens "/master"`	Open a page and wait until it has loaded. A path is joined to base_url

Using the Page¶

Step	Description
`"alice" clicks "Apply"`	Click what is called this: a button, link or tab by its accessible name, or else the element showing this text. Waits until it is there, enabled and not covered
`"alice" fills "Search" with "Zinsen"`	Replace what a field holds. The field is named by its label, placeholder or accessible name; a contenteditable editor counts as a field
`"alice" types " und Gebühren" at the end of "7.2"`	Put the caret at the end of the paragraph or field showing this text, and type there key by key
`"alice" types "Neuer Satz."`	Type key by key into whatever has focus
`"alice" presses "ctrl+z"`	Press a key or a shortcut, such as Enter, Escape, Tab, ArrowDown or ctrl+z
`"alice" checks "Austria"`	Tick a checkbox or switch by its label, unless it is ticked already
`"alice" unchecks "Netherlands"`	Clear a checkbox or switch by its label, unless it is clear already
`"alice" chooses "Selected countries"`	Choose a radio button, tab or option by its label
`"alice" selects "Austria" from "Country"`	Pick an option of a select box or combobox, both by what they show

Step	Description
`"alice" sees "7 Zinsen"`	Assert the page shows this text now, in its content or in a field
`"bob" sees "Neuer Satz." within "3s"`	Wait until the page shows this text, for at most the duration
`"alice" does not see "clause_id"`	Assert the page does not show this text now
`"alice" no longer sees "Saving…" within "5s"`	Wait until the page stops showing this text, for at most the duration
`"alice" sees "Apply" is disabled`	Assert a button, field or other control is disabled
`"alice" sees "Apply" is enabled`	Assert a button, field or other control is enabled
`"alice" url is "/master/7.2"`	Assert the page's address: the path with its query and fragment, or the whole URL when one is given

Step	Description
`"alice" saves screenshot "after-apply"`	Save what the page shows as .png in the screenshots directory