Configuring Folders Within a Content Root
On this page:
Within a content root, WebStorm can distinguish between the folders that contain source code, and the ones to be ignored while searching, parsing, watching etc. To do so, you can mark any folder below a content root as a source folder, or as excluded so it becomes invisible for WebStorm.
Within a content root, WebStorm can distinguish between Resource Root folders, Test Source code, and Excluded folders. No special indication for source code is used, any folder is treated as source code unless it is associated with another type.
Files under a folder marked as Resource Root can be referenced relative to this folder. Excluded folders are not involved in indexing and therefore they are ignored while searching, parsing, watching etc.
To invoke this distinction, you can mark any folder below a content root as Resource Root, Test, or Excluded.
You can assign a folder to a category in two different ways:
- Using the Directories page of the Settings / Preferences Dialog.
- Using the context menu of a folder in the Project tool window.
To mark directories under the content root:
- Open the Settings / Preferences Dialog by pressing Ctrl+Alt+S or by choosing for Windows and Linux or for macOS. Click the Directories node.
- In the Directories page, click the desired content root. The directories under this content root are displayed as a tree view in the right-hand pane.
- Select the directory you want to mark and do one of the following:
- To have WebStorm consider the contents of the selected folder as unit tests, click the Tests toolbar button or choose Test Sources on the context menu of the selection.
- To have WebStorm ignore the selected directory during indexing, parsing, code completion, etc., click the Excluded toolbar button or choose Excluded on the context menu of the selection.
- To enable WebStorm to complete relative paths to resources under the selected folder, click the Resource Root toolbar button or choose Resource Root on the context menu of the selection.
To mark directories using the context menu:
- Right-click the desired directory in the Project Tool Window.
- On the context menu, point to Mark Directory As node.
- Choose Mark as <directory status>.
To return a folder to its regular status, do one of the following
- On the Directories page of the Settings / Preferences Dialog:
- Select the directory in question in the list of folders under the content root, and click :
- Click the folder's status icon once more.
- Choose the corresponding command on the context menu of the directory.
- In the Project Tool Window, right-click the desired directory, point to Mark Directory As node, and then choose Unmark as <directory status>.