IntelliJ IDEA 2018.2 Help

Using Breakpoints

Breakpoints are source code markers used to trigger actions during a debugging session.

Breakpoint types

IntelliJ IDEA lets you create breakpoints of several types. Each breakpoint type supported by IntelliJ IDEA addresses different debugging needs and has its own individual settings.

Breakpoints are triggered when the program reaches the specified line of source code, before it is executed. The line of code that contains a set breakpoint, is marked with a red stripe; once such line of code is reached, the marking stripe changes to blue.

breakpoints

Once set, a breakpoint remains in project until removed. Breakpoints can only be set on executable lines of code. Comments, declarations of fields or methods, and empty lines are not valid locations for breakpoints.

IntelliJ IDEA enables you to set the following types of breakpoints:

Line breakpoint

These breakpoints are assigned to lines of source code and are used to target a particular section for debugging.

Temporary line breakpoint

These breakpoints are assigned to lines of source code and are used to target a particular section for debugging. When hit, such breakpoints are immediately removed.

Method breakpoint

Method breakpoints act in response to the program entering or exiting a particular method. They let you target your debugging sessions by method you wish to investigate, rather than by line number. Method breakpoints let you follow the program flow at the method level as well as check entry and exit conditions. Note that using method breakpoints can slow down the application you are debugging.

Exception breakpoint

IntelliJ IDEA provides exception breakpoints for Java and JavaScript.

Exception breakpoints are triggered when the specified exception is thrown. Unlike the line breakpoints, which require specific source references, exception breakpoints apply globally to the exception condition, rather than to a particular code reference.

With PHP Exception Breakpoints, you can initiate the debugger at the start of the script and break on your own breakpoints or whenever an error or Exception of a given type occurs. PHP Exception breakpoints do not require configuring Xdebug for working in the Just-In-Time mode by setting xdebug.remote_mode to jit, see Debugging in the Just-In-Time Mode for details.

Field watchpoint

Field watchpoints allow you to react to any access or modification of specific instance variables. For example, if at the end of a complicated process you are ending up with an obviously wrong value on one of your fields, then setting up a field watchpoint may be the quickest way to determine the origin of the fault.

JavaScript / Flex /PHP breakpoints

JavaScript, Flex, and PHP breakpoints are identical to line breakpoints in Java.

These breakpoints are assigned to particular lines of JavaScript or PHP source code. They can be set in *.html files as well as in *.js or *.php files and are used to target a particular section of code for debugging.

Breakpoints icons and statuses

When a breakpoint is set, the editor displays a breakpoint icon in the gutter area to the left of the affected source code. A breakpoint icon denotes status of a breakpoint, and provides useful information about its type, location, and action.

The icons serve as convenient shortcuts for managing breakpoints. Clicking an icon removes the breakpoint. Successive use of Alt - click on an icon toggles its state between enabled and disabled. The settings of a breakpoint are shown in a tooltip when a mouse pointer hovers over a breakpoint icon in the gutter area of the editor.

java breakpoints

The table below summarizes the possible breakpoint states:

StatusLine
JavaScript
Flex
Temporary LineExceptionMethodFieldDescription
Enableddb set breakpointbreakpointTemporaryicons debugger db exception breakpoint svgmethod breakpointicons debugger db field breakpoint svgShown at design-time or during the debugging session when the class with such breakpoint is not yet loaded.
Validverified breakpointN/AN/Averified method breakpointverified field breakpointShown at run-time when the breakpoint is recognized by the debugger as set on an executable code line.
Invalidinvalid breakpointinvalid breakpointN/Ainvalid method breakpointinvalid field breakpointShown when the breakpoint is set on a commented or non-executable line indicating that such breakpoint would not be hit.
Disabledicons debugger db disabled breakpoint svgicons debugger db disabled breakpoint svgicons debugger db disabled exception breakpoint svgicons debugger db disabled method breakpoint svgicons debugger db disabled field breakpoint svgIndicates that nothing happens when the breakpoint is hit.
Conditionally disableddb dep line breakpointdb dep line breakpointicons debugger db exception breakpoint svgdb dep method breakpointdb dep field breakpointThis state is assigned to breakpoints when they depend on another breakpoint to be activated.

When the button icons debugger muteBreakpoints svg is pressed in the toolbar of the Debug tool window, all the breakpoints in a project are muted, and their icons become grey: muted breakpoint.

Last modified: 14 June 2018

See Also