Webtest WebTest GitHub Home

Core Step storeXPath

Description

This step stores the result of an XPath expression into a property.

You may want to use an online tool such as xpathtester, an IDE or an XML editor for finding appropriate expressions.

Parameters

xpath
Required? yes
The XPath that shall be evaluated.
default
Required? no
The value to store in the property when the xpath evaluation returns no result (if not set, the step will fail if the xpath evaluation returns no result).
description
Required? no
The description of this test step.
property
Required? no
The name of the property in which to store the retrieved value.
propertyType
Required? no, default is the "defaultPropertyType" as specified in the "config" element is used.
The type of the property in which to store the retrieve value. Either "ant" or "dynamic".

Details

The following example extracts the href attribute from the first anchor element and uses it for the following invoke.

storeXPath example
<webtest name="...">
  <config ... />
  <steps>
    <invoke ... />
        <storeXPath
            description="Extract href of first link on page"
            xpath="//a[1]/@href"
            property="uri" />
        <invoke
            description="Invoke target page specified in href"
            url="#{uri}" />
    ...
  </steps>
</webtest>

See also: the verifyXPath step.