The extension is inspired by JetBrains IDEs feature "Search Everywhere". It allows user to easily navigate through files and symbols in the whole workspace.
It is the alternative for "Go to Symbol in Workspace..." - fully customizable.
The extension indexes the whole workspace. It scans both files and all symbols for each file according to set up patterns in settings. The scan can be initialized automatically on startup of Visual Studio Code or postponed till the first launch of extension.
After the scan is completed, the extension listens for any change in the workplace, e.g.
- add, rename, delete function, variable or anything other in file
- add, rename, delete, move a file between directories or even between projects in the opened workspace
The above guarantees that the data is always up to date.
Worth mentioning is the optimization of scanning algorithm. It queues every change and reduces not necessary actions to assure the scan is smooth and very quick.
Additionally from version 2.0.0 there is a feature to scan the workspace only once and cache the results. Useful especially with the bigger projects.
-
Init on startup or first call
-
Notification placeholder
toast
status bar
-
Debounce of search results while filtering
enabled
disabled
-
Highlight of selected symbol
enabled
disabled
-
Customizable icon for each item type
-
Customizable filter phrase for each item type
-
Customizable items filter to reduce items set
-
Customizable help phrase
-
Customizable exclude patterns
-
Customizable include pattern
-
Ability to decide whether use extension exclude patterns or "Files: Exclude" and "Search: Exclude" patterns
-
Item icon to open it to the side
-
Dedicated output with logs related to triggered actions, scanned directories structure, etc.
-
Ability to decide whether the items should be sorted by type
-
Ability to cache the scanned workspaceData to as a result scan the workspace only once
-
searchEverywhere.search
Search any symbol/file in the currently opened workspace.
Default keybinding for the command is:
- mac:
alt + cmd + p
- win/linux:
ctrl + alt + p
- mac:
-
searchEverywhere.reload
Re-index the whole workspace.
searchEverywhere.shouldInitOnStartup
Should indexing be initialized on Visual Studio Code startup.
Default value: false
.
searchEverywhere.shouldDisplayNotificationInStatusBar
Should display indexing notification in toast or status bar.
Default value: false
.
searchEverywhere.shouldHighlightSymbol
Should the selected symbol be highlighted.
Default value: false
.
searchEverywhere.shouldUseDebounce
Should the debounce function be used while returning filter results (useful in case of the large workspace).
Default value: true
.
searchEverywhere.icons
Ability to define icons that should be displayed for appropriate item types. According to VSC API, only Octicons are allowed. Not defined item type will not have any icon.
Default value:
{
"0": "symbol-file",
"1": "file-submodule",
"2": "symbol-namespace",
"3": "package",
"4": "symbol-class",
"5": "symbol-method",
"6": "symbol-property",
"7": "symbol-field",
"8": "symbol-ruler",
"9": "symbol-enum",
"10": "symbol-interface",
"11": "variable-group",
"12": "symbol-variable",
"13": "symbol-constant",
"14": "symbol-string",
"15": "symbol-numeric",
"16": "symbol-boolean",
"17": "symbol-array",
"18": "symbol-keyword",
"19": "symbol-key",
"20": "remove",
"21": "symbol-enum-member",
"22": "symbol-structure",
"23": "symbol-event",
"24": "symbol-operator",
"25": "type-hierarchy-sub"
}
Below you can find the table with information which symbol kind refers to which symbol name:
kind | icon | symbol name |
---|---|---|
0 | symbol-file | file |
1 | file-submodule | module |
2 | symbol-namespace | namespace |
3 | package | package |
4 | symbol-class | class |
5 | symbol-method | method |
6 | symbol-property | property |
7 | symbol-field | field |
8 | symbol-ruler | constructor |
9 | symbol-enum | enum |
10 | symbol-interface | interface |
11 | variable-group | function |
12 | symbol-variable | variable |
13 | symbol-constant | constant |
14 | symbol-string | string |
15 | symbol-numeric | number |
16 | symbol-boolean | boolean |
17 | symbol-array | array |
18 | symbol-keyword | object |
19 | symbol-key | key |
20 | remove | null |
21 | symbol-enum-member | enum member |
22 | symbol-structure | struct |
23 | symbol-event | event |
24 | symbol-operator | operator |
25 | type-hierarchy-sub | type parameter |
searchEverywhere.itemsFilter
Ability to define a filter that should be applied to items. All kinds can be find here: https://code.visualstudio.com/api/references/vscode-api#SymbolKind
Default value:
{
"allowedKinds": [],
"ignoredKinds": [],
"ignoredNames": []
}
Below is an example which will remove from items all arrays (17), booleans (16) and the ones containing "foo" string in the name:
{
"allowedKinds": [],
"ignoredKinds": [16, 17],
"ignoredNames": ["foo"]
}
searchEverywhere.shouldUseItemsFilterPhrases
Should be a possibility to filter by assigned filter phrases.
Default value: true
.
searchEverywhere.itemsFilterPhrases
Phrases for item type which could be used for narrowing the results down.
Default value:
{
"0": "$$",
"4": "@@",
"11": "!!",
"14": "##",
"17": "%%"
}
searchEverywhere.helpPhrase
A phrase which should invoke help.
Default value: ?
searchEverywhere.shouldItemsBeSorted
Ability to decide whether items should be sorted by type.
Default value: true
searchEverywhere.exclude
An array of globs. Any file matching these globs will be excluded from indexing.
Default value:
[
"**/.git",
"**/.svn",
"**/.hg",
"**/.CVS",
"**/.DS_Store",
"**/package-lock.json",
"**/yarn.lock",
"**/node_modules/**",
"**/bower_components/**",
"**/coverage/**",
"**/.vscode/**",
"**/.vscode-test/**",
"**/.history/**",
"**/.cache/**",
"**/.cache-loader/**",
"**/out/**",
"**/dist/**"
]
searchEverywhere.include
String with include pattern. Any file matching this glob will be included in indexing.
Default value:
"**/*.{js,jsx,ts,tsx}"
searchEverywhere.excludeMode
Ability to choose which exclude option should be applied. If gitignore file is not found or is empty, the extension option is used as a fallback. Available options: search everywhere
, files and search
, gitignore
. To see the changes from the updated gitignore file after indexing, the reload must be done.
Default value: search everywhere
.
searchEverywhere.shouldWorkspaceDataBeCached
Ability to decide if the workspace should be indexed only once. Each next startup of Visual Studio Code will collect data from cache.
Default value: true
searchEverywhere.shouldSearchSelection
Ability to decide whether selection in the active editor is put in the search.
Default value: true