html.test.completeHtml element

getHtml(id).test.complete() (since beta 0.3)

Tests whether all the obligatory fields form the HTML document have been filled. See the IBEX documentation about the Form controller for a discussion of how fields are set as obligatory.

Example:

newHtml("demographics", "example_intro.html")
    .print()
,
newButton("continue", "Continue to the next page")
    .print()
    .wait(
        getHtml("demographics").test.complete()
            .failure( getHtml("demographics").warn() )
    )

Prints the content of exampleintro.html_ onto the page and adds a Continue button below it. The button is validated only when all the obligatory fields from exampleintro.html_ have been filled.

If the button is clicked and at least one obligatory field has not been filled, the warn command is executed and will display an appropriate error message.