JSONPath RegEx Match Assertion

This assertion is available in multiple ReadyAPI applications. Depending on the application, it validates the following data:

• Functional tests
• Security tests
• APIs (Virtual)

Follow these steps:

Click the image to enlarge it.

1. Open a test step.

2. Click Add assertion.

In the New Assertions dialog, search for the JSONPath RegEx Match assertion or select it manually in the Property Content category.

Follow these steps:

Click the image to enlarge it.

1. Open a security test.

2. Click Response Assertion next to any scan.

3. Click in the Assertions panel

In the New Assertions dialog, search for the JSONPath RegEx Match assertion or select it manually in the Property Content category.

Follow these steps:

Click the image to enlarge it.

1. Open a virtual service.

2. Open the Assertions drop-down panel.

3. Click in the Assertions panel

In the New Assertions dialog, search for the JSONPath RegEx Match assertion or select it manually in the Property Content category.

1. In the JSONPath Expression edit box, specify the JSONPath expression to point at the element you want to compare the regular expression with, or use the toolbar controls to create the expression automatically.

   To use the toolbar controls, run the request you want to validate at least once.

   

   Click the image to enlarge it.

   Click to call the Select JSON dialog. Use it to select a node from the last request or response and create a JSON path expression for this node.

2. In the Regular Expression edit box, specify the regular expression you want to use for the comparison.

3. In the Expected Result edit box, specify the value you are expecting to get.

   Use these commands to visually select the value from the existing request or response:

   Option	Description
   Select Content	Add a property expansion in the result.
   Select from Current	Get a value from the last response you have received (or the last request the virtual service has received).

4. To command the assertion to use an asterisk wildcard (*) for varying parts of the value, select Allow Wildcards.

   Note:

   If you do not select this option, the assertion will fail on dynamic values.

5. To test your assertion on the last response you have received (or the last request the virtual service has received), click Test.

• To avoid typing the desired JSONPath expression manually, click and select the desired JSON element or attribute in the subsequent dialog.

  

  ReadyAPI will form the JSONPath expression that refers the selected item, and will set the result from the last request or response as the expected result.

• ASP.NET-based services enclose the JSON response payload into the d root element for security reasons. By default, ReadyAPI does not strip the d element out, but there is an option to automatically remove it. If you turn this option on, JSON-related assertions created from the JSON response will not take the root element into account, which can cause the assertion to fail unexpectedly.