• function

val FuncUnit.prototype.val

 

val([val] [,timeout] [,success] [,message])

Gets the val from an element or waits until the val is a certain value.

//checks foo's val has "JupiterJS"
ok( /JupiterJS/.test( S('input#foo').val() ) )

//waits until bar's val has JupiterJS
S('input#foo').val(/JupiterJS/)

//waits until bar's val is JupiterJS
S('input#foo').val("JupiterJS")

Parameters

  1. val {String | function()}Optional

    If provided uses this as a check before continuing to the next action.

  2. timeout {Number}Optional

    overrides FuncUnit.timeout. If provided, the wait will fail if not completed before this timeout.

  3. success {function()}Optional

    a callback that will run after this action completes.

  4. message {String}Optional

    if provided, an assertion will be passed when this wait condition completes successfully

Returns

{String | funcUnit}

if the val parameter is provided, returns the funcUnit selector for chaining, otherwise returns the html of the selector.