Extractors

Properties¶

• key: You can use this extractor to extract variables from the response body JSON.

Example¶

This example will extract the user ID from the response body JSON and store it in the variable user_id.

extractors:
  trigger:
    - if: response.status_code
      is: 200
  extract:
    - key: response.body.json
      jq: '.user.id'
      variable: 'user_id'

• variable: The variable name (Case Insensitive) to store the extracted data.
• can_overwrite: Whether the extractor can overwrite the variable if it already exists.
• jq: JQ query to apply to the JSON body. See https://stedolan.github.io/jq/manual/

Properties¶

• key: You can use this extractor to extract variables from the response headers.

Example¶

This example will extract a token from the response header X-Token and store it in the variable x_token.

extractors:
  trigger:
    - if: response.status_code
      is: 200
  extract:
    - key: response.headers
      name: 'X-Token'
      variable: 'x_token'

• variable: The variable name (Case Insensitive) to store the extracted data.
• can_overwrite: Whether the extractor can overwrite the variable if it already exists.
• name: Header name to extract from

Properties¶

• key: You can use this extractor to extract variables from the response body text.

Example¶

This example will extract the response body text and store it in the variable body_data.

extractors:
  trigger:
    - if: response.status_code
      is: 200
  extract:
    - key: response.body.text
      variable: 'body_data'

• variable: The variable name (Case Insensitive) to store the extracted data.
• can_overwrite: Whether the extractor can overwrite the variable if it already exists.

Properties¶

• key: You can use this extractor to extract variables from the response cookies.

Example¶

This example will extract a session cookie returned in response (set-cookie) and store it in the variable session.

extractors:
  trigger:
    - if: response.status_code
      is: 200
  extract:
    - key: response.cookies
      name: 'session'
      variable: 'session'

• variable: The variable name (Case Insensitive) to store the extracted data.
• can_overwrite: Whether the extractor can overwrite the variable if it already exists.
• name: Cookie name to extract from

Properties¶

• key: You can use this extractor to extract the response status code as a variable.

Example¶

This example will extract the response status code and store it in the variable status_code.

extractors:
  extract:
    - key: response.status_code
      variable: 'status_code'

• variable: The variable name (Case Insensitive) to store the extracted data.
• can_overwrite: Whether the extractor can overwrite the variable if it already exists.

Properties¶

• key: You can use this extractor to extract variables from the request cookies.

Example¶

This example will extract a session cookie sent in request (cookie) and store it in the variable session.

extractors:
  trigger:
    - if: response.status_code
      is: 200
  extract:
    - key: request.cookies
      name: 'session'
      variable: 'session'

• variable: The variable name (Case Insensitive) to store the extracted data.
• can_overwrite: Whether the extractor can overwrite the variable if it already exists.
• name: Cookie name to extract from

Properties¶

• key: You can use this extractor to extract the response duration as a variable.

Example¶

This example will extract the response duration and store it in the variable duration.

extractors:
  extract:
    - key: response.duration
      variable: 'duration'

• variable: The variable name (Case Insensitive) to store the extracted data.
• can_overwrite: Whether the extractor can overwrite the variable if it already exists.

Properties¶

• key: You can use this extractor to extract an argument from request body as a variable.

Example¶

This example will extract the request argument value if it matches the given scalar and store it in the variable arg.

extractors:
  extract:
    - key: request.argument
      variable: 'arg'
      scalars:
        - id
        - uuid

This example will extract the user ID sent in a request body JSON and store it in the variable arg.

extractors:
  extract:
    - key: request.argument
      variable: 'arg'
      jq: '.user.id'

• variable: The variable name (Case Insensitive) to store the extracted data.
• can_overwrite: Whether the extractor can overwrite the variable if it already exists.
• jq: JQ query to apply to the JSON body. See https://stedolan.github.io/jq/manual/