Skip to main content
The generated documentation is executable, not just readable. Every request has a Try button that opens an interactive playground, plus ready-to-copy code samples.

​
Try Requests Live

Click Try on a request to open the playground. From there you can:
  • Edit parameters, headers, and body
  • Run the request live from the documentation
  • See the response immediately
  • Inspect and edit the scripts that belong to that request
Try It Out Playground

​
Scripting in the playground

When you hit Try, Bruno runs the same collection scripts the desktop app would run: pre-request, post-response, and tests. Collection, folder, and request scripts still stack in that order. The playground runs those scripts in a browser sandbox that matches Safe Mode in the desktop app. bru, req, and res are the same objects you already use in collection scripts. If a script works in Safe Mode on your machine, it should behave the same way here. That includes:
  • Environment, global environment, and runtime variables (bru.getEnvVar, bru.setVar, and related helpers)
  • Collection, folder, and request variables (bru.getCollectionVar, bru.getFolderVar, bru.getRequestVar)
  • Secrets resolved at run time with bru.getSecretVar
  • bru.interpolate (this is a real interpolation, not a no-op)
  • bru.sleep, bru.sendRequest, and bru.utils
  • Flow control such as bru.setNextRequest
  • The Safe Mode req and res accessors (URL, method, headers, body, status, and so on)
The full method list lives in the JavaScript reference. Treat that page as the Safe Mode contract. The playground follows it, except for the APIs called out below.
Secret values are resolved when a reader runs a request. They are not written into the generated HTML as plaintext. Keep using secret variables the way you already do in the collection.

​
What the playground cannot run

A few APIs need the desktop app and are not available in the browser sandbox. Developer Mode features (filesystem access, system commands, extra npm packages) are also out of reach here. If a script calls one of the deferred APIs, the playground does not fail silently. It shows a warning in the response pane, naming the API:
For example: bru.visualize is not currently supported in the Bruno playground. Please use the Bruno desktop app. If a collection depends on those APIs (iteration data, OAuth credential storage, cookie jar, or response visualization), run it in Bruno on the desktop. The playground is still useful for trying the request and for scripts that stay on the Safe Mode bru / req / res surface.

​
Code Samples

The documentation generates copyable snippets for each request in:
  • cURL
  • Python (requests)
  • JavaScript

​
Tests and Scripts Display

The playground also shows:
  • Pre-request and post-response scripts for each request
  • Params, variables, body, headers, auth, and test logic
  • Tests and assertions in the documentation