JavaScript Sandbox

1. Safe Mode
2. Developer Mode

​

Safe Mode

1. Open your collection in Bruno
2. Click on the Shield icon in the top right corner to switch the mode (Safe Mode is default)

​

Developer Mode

1. Open your collection in Bruno
2. Click on the Shield icon in the top right corner to switch the mode (Safe Mode is default)
3. Select Developer Mode from the dropdown

​

When to use Developer Mode

• You trust the collection source/authors (Ex: Collection maintained by you/your team) and Safe Mode is not enough for your use case.
• You need to use external npm packages in your scripts
• Your collection needs access to filesystem / system commands

​

When to avoid Developer Mode

• You are running a collection that you do not trust (Ex: Downloaded from the internet)

​

Detecting Sandbox Mode in Scripts

// Check if running in Safe Mode
if (bru.isSafeMode()) {
  console.log('⚠️ This collection requires Developer Mode.');
  console.log('Please switch to Developer Mode to use filesystem and external packages.');
} else {
  console.log('✓ Running in Developer Mode - all features available.');
  // Proceed with Developer Mode features
  const fs = require('fs');
  // ... use filesystem operations
}