Code refactoring

1. Select an item to refactor. You can select a file/folder in the Project tool window or expression/symbol in the editor.

2. Press Ctrl+Alt+Shift+T to open a list of refactorings that can be selected.

   

   Alternatively, you can use a keyboard shortcut for a specific refactoring.

If you need to undo your refactoring, press Ctrl+Z.

For some refactorings, WebStorm lets you preview the changes before applying them.

1. Click Preview in the Refactoring Preview dialog to see potential changes (the list of usages where the refactoring will be performed).

   

2. In the Find tool window that opens, check the changes that are going to be made. You can exclude Delete or remove Ctrl+X changes that you consider unnecessary.

   

3. Click Do Refactor to proceed with the changes.

When WebStorm encounters problems with your refactoring, it opens a dialog with the list of conflicts and their brief descriptions.

• Click Refactor Anyway to ignore the problem and proceed.

• Click Open in Find Window to open the conflict entries in the Find tool window and deal with them further.

• In the Find tool window, you can apply the refactor by selecting Refactor or click Cancel and return to the editor.

  

1. In the Settings dialog (Ctrl+Alt+S) , select Editor | Code Editing.

2. On the Code Editing page, in the Refactorings section, adjust the refactoring options and click OK.

Copy a file or a folder

1. Select the file or folder to copy in the Project tool window and press F5 or select Refactor | Copy from the context menu or from the main menu.

   Alternatively, select the file or the folder to copy in the Project tool window and drag it to the new folder with the Ctrl key pressed.

2. In the dialog that opens, specify the new name of the file or the folder and the new parent folder, if applicable.

   To open a file, directory or package automatically after it is copied, select the Open copy in editor checkbox.

Rename a file or a folder

1. In the Project tool window, select the file or folder to rename and choose Refactor | Rename from the context menu or press Shift+F6.

2. In the dialog that opens, type the new name of the file or folder.

   

3. To update the references to the file or folder in comments, strings, and text (for files), select the corresponding checkboxes.

   In addition to renaming the file itself, WebStorm can also look for the usages of the file name. If found, the changes you are making to the file name can also be applied to these usages.

   The usages are assigned to different categories which correspond to the options which you can turn on and off.

   Note that regardless of the options selected, the search scope (places where you search for the name occurrences) is always limited to the current entity (for example, a file, or a class) and the entities that the current one depends on.

4. Click Refactor and examine the suggested changes in the dedicated tab of the Find tool window, as described in Previewing, adjusting, and applying the suggested changes above. Click Do Refactor when you are happy with the expected results.

Move a file or a folder

1. In the Project tool window, select the file or folder to move and choose Refactor | Move from the context menu or press F6.

2. In the dialog that opens, specify the new parent folder. Choose an existing folder or type the name of a new one to be created.

3. Select the Search for references checkbox to update the references to the moved file or folder.

1. In the Project tool window, select the file to remove and choose Refactor | Safe Delete from the context menu or press Alt+Delete.

2. In the Safe Delete dialog that opens, select the corresponding checkboxes to look for usages of the file in comments and strings and for occurrences of the file in text.

3. If any usages are detected, WebStorm lists them in the Usages Detected dialog.

   • To delete the file without viewing the found usages, click Delete Anyway.

   • To stop the refactoring, click Cancel.

   • To examine the potential conflicts, click View Usages. WebStorm opens a dedicated tab of the Find tool window where the usages are listed. Explore them, analyze the potential conflicts, and update your code as described in Previewing, adjusting, and applying the suggested changes above.