Hurl

HTTP testing tool that runs requests defined in plain text. Chain requests, capture values, and assert responses declaratively.

56 commands

Browse by Topic

Getting Started

Quick setup and installation

3commands

Running

Execute Hurl files

10commands

Syntax

Hurl file syntax

16commands

Assertions

Response assertions

13commands

Options

Variables & config

14commands

Install Hurl (macOS)

$ brew install hurl

Install Hurl HTTP testing tool using Homebrew on macOS

Install Hurl (Linux)

$ sudo apt install hurl -y

Install Hurl HTTP testing tool using apt on Debian/Ubuntu

Check Hurl version

$ hurl --version

Verify Hurl is installed and display the current version

Run Hurl file

$ hurl api.hurl

Execute requests in Hurl file.

Run in test mode

$ hurl --test api.hurl

Run with test output format.

Verbose output

$ hurl --verbose api.hurl

Show detailed request/response.

Very verbose

$ hurl --very-verbose api.hurl

Show all details including timings.

Run multiple files

$ hurl *.hurl

Execute multiple Hurl files.

Follow redirects

$ hurl --location api.hurl

Follow HTTP redirects automatically.

Set connect timeout

$ hurl --connect-timeout 10 api.hurl

Set connection timeout in seconds.

No output body

$ hurl --no-output api.hurl

Suppress response body output.

Use proxy

$ hurl --proxy http://proxy:8080 api.hurl

Route requests through proxy.

Insecure SSL

$ hurl --insecure api.hurl

Skip SSL certificate verification.

Status assertion

$ HTTP 200

Assert HTTP status code.

JSONPath assertion

$ [Asserts] jsonpath "$.users" count == 10 jsonpath "$.users[0].name" == "John"

Assert JSON response values.

Header assertion

$ [Asserts] header "Content-Type" == "application/json"

Assert response header.

Duration assertion

$ [Asserts] duration < 1000

Assert response time.

Body contains

$ [Asserts] body contains "success"

Assert body contains string.

XPath assertion

$ [Asserts] xpath "//title" == "Home Page"

Assert XML/HTML with XPath.

Regex assertion

$ [Asserts] regex "id=(\d+)" == "123"

Assert body matches regex pattern.

Certificate assertion

$ [Asserts] certificate "Subject" contains "example.com"

Assert SSL certificate fields.

SHA-256 body assertion

$ [Asserts] sha256 == hex,e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855;

Assert body SHA-256 hash.

JSONPath exists

$ [Asserts] jsonpath "$.id" exists jsonpath "$.error" not exists

Assert field exists or not.

JSONPath type assertion

$ [Asserts] jsonpath "$.count" isInteger jsonpath "$.active" isBoolean

Assert JSON value types.

Cookie assertion

$ [Asserts] cookie "session" exists cookie "session[HttpOnly]" exists

Assert cookie and attributes.

Bytes assertion

$ [Asserts] bytes count > 0

Assert response body byte count.

Pass variables

$ hurl --variable host=api.example.com api.hurl

Pass variable to Hurl file.

Variables file

$ hurl --variables-file vars.env api.hurl

Load variables from file.

JSON output

$ hurl --json api.hurl

Output results as JSON.

HTML report

$ hurl --test --report-html report/ api.hurl

Generate HTML test report.

Retry on failure

$ hurl --retry 3 api.hurl

Retry failed requests.

JUnit report

$ hurl --test --report-junit results.xml api.hurl

Generate JUnit XML report.

Color output

$ hurl --color api.hurl

Force colored terminal output.

Max redirects

$ hurl --max-redirs 5 api.hurl

Set maximum redirect follows.

Retry with interval

$ hurl --retry 5 --retry-interval 2000 api.hurl

Retry with 2 second intervals.

Output to file

$ hurl --output response.bin api.hurl

Save response body to file.

Use client certificate

$ hurl --cert cert.pem --key key.pem api.hurl

Use client certificate for mTLS.

Multiple variables

$ hurl --variable host=localhost --variable port=8080 --variable token=abc api.hurl

Pass multiple variables at once.

Glob pattern files

$ hurl --test tests/**/*.hurl

Run all Hurl files with glob pattern.

TAP report

$ hurl --test --report-tap results.tap api.hurl

Generate TAP format report.

Discussion

Loading comments...