Lightning Aura Components Developer Guide

Introducing Aura Components
Quick Start
Creating Components
Using Components
Communicating with Events
Communicating Across the DOM with Lightning Message Service
Creating Apps
Styling Apps
Developing Secure Code
Using JavaScript
Working with Salesforce Data
Testing Components
Debugging
Enable Debug Mode for Lightning Components
Disable Caching Setting During Development
Salesforce Lightning Inspector Chrome Extension
Log Messages
Performance
Reference
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Enable Debug Mode for Lightning Components

Enable debug mode to make it easier to debug JavaScript code from Lightning components. Only enable debug mode for users who are actively debugging JavaScript. Salesforce is slower for users who have debug mode enabled.
Available in: Salesforce Classic (not available in all orgs) and Lightning Experience
Available for use in: Contact Manager, Group, Professional, Enterprise, Performance, Unlimited, and Developer Editions

Create Lightning components using the UI in Enterprise, Performance, Unlimited, Developer Editions, or a sandbox.

The Lightning Component framework executes in one of two modes: production and debug.

Production Mode

By default, the framework runs in production mode. This mode is optimized for performance. Framework code is optimized and “minified” to reduce the size of the JavaScript code. As a result of this process, the JavaScript code served to the browser is obfuscated.

Optimization and minification are performed on framework code only. Custom component code is not minified or obfuscated. Untouched custom component code includes both components you create yourself, and components installed as part of a managed package.

Minification is a performance optimization, not intellectual property protection. Code that’s minified is hard to read, but it’s not encrypted or otherwise prevented from being viewed.

Important

Debug Mode

When you enable debug mode, framework and component JavaScript code isn’t minified and is easier to read and debug. Debug mode also adds more detailed output for some warnings and errors.

Debug mode has a significant performance impact. Salesforce is slower for any user who has debug mode enabled. For this reason, we recommend using it only when actively debugging JavaScript code, and only for users involved in debugging activity. Don’t leave debug mode on permanently. Users who have debug mode enabled see a banner notification once a week while it’s enabled.

Important

To enable debug mode for users in your org:

  1. From Setup, enter Debug Mode in the Quick Find box, then select Debug Mode Users.
    Users with debug mode enabled have a check mark in the Debug Mode column.
  2. In the user list, locate any users who need debug mode enabled. If necessary, use the standard list view controls to filter your org’s users.
  3. Enable the selection checkbox next to users for whom you want to enable debug mode.
  4. Click Enable.
To disable debug mode for a user, follow the preceding steps and click Disable instead of Enable.