You’re surely here because you are looking for the Ultimate Tutorial explaining how the Regex Extractor works.
Great News! This post covers everything you need to know about variable extraction using Regexp.
Then, you can re-use JMeter Variables in subsequent samplers and controllers (If Controller, Response Assertion etc.).
First, You’ll learn how to extract single or multiple values from a server response. Then, you’ll learn the secrets behind Regexp boost your extractors speed.
When To Use Regex Extractor
What I like about JMeter is that it is a protocol based tool, which means it makes it incredibly easy to scale thousands of users. Take for instance selenium, it is a great tool for functional testing but when it comes to generating many parallel instances we can see its limits.
First the memory footprint on your machines will be high but even worse, every process will be competing for resources and because of that response times may not be accurate. Since JMeter replays requests at the protocol level there is less overhead per thread and provided you keep an eye on the CPU/Memory of your machines the response times will be accurate enough.
Now regarding the title of this post you might be wondering where I’m getting at. Well the major drawback of protocol level testing is that all the browser side code or logic is not replayed. And this sometimes includes critical values not being computed/replaced automatically.
How To Use Regex Extractor
The usual way to take care of such values is often called correlation but whatever its name the idea is to extract values from server responses to send them along with the next requests. Something your browser does for you when you navigate through any application, but that JMeter does not do since it is protocol based. There are several methods to take care of this in JMeter, we’ve already talked about the JSON Path extractor, today let’s focus on the most popular one: JMeter’s Regular Expression Extractor.
First before jumping into an example, here is a link to the documentation about the Regular Expression Extractor.
In here you will find all details you need, but as you can see it’s pretty dense to start with. So instead, I’d like to cover a few examples with an increasing complexity. And of course you can always refer to the documentation when you come up with a more complex situation.
A quick note on the regex post processor, it is the most efficient way to extract values from responses available in JMeter. Maybe not in terms of time or complexity, but in terms of resources required during a test. Which makes it a mandatory step toward mastering JMeter. That does not mean you should not use JSON or XPATH, but if you do, do not use more than a few or you will risk memory issues.
Extracting One Value
So first we will work on the following HTML response:
<!DOCTYPE html> <html> <body> <form> First name:<br> <input type="text" name="firstname" value="John"><br> Last name:<br> <input type="text" name="lastname" value="Cena"> </form> </body> </html>
It is quite simple, but will do nicely. And once again I think it is better to start with an easy example.
Regarding our test protocol, this static page will be hosted in a local apache, so we will use the following configuration:
We will then try to extract the value of some of or all the inputs using regexp post processors. And speaking of regex, we’re going to use the following one:
- Field to check: We will stick to the response body here, since we want to extract from the HTML.
- Reference Name: What’s really important here is the
Reference Namesince this will be the variable name we can use later on.
- Regular expression: The regular expression field contains the regex itself, in our case we want to extract what’s between
.+?we will extract any character (except newline chars:
\n \r) that occurs one or more times. Since we want to use this value later on we’ve put parenthesis around it. This will place it in what’s called a group.
- Template: And speaking of group, that’s exactly what you can see in the template field. Here we state that the value of the SingleName variable should contain the first group.
- Match No.: The match number is appropriate when the regex corresponds to several values in the response.
Which is true in our case, if you look at the HTML there are two
value="fields that could correspond. For now we want to keep it simple and will always extract the first one.
- Default value: And last the default value is the value of the SingleName variable when no match was found.
Now we will be using the Debug sampler to control the extracted value of our regex:
This sampler will let us know the current value of all variables, so I strongly suggest you use it too. It is a very good way to learn how regex work through quick trial and error.
In our case we can see the following values:
The first one is the most commonly used, since it is the variable itself, it contains the first occurrence of our regex in the HTML.
If you want to try it out on your side, you can copy/paste the HTML and regex in a testing tool like Regex101.
The other values are not always proper, but they give us some details:
- _g : The number of groups, ie regex within parenthesis.
- _g0 : value of group 0 that contains the extracted value along with the boundaries.
- _g1 : value of group 1, useful in case you have nothing specified in the template, or if you have several groups, but more on that later.
To conclude this first example, we can see the value we extracted is the one we expected to have, which is the only thing that matters. Also we’ve seen that there are other variables created automatically by JMeter, so now we will have a closer look at them.
Extracting Multiple Values
A use case that is often encountered is when you want to extract not only one value, but the list of all values. This is what is called multiple occurrences. The regex is not much different:
I’ve just used a different name and a negative occurrence number. This will tell JMeter to extract all available occurrences. Note that occurrence 0 tells JMeter to extract one occurrence randomly amongst all that are available.
And the result is much different this time:
We see the following values:
The first one now contains the
default value, this is because it’s mandatory to refer to an occurrence number now.
To do that you must add
_1 at the end of the variable name, and before the group number.
Which is why we can see the same 4 values than last time but with
_1 in their variable name and also 4 other values corresponding to the second occurrence.
_matchNr tells us how many occurrences were extracted, this can be convenient when you want to loop on them, although I would recommend the For Each loop that makes this process easier.
Extract Linked Values Using Groups
So this time we will have a look at multiple groups. The regex configuration will be as follows:
I think it’s worth zooming on the regex:
**The first part remains the same, so we will still extract the value of the first HTML parameter.
Then we use
[^^]+? to specify that there can be any chars between the first section and what comes next.
[^^] guarantees we will not even stop at end of lines, technically it means everything except the
And then we have the first section again, this time to extract the value of the second HTML parameter.
The template is also different since we have two groups, I decided to use a value template with group 1, a dash, and group 2.
This way when we use the variable name instead of a specific group, we expect something like this:
And the result is:
Let’s have a closer look at the values:
<input type=“text” name=“lastname” value=“Cena”
As you can see the first value is what we expected to have.
Then we are told we have two groups this time since
_g0 which includes the boundaries around the values is quite large since we specifically said we should include new lines.
We can also use the group names to get either one of the two values now (
Although this example might not really make sense in a real life situation (we would use multiple occurrences) I think it goes a long way to show how you can easily extract several values with one regex. This is extremely handy when extracting values that are linked together (first name and lat name, etc…).
Extract Multiple Lines
Sometimes, it can happen that you want to extract a *multiline value. It’s a value dispatched over multiple lines. As stated in JMeter Regex Meta-chars, The following Perl5 extended regular expression are supported by JMeter:
menables multiline treatment of the input.
Multi-line (?m) modifier is normally placed at the start of the regex. For Example:
(?m)value="(.?+)". In this case, the value between double quotes (
") is matched on multiple lines.
Regex You Can Use Now
Before I conclude, I’d like to share some regex example I often use. Feel free to share your best regex in the chat below as well!
When dealing with HTML parameters, you want to extract values that are between double quotes
To do so, I always use the following regex, since it will stop only when encountering the next double quote.
And this can be practical on some applications:
When dealing with more complex situations, you can sometimes easily create a simple regex by extracting just numerical chars:
Or alphanumerical chars only:
Also the multi-line regex we’ve seen earlier can be useful when dealing with very long values:
And of course you can create your own character classes depending on the situation, here for a uuid (ex:123e4567-e89b-12d3-a456-426655440000):
How OctoPerf Helps
As we’ve seen regex are pretty powerful but at the same time they require experience. But since they are the most efficient way to extract data it is important to be able to use them efficiently.
For this reason, we have created a simple mode on top of the regex post processor in OctoPerf. This will allow you to just select the text you want to extract:
And when you go to the advanced tab, the regex, template, match number and default value have been pre-filled with your selection:
Any special char will also be escaped automatically, and as you can see you have the same possibilities than in JMeter. What makes it even better, is that you can instantly test it through the “check” tab:
Last but not least, since you’re likely to have to use the same regex in several places, instead of copy pasting it manually, you can use our correlation rule engine) to automate the search and replace of your regex.
Wouldn’t it be better to use the new CSS/jQuery extractor. Are there any advantages to using regular expressions?
Although CSS / JQuery extractors may help to extract content from the server response more easily, there is a trade-off: they consume way more CPU / Memory resources. The learning curve is also stepper. Regexp are usually wide-spread in many loading tools while CSS / JQuery extractions seem to be limited to JMeter. As they parse the response before processing it to extract the content, you may end up simulating less users per load generator.
What If I don’t know how to write regular expressions?
Take a look at Regexp Coach, it’s a great tool to test regular expression on arbitrary content.
JMeter Post-Processors are at the heart of Performance Testing:
And since protocol based testing is still the best way to stress an application it is important to understand at least the basics of this process.