Extractors
An extractor is attached to a chain step and pulls a value out of the step’s response into a named variable. That variable is then available to all subsequent steps in the chain via {{variableName}}.
[SCREENSHOT: Extractor configuration panel — type dropdown, expression field, variable name field]
Configuration
Section titled “Configuration”| Field | Description |
|---|---|
| Type | Extractor type (protocol-specific, see below) |
| Expression | What to extract (meaning depends on type) |
| Variable name | Name of the variable to store the result in |
HTTP extractors
Section titled “HTTP extractors”HTTP_STATUS
Section titled “HTTP_STATUS”Extracts the HTTP response status code as a string.
| Field | Value |
|---|---|
| Expression | (not used) |
| Example output | "200" |
HTTP_JSON_PATH
Section titled “HTTP_JSON_PATH”Evaluates a JSONPath expression against the response body.
| Field | Value |
|---|---|
| Expression | JSONPath string, e.g. $.data.token |
| Example output | "eyJhbGci..." |
HTTP_BODY_RAW
Section titled “HTTP_BODY_RAW”Returns the entire response body as a string.
| Field | Value |
|---|---|
| Expression | (not used) |
SMTP extractors
Section titled “SMTP extractors”SMTP_SUCCESS
Section titled “SMTP_SUCCESS”Returns "true" if the SMTP exchange completed without any assertion failures, "false" otherwise.
| Field | Value |
|---|---|
| Expression | (not used) |
SMTP_EXCHANGE_LINES
Section titled “SMTP_EXCHANGE_LINES”Returns the server’s response lines for a specific command, joined as a string.
| Field | Value |
|---|---|
| Expression | The command string to match (e.g. MAIL FROM:<sender@example.com>) |
Leave the expression blank to match the server greeting exchange.
IMAP extractors
Section titled “IMAP extractors”IMAP_SUCCESS
Section titled “IMAP_SUCCESS”Returns "true" if all IMAP commands completed successfully.
| Field | Value |
|---|---|
| Expression | (not used) |
IMAP_EXCHANGE_LINES
Section titled “IMAP_EXCHANGE_LINES”Returns the untagged server lines for a specific IMAP command.
| Field | Value |
|---|---|
| Expression | The command string to match (e.g. SEARCH UNSEEN) |
Leave the expression blank to match the server greeting.
LDAP extractors
Section titled “LDAP extractors”LDAP_SUCCESS
Section titled “LDAP_SUCCESS”Returns "true" if the LDAP operation completed without assertion failures.
| Field | Value |
|---|---|
| Expression | (not used) |
LDAP_EXCHANGE_RESULT_CODE
Section titled “LDAP_EXCHANGE_RESULT_CODE”Returns the result code for a specific LDAP operation as a string.
| Field | Value |
|---|---|
| Expression | A prefix of the operation string (e.g. BIND cn=admin) |
| Example output | "0" (success) |
Generic extractors
Section titled “Generic extractors”CONSTANT
Section titled “CONSTANT”Stores a fixed value into a variable — useful for passing hardcoded values or defaults through the chain context.
| Field | Value |
|---|---|
| Expression | The literal string value to store |
Applies a regular expression to the value of another variable and stores the first capture group.
| Field | Value |
|---|---|
| Expression | Regex pattern with one capture group, e.g. token=([A-Za-z0-9]+) |
The source for REGEX is the previous extractor’s output or a named variable — configure the input variable in the extractor settings.