Extension which sorts TypeScript imports according to the configuration provided. The configuration defaults follow ESLint sort-imports rules. Configuration supports regex functions to set sorting priority and rules. The extension can work with prettier as long as the configuration settings of both are aligned.
Different sort types in file:
Deep directory sort:
Sort on before safe (off by default):
Prettier integration:
For now sorting supports only typescript language.
To run the sorter use Sort Imports command from the Command Palette (Ctrl+Shift+P).
Alternatively, you can set importSorter.generalConfiguration.sortOnBeforeSave to true, which would
trigger sorting before each save operation.
Also you could use/redefine keybindings. The default one is ctrl + alt + o.
You can also do the sort in deep on the directory level. The feature is accessible from the resource explorer. To run right click and select: Sort imports (Directory deep).
!!!Do make sure that the project is managed by some version control system before performing the global source code sort. The sorter will sort and rewrite the sources without any prompt for the action confirmation.
an example of default configuration is provided bellow. For available options have a look at vs code settings(it should show available settings when you search for importSorter)
// Default file configuration name
"importSorter.generalConfiguration.configurationFilePath": "./import-sorter.json",
// Excludes sorting for files which match given regex expression. Regex considers the whole file path. The file path separator is normalized to /
"importSorter.generalConfiguration.exclude": [],
// Enables sort before each save of the document
"importSorter.generalConfiguration.sortOnBeforeSave": false,
// If true then the import string has a semicolon at the end, otherwise it will not be appended. Default is true
"importSorter.importStringConfiguration.hasSemicolon": true,
// The count of units before import is new-lined
"importSorter.importStringConfiguration.maximumNumberOfImportExpressionsPerLine.count": 100,
// The type of length restriction, before import is moved to a new line
"importSorter.importStringConfiguration.maximumNumberOfImportExpressionsPerLine.type": "maxLineLength",
// The number of new lines after the last sorted import
"importSorter.importStringConfiguration.numberOfEmptyLinesAfterAllImports": 1,
// The path quotes
"importSorter.importStringConfiguration.quoteMark": "single",
// Number of spaces after comma
"importSorter.importStringConfiguration.spacingPerImportExpression.afterComma": 1,
// Number of spaces after {
"importSorter.importStringConfiguration.spacingPerImportExpression.afterStartingBracket": 1,
// Number of spaces before comma
"importSorter.importStringConfiguration.spacingPerImportExpression.beforeComma": 0,
// Number of spaces before }
"importSorter.importStringConfiguration.spacingPerImportExpression.beforeEndingBracket": 1,
// Left number of spaces for the new lined imports. If tabType is set to 'tab', then the configuration defines the size of the tab in number of spaces
"importSorter.importStringConfiguration.tabSize": 4,
// Defines the character which will be printed on each new lined import expression
"importSorter.importStringConfiguration.tabType": "space",
// If always/multiLine then adds a trailing comma at the end of the imports for 'single and multi' and 'multi-line' imports respectively. Default is none therefore no trailing comma
"importSorter.importStringConfiguration.trailingComma": "none",
// The default number of empty lines after any group. This has lesser priority then empty lines in rules
"importSorter.sortConfiguration.customOrderingRules.defaultNumberOfEmptyLinesAfterGroup": 1,
// The default order level of everything which is not included into rules
"importSorter.sortConfiguration.customOrderingRules.defaultOrderLevel": 20,
// Disable sorting of path on the default group
"importSorter.sortConfiguration.customOrderingRules.disableDefaultOrderSort": false,
// The default order level of everything which is not included into rules
"importSorter.sortConfiguration.customOrderingRules.rules": [
{
"type": "importMember",
"regex": "^$",
"orderLevel": 10,
"disableSort": true
},
{
"regex": "^[@]",
"orderLevel": 30
},
{
"regex": "^[.]",
"orderLevel": 40
}
],
// Sort Direction of names in curly brackets
"importSorter.sortConfiguration.importMembers.direction": "asc",
// Sort Order of names in curly brackets
"importSorter.sortConfiguration.importMembers.order": "caseInsensitive",
// Sort Direction of paths
"importSorter.sortConfiguration.importPaths.direction": "asc",
// Sort Order of paths
"importSorter.sortConfiguration.importPaths.order": "caseInsensitive",
// Combine imports with the same path
"importSorter.sortConfiguration.joinImportPaths": true
// Removes not used imports where we do not have explicit side effects
"importSorter.sortConfiguration.removeUnusedImports": false
// Works only if removeUnusedImports enabled. This option will remove default imports if they are not explicitly used in the source code.
"importSorter.sortConfiguration.removeUnusedDefaultImports": falseimportSorter.generalConfiguration.configurationFilePathadds an option to read configuration from file. The setting represents a relative path to the root of the open vscode workspace. The default value is./import-sorter.json. The path search is relative to the open workspace(usually where package.json is located). Bellow is a example of the configuration:
import-sorter.json
{
"importStringConfiguration": {
"trailingComma": "multiLine",
"tabSize": 4,
"maximumNumberOfImportExpressionsPerLine": {
"count": 50
}
},
"sortConfiguration": {
"customOrderingRules": {
"defaultNumberOfEmptyLinesAfterGroup": 2
}
}
}Alternatively you can set configuration as in visual studio code
import-sorter.json
{
"importStringConfiguration.trailingComma": "multiLine",
"importStringConfiguration.tabSize": 4,
"importStringConfiguration.maximumNumberOfImportExpressionsPerLine.count": 50,
"sortConfiguration.customOrderingRules.defaultNumberOfEmptyLinesAfterGroup": 2
}Or
import-sorter.json
{
"importSorter.importStringConfiguration.trailingComma": "multiLine",
"importSorter.importStringConfiguration.tabSize": 4,
"importSorter.importStringConfiguration.maximumNumberOfImportExpressionsPerLine.count": 50,
"importSorter.sortConfiguration.customOrderingRules.defaultNumberOfEmptyLinesAfterGroup": 2
}The priority of settings is given to the configuration file. If the setting does not exist in the configuration file then the value of the vscode setting will be taken. If file does not exist, then all settings will be taken from vscode.
importSorter.generalConfiguration.excluderepresents an array of regex expressions to match agaist full file paths. If matched, then the file will be excluded from sorting. The default value is[]. Bellow is a example of the configuration:
{
"generalConfiguration": {
"exclude": [".*polyfill\\.ts"]
}
}In the example, any path which finishes with pollyfill.ts path will be excluded.
importSorter.sortConfiguration.customOrderingRules.rulesis a json array of regex expressions which sets the sort group order. As of now the default setting is
[
{
"type": "importMember",
"regex": "^$",
"orderLevel": 10,
"disableSort": true
},
{
"regex": "^[@]",
"orderLevel": 30
},
{
"regex": "^[.]",
"orderLevel": 40
}
]The type is an optional and defaults to path(another value is importMember). That setting says that we make any import which does not have from keyword (possibly an import with side effect) to have the highest order priority of 10. The highest priority given to the lowest number. We also say that we do not want to apply sorting rules to that group of disableSort: false. Then anything which does have . in the import path gets next priority of 40. Everything else which is not included by those rules get a default priority of 20 denoted by importSorter.sortConfiguration.customOrderingRules.defaultOrderLevel.
As a result we get 4 sort groups. Those groups are individually sorted by the rules applied in the settings unless disableSort: true which would preserve the order of imports.
importSorter.importStringConfiguration.trailingCommais an enum which can bealways,multiLine, ornone.always- will always append trailing comma.multiLine- will append comma if import line is broken to multiple lines.none- will not append comma(This one is a default setting)
importSorter.importStringConfiguration.maximumNumberOfImportExpressionsPerLine.typeis an enum which can bewords,maxLineLength, ornewLineEachExpressionAfterCountLimit. The setting is set in pair withimportSorter.importStringConfiguration.maximumNumberOfImportExpressionsPerLine.count, which determines the number after which the imports are going to be moved to the next linewords-countdenotes maximum number of import expressions per line.maxLineLength-countdenotes maximum number of characters per line.newLineEachExpressionAfterCountLimit-countdenotes maximum number of characters which can be on the first line. If all imports do not fit one line, then each import will be placed on a new line.newLineEachExpressionAfterCountLimitExceptIfOnlyOne-count. Same as the previous option, except if we only have one import expression then we do not move it to the next line even if the length is longer than thecount. This option is also used to be able to integrate with behavior ofprettierand addresses GitHub Prettier Issues #1954
importSorter.importStringConfiguration.tabTypeis an enum which can betaborspace.space- will addimportSorter.importStringConfiguration.tabSizenumber of space characters for each new-lined import.tab- will add a tab character for each new-lined import. The tab character would assume to takeimportSorter.importStringConfiguration.tabSizenumber of space characters
At the time of writing this documentation, the following are the settings which needs to be set to make import sorter have the behavior aligned with the defaults of Prettier.
{
"editor.formatOnSave": true,
"importSorter.generalConfiguration.sortOnBeforeSave": true,
"importSorter.importStringConfiguration.maximumNumberOfImportExpressionsPerLine.type": "newLineEachExpressionAfterCountLimitExceptIfOnlyOne",
"importSorter.importStringConfiguration.maximumNumberOfImportExpressionsPerLine.count": 80,
"importSorter.importStringConfiguration.tabSize": 2,
"importSorter.importStringConfiguration.quoteMark": "double"
}Alternatively you can set import-sorter.json configuration file with the following content
import-sorter.json
{
"generalConfiguration.sortOnBeforeSave": true,
"importStringConfiguration.maximumNumberOfImportExpressionsPerLine.type": "newLineEachExpressionAfterCountLimitExceptIfOnlyOne",
"importStringConfiguration.maximumNumberOfImportExpressionsPerLine.count": 80,
"importStringConfiguration.tabSize": 2,
"importStringConfiguration.quoteMark": "double"
}- Handle external dependencies based on the most external dependencies being at the top and group based on those. Sorting will be done within those groups.
Refer to change log
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent