WebStorm 2023.3 Help

Step through the program

Stepping is the process of controlling step-by-step execution of the program.

WebStorm provides a set of stepping actions, which are used depending on your strategy (for example, whether you need to go directly to the next line or enter the methods invoked on your way there).

Stepping actions are located on the window toolbar and in the menu:

Debug tool window: stepping actions on the toolbar

Step over

Steps over the current line of code and takes you to the next line even if the highlighted line has method calls in it. The implementation of the methods is skipped, and you move straight to the next line of the caller method.

  • Click the Step Over button Step Over button or press F8.

In the example, line 22 is about to be executed. If you step over, the debugger will move straight to line 23 without jumping into the print_chart() method.

Step over

If there are breakpoints inside the skipped methods, the debugger will stop at them.

Step over: stopping at a breakpoint within the skipped method

To skip any breakpoints on the way, use Force step over Alt+Shift+F8.

Step over: ignoring a breakpoint in the called method with Force step over

Step into

Steps inside the code of a called function.

  • Click the Step Into button Step Into button or press F7.

In the example, line 22 is about to be executed. If you step into, the debugger will jump into the implementation of the print_chart() method allowing you to examine in detail how its result is produced.

Stepping into a called method

If there are several method calls on the line, WebStorm asks you which method to enter. This feature is called Smart step into.

Step into on a line with multiple method calls: automatic smart step into

By default, Smart Step Into is used automatically every time you invoke Step Into F7 on a line with multiple method calls. You can turn off automatic Smart Step Into and enter each called method in the order they are called using the Step Into and Step Out buttons.

Automatic Smart step into off: entering called methods in the order they are called using Step into and Step out

Some scripts are skipped by Step into as you normally might not need to debug them.

Suppress stepping into scripts

  1. In the Settings dialog (Ctrl+Alt+S) , go to Build, Execution, Deployment | Debugger | Stepping. The Debugger. Stepping page opens.

  2. To suppress automatic Smart Step Into, clear the Always do smart step into checkbox.

  3. To skip all library scripts, select the Do not step into library scripts checkbox. See example below.

  4. To suppress stepping into some specific scripts, select the Do not step into scripts checkbox and create a list of such scripts using the toolbar buttons.

Smart step into

Smart step into is helpful when there are several method calls on a line, and you want to be specific about which method to enter. This feature allows you to select the method call you are interested in.

Use Tab to switch between the method calls and press Enter to select the method to step into.

Step into on a line with multiple method calls: automatic smart step into

By default, Smart Step Into is used automatically every time you invoke Step Into on a line with multiple method calls.

To suppress automatic Smart Step Into, open the Settings dialog (Ctrl+Alt+S) , go to Build, Execution, Deployment | Debugger | Stepping, and clear the Always do smart step into checkbox.

After that, the Smart Step Into icon appears on the toolbar of the Debug tool window. Click this icon or press Shift+F7 to invoke Smart Step Into manually.

Smart step into: manual invocation

Step out

Steps out of the current method and takes you to its call.

  • Click the Step Out button Step Out button or press Shift+F8.

In the example, stepping out skips all iterations of the loop and takes you straight to its call.

Stepping out from a method to its caller

Run to cursor

Continues the execution until the position of the caret is reached.

  • Place the caret at the line where you want the program to pause and select Run to Cursor from the menu or press Alt+F9.

    Run to cursor: place the caret at the line to stop at
  • Hover over the gutter next to the line where you want to run to and click the Run To Cursor icon.

    Run to cursor: click line number in the gutter

In the example, Run to Cursor will continue the execution and stop at line 23 as if there were a breakpoint.

Run to cursor: click the gutter icon

If there are breakpoints in the print_chart() method, the program will be suspended there.

Run to cursor: the debugger stops at the breakpoint in the skipped code

To skip any breakpoints on the way, use Force run to cursor.

Force step into

Steps in the method even if this method is skipped by the regular Step Into.

  • Go to Run | Debugging Actions | Force Step Into.

  • Press Alt+Shift+F7.

  • Click the Force Step Into icon on the toolbar.

    To add the Force Step Into icon to the debugger toolbar:

    1. Right-click the toolbar of the Debug tool window or click the Options icon on it.

      Customize stepping toolbar - Options icpon

      From the context menu, select Customize toolbar.

      Customize stepping toolbar - context menu
    2. In the Customize Debug Tool Window Top Toolbar dialog, click the Add icon and select Add Action.

      Add Action
    3. In the Add Action dialog, start typing Force Step Into in the search field. WebStorm finds and highlights the Force Step Into action.

      Add Action dialog
    4. Click OK to return to the Customize Debug Tool Window Top Toolbar dialog, where the action is added to the list. Click OK.

      Action added

      After that, the Force Step Into icon appears on the debugger toolbar.

    Debug tool window: customize toolbar

In the example, the debugger skips a library method console.log() with regular Step Into at line 4 but enters this method at line 10 with Force Step Into.

Force step into overrides the list of ignored scripts

Force run to cursor

Continues the execution until the position of the caret is reached. All breakpoints on the way are ignored.

  1. Place the caret at the line where you want the program to pause.

  2. Select Force Run to Cursor from the menu or press Ctrl+Alt+F9.

In the example, Force run to cursor will continue the execution and stop at line 24 as if there were a breakpoint. The breakpoint inside print_chart() will not have any effect.

The caret is at the line where we want to go

Force step over

Steps over a line with a call of a method where breakpoints are set. The breakpoints are ignored.

  • Select Force Step Over from the menu or press Alt+Shift+F8.

In the example, force stepping over takes you to the print statement on line 22 even though there is a breakpoint in the print_chart() method, which would otherwise, with Step Over, suspend the application in all iterations of the loop.

Step over: ignoring a breakpoint in the called method with Force step over
Last modified: 20 February 2024