JavaScript code intelligence for atom with Tern. Adds support for ES5, ES6, ES7, ES8, Node.js and more. Extendable via plugins. Uses suggestion provider by autocomplete-plus.
- Open any JavaScript file from within your project
- Navigate to Packages -> Atom Ternjs -> Configure project
- The config view appears. Configure to your needs.
- Hit "Save & Restart Server" to create/update the .tern-project file. The configuration is now active.
- In your project root create a file named .tern-project. See docs @ http://ternjs.net/doc/manual.html#configuration.
- Restart the server via Packages -> Atom Ternjs -> Restart server
Example .tern-project file (customize to your own needs):
{
"ecmaVersion": 8,
"libs": [
"browser"
],
"loadEagerly": [
"path/to/your/js/**/*.js"
],
"dontLoad": [
"node_modules/**",
"path/to/your/js/**/*.js"
],
"plugins": {
"es_modules": {},
"node": {},
"doc_comment": {
"fullDocs": true,
"strong": true
}
}
}- 5: use ECMAScript5
- 6: use ECMAScript6
- 7: use ECMAScript7
- 8: use ECMAScript8 (default)
- browser: completion for browser features like document.querySelector (optional)
- chai: completion for chai (optional)
- jquery: completion for jQuery (optional)
- react: completion for React (optional)
- underscore: completion for underscore (optional)
- loadEagerly: provide the path to your projects JavaScript. For relative paths do not use
./as a prefix. This sometimes leads to an unexpected behaviour. - loadEagerly is expensive. Do not add paths like
node_modules. - dontLoad: can be used to prevent Tern from loading certain files. It also takes an array of file names or glob patterns.
- For a list of build in server plugins, visit: http://ternjs.net/doc/manual.html#plugins
List of keybindings.
To use your own keybindings goto atom-ternjs package settings and disable keybindings.
In order to use third party plugins (e.g. tern-node-express):
$ cd ~/.atom/packages/atom-ternjs
$ npm install tern-node-express
Add the plugin to your .tern-project file:
{
"ecmaVersion": 8,
"libs": [
"browser"
],
"loadEagerly": [
"app/**/*.js"
],
"plugins": {
"node-express": {}
}
}Third party plugins are still an issue and sometimes do not work as expected, especially if the plugin requires a tern version that does not match the tern version that is used by atom-ternjs.
Restart the server: Packages -> Atom Ternjs -> Restart server
- After the file was created or has been modified, restart the server via Packages -> Atom Ternjs -> Restart server
- Completion (autocompletion triggers automatically), or via the keybindings:
- ctrl+space
- ctrl+alt+space (force autocompletion in any context)
- Find references (set your cursor position to one of variable, function or instance -> open context-menu and trigger "Find references" or use the keybindings:
- ctrl+shift+r (macOS, Windows)
- ctrl+alt+shift+e (Linux)
Click any item in the generated reference-list and navigate directly to file and position
-
Documentation
- Show documentation for the thing under the cursor via alt+o (macOS, Windows, Linux)
- Also displayed if a suggestion with a valid documentation is selected in the autocomplete-plus select-list
- Show documentation for the thing under the cursor via alt+o (macOS, Windows, Linux)
-
Find definition (set your cursor position to one of variable, function or instance -> open context-menu and trigger "Find definition") or use the keybindings:
- cmd+click (macOS, Windows, Linux), requires https://atom.io/packages/hyperclick. Since cmd+click is also used for multi-line editing in macOS you should change the default hyperclick settings.
- ctrl+alt+shift+d (macOS, Windows, Linux)
-
Navigate back or forward
- ctrl+shift+cmd+left (macOS, Windows, Linux)
- ctrl+shift+cmd+right (macOS, Windows, Linux)
-
Rename variable (set your cursor position to a variable -> open context-menu and trigger "Rename") or use the keybindings:
- ctrl+alt+c (macOS, Windows)
- ctrl+alt+shift+c (Linux)
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent