Review changes

/

Previous Difference / Next Difference Shift+F7 F7

Jump to the next or previous difference.

When the last or the first difference is reached, WebStorm suggests clicking the arrow buttons or pressing F7/Shift+F7 once more and comparing other files modified locally. This behavior depends on the Go to the next file after reaching last change option in the Differences Viewer settings.

This behavior is supported only when the Differences Viewer is invoked from the Commit tool window Alt+0.

Jump to Source

F4

Open the selected file in the editor. The caret is placed in the same position as in the Differences Viewer.

Compare Previous/Next File

Alt+LeftAlt+Right

Compare the local copy of the previous or next file with its update from the server.

note

These controls are only available if more than one file has been modified locally.

Go To Changed File Ctrl+N

Display all changed files in the current change set and navigate to them. This action is only available when you review changes to multiple files.

Viewers

Select a viewer mode: side-by-side or unified. The side-by-side mode has two panels, the unified mode has one panel.

You can edit code and perform the Apply, Append, Revert actions in both viewers.

You can change text only in the right-hand part of the side-by-side viewer, or in the lower line in the unified viewer.

You can edit only local versions of your files. You cannot edit files that have read-only status.

Whitespace

Define how the differences viewer should treat whitespaces.

• Do not ignore: white spaces are important, and all the differences are highlighted. This option is selected by default.

• Trim whitespaces: trim whitespaces if they appear in the end and at the beginning of a line (("\t", " ")).

  • If two lines differ in trailing whitespaces only, these lines are considered equal.

  • If two lines are different, trailing whitespaces are not highlighted in the By word mode.

• Ignore whitespaces: white spaces are not important, regardless of their location in the source code.

• Ignore whitespaces and empty lines: ignores whitespaces and empty lines. The following entities are ignored:

  • all whitespaces (as in the 'Ignore whitespaces' option)

  • all added or removed lines consisting of whitespaces only

  • all changes consisting of splitting or joining lines without changes to non-whitespace parts.

    For example, differences between a b c and a \n b c are not highlighted in this mode.

Highlighting mode

Select the way differences granularity is highlighted.

The available options are:

• Highlight words: modified words are highlighted

• Highlight lines: modified lines are highlighted

• Highlight split changes: if this option is selected, big changes are split into smaller changes.

  For example, A \n B and A X \n B X are treated as two changes instead of one.

• Highlight symbols: modified symbols are highlighted

• Do not highlight: if this option is selected, the differences are not highlighted at all.

  Use the Do not highlight option when you work with the files that were significantly modified. In such cases, highlighting might introduce additional difficulties during a review.

Collapse unchanged fragments

Collapse all the unchanged fragments in both files. The amount of non-collapsible unchanged lines is configurable in the Diff & Merge settings page. To open the Diff & Merge page, open settings by pressing Ctrl+Alt+S and navigate to Tools | Diff & Merge.

Synchronize scrolling

Click this button to scroll both differences panes simultaneously. If this button is released, each of the panes can be scrolled independently.

Settings

Open a list of available settings.

These commands are also available from the context menu of the differences viewer gutter.

Show diff in external tool

Invoke an external differences viewer specified on the External Diff Tools settings page.

This button is available only on the toolbar when the Use external diff tool option is enabled on the External Diff Tools settings page.

Help

F1

Open a browser and show the corresponding help page.

Annotate with GitBlame

This option is only available from the context menu of the gutter.

Use this option to explore who introduced which changes to the repository version of the file, and when. The annotations view lets you see detailed information for each line of code, such as the version from which this line originated, the ID of the user who committed this line, and the commit date.

For more details on annotations, refer to VCS annotations.

Ctrl+Shift+D

Use this keyboard shortcut to show the popup menu of the most commonly used diff commands.

Ctrl+Shift+Tab

Use this keyboard shortcut to switch between the left and the right panes.

Ctrl+Z/Ctrl+Shift+Z

Use this keyboard shortcut to undo/redo a merge operation. Conflicts will be kept in sync with the text.

Refresh

Click this button to refresh the current information.

Show Diff

Ctrl+D

Click this button to compare the selected revision of a file with its previous revision in the Differences Viewer.

Show All Affected Files

Alt+Shift+A

Click this button to open the Paths Affected in Revision dialog where you can view all files that were modified in the selected revision.

Show All Branches

Click this button to display changes from branches other than the current one.

Presentation Settings

Click to choose the amount of information you want to see in the History view. You can also select the Show Commit Timestamp option if you want WebStorm to show the commit timestamp instead of the time when a change was authored.

Configure Layout

Click to choose the type of info you want to see:

• Show Details to display the commit message for the selected revision.

• Show Diff Preview to open a diff preview for the selected revision.

Open in GitHub

Click this button to open the page that corresponds to the selected commit on GitHub.