Using Groovy in JMeter Assertions to Validate JSON Responses

Background

JMeter provides built‑in assertions to decide whether a sample passes or fails, but complex validation—such as checking JSON structure and values—often requires custom scripting. Groovy, supported via the JSR223 sampler/assertion, offers a concise and maintainable way to extend JMeter's capabilities.

Why Groovy?

Groovy integrates seamlessly with Java libraries, can use any third‑party JAR, and supports features like Power Assertion that make test logic clearer than BeanShell. Although JMeter’s Groovy compatibility is generally good, writing scripts that follow standard Java syntax ensures stability.

Demo Overview

The demo uses Apache JMeter 5.12 to send a request to an application server and asserts that the response contains a well‑formed JSON object with specific fields. The Groovy script parses the response, logs useful information, and asserts that json.success equals the expected value.

Step‑by‑Step Configuration

Simple start : Create a Thread Group and an HTTP Sampler.

Add assertion : Right‑click the sampler → Add → Assertions → JSR223 Assertion, and select Groovy as the language.

Element configuration : Set the language to Groovy 2.xx and configure other fields as shown in the screenshot.

Write script : Paste the Groovy code (see code block below) into the script area.

Run script : Execute the test plan and observe the results.

JSR223 Assertion Fields

Name – element name.

Language – script language (Groovy, BeanShell, JS, etc.).

Parameters – values passed to the script.

File name – path to an external script file (overrides inline script).

Script compilation cache – enables pre‑compilation for better performance; works with Java, JavaScript, BeanShell, but not with Groovy.

Groovy Script Example

import groovy.json.*
log.info("Thread group name " + prev.getThreadName())
def end_time = prev.getEndTime()
log.info("End time " + (new Date(end_time).toString()))
log.info("Response time: " + prev.getTime().toString())
log.info("Connect Time is: " + prev.getConnectTime().toString())
log.info("Latency is: " + prev.getLatency().toString())
log.info("Response size " + prev.getBytesAsLong().toString())
log.info("Request URL " + prev.getURL())
log.info("Test result is " + prev.isSuccessful().toString())

def response = prev.getResponseDataAsString()
log.info("Response content: " + response)

def json = new JsonSlurper().parseText(response)
log.info("Response code " + json.success)
assert 2 == json.success
log.info("Response headers: " + prev.getResponseHeaders())

Observations

The script logs various request/response metrics, parses the JSON payload with JsonSlurper, and asserts that the success field equals 2. In the provided run the assertion fails because the actual value is 1, demonstrating how custom failure messages can be generated.

Conclusion

Groovy inside JMeter’s JSR223 assertions offers a powerful, scriptable approach to validate complex JSON responses and capture detailed logs, extending JMeter beyond its built‑in assertions while remaining compatible with existing Java‑based test code.