Postman collection runner

Input
Output

Postman Collection Runner

Open a Postman collection (v2.0 or v2.1) and run its requests from your browser, with its variables, folders, auth and bodies, and check every response with plain rules. No Postman app, no Newman, no account: nothing to install.

Example: an exported collection with a folder and auth

A collection with an Orders folder and bearer auth for the whole collection. With these responses, creating the order passes, and getting it fails one check because the status is still pending:

The collection

{
  "info": {
    "name": "Orders API",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "base",
      "value": "https://api.example.com"
    }
  ],
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{token}}"
      }
    ]
  },
  "item": [
    {
      "name": "Orders",
      "item": [
        {
          "name": "Create order",
          "request": {
            "method": "POST",
            "url": "{{base}}/v1/orders",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\"sku\":\"KB-01\",\"qty\":1}"
            }
          }
        },
        {
          "name": "Get order",
          "request": {
            "method": "GET",
            "url": "{{base}}/v1/orders/ORD-20419"
          }
        }
      ]
    }
  ]
}

Checks

status 2xx
[Create order] status == 201
[Create order] $.id exists
[Get order] $.status == "paid"

Output

Orders API: 1 of 2 requests passed
✓ POST Orders / Create order · 201 · 210 ms
✕ GET Orders / Get order · 200 · 88 ms
    ✕ [Get order] $.status == "paid": $.status is "pending"

How do I use the Postman collection runner?

  1. Export the collection from Postman (Collection v2.1) and paste or drop the .json file.
  2. Write checks, one per line, such as status 2xx or [Create order] $.id exists.
  3. Press Run to send the requests in order; read the report or save it as JUnit XML.

What does the Postman collection runner do?

  • Folders, {{variables}}, auth and the common pm.test assertions from the collection
  • Raw JSON and form bodies sent as written
  • Stop at the first failure, or keep going and see them all

When to use the Postman collection runner

A Postman collection already describes your API: every request, its folder, address, headers, auth and body. Running it usually needs the Postman app or Newman on the command line. Here the collection runs in your browser: paste or drop the exported .json and press Run, which is handy on a machine without Postman, or to share a quick check with someone who doesn't use it.

Bracely reads collections in the v2.0 and v2.1 formats. {{variables}} come from the collection, folders become part of each request's name, and bearer, Basic and API key auth, set on a request, a folder or the whole collection, are added to the requests. Raw bodies are sent as written and form bodies as name=value pairs; file uploads (form-data) are skipped and reported. The collection's own pm.test scripts run too, when they use the common assertions; checks of your own are plain lines, short and easy to read.

Frequently asked questions

Are my collection's pm.test scripts run?
The common ones are. pm.response.to.have.status(…), pm.expect(…) on the status, time, headers, text or JSON body with eql, include, above, below, a, exist, lengthOf, match and oneOf become checks, from the request, its folders and the collection. pm.environment.set("token", json.token) fills {{token}} in the requests after it, so a login then a call with its token works. A test with anything else in it, such as a loop, is listed as not run rather than passed: add it as a line in the second box.
Why does a request say it couldn't be reached?
Either the address is wrong, or the API doesn't allow requests from other websites (CORS), which the browser can't tell apart. Check the address, and that {{variables}} were filled in: the runner lists any it couldn't fill.
Is my data uploaded?
No. Bracely runs entirely in your browser, so nothing you paste or open leaves your device.

More JSON tools

Bracely has 104 JSON tools in one page. Related ones:

Runs entirely in your browser. Nothing you paste is uploaded. Made by Saurabh Pagrut · About · Privacy policy
Last updated · Version 6.1 · Changelog
Saurabh Pagrut on GitHub · LinkedIn · X · YouTube · Instagram