JavaScript Completions

JavaScript Completions for sublime text

It helps you to write your scripts more quickly with hints and completions.

Announcement

I'm developing a new plugin with new features thanks to Flow (javascript static type checker from Facebook). With it I can implement other features and there will be a better autocomplete (smart autocomplete based on the current context).

This is in Beta version and I published it on another github repository:

https://github.com/pichillilorenzo/JavaScriptEnhancements

This new plugin will offer not only a better autocomplete but a lot of features about creating, developing and managing javascript projects, such as:

Cordova projects (run Cordova emulator, build, compile, serve Cordova projects, add plugins and available platforms, the ability to install local version of Cordova in the project, etc … directly on Sublime Text!)
Ionic projects (same as Cordova projects!)
Angular projects
Node.js projects
Local bookmarks project
Show javascript errors with Flow
etc, etc …

It will turn Sublime Text into a JavaScript IDE like!

It isn’t ready for public testing and there isn’t a documentation at the moment!

WATCH the repository to stay tuned for any news!

Email me for any questions or doubts about this new project on: pichillilorenzo@gmail.com

Thanks for your support!!!

jQuery and NativeScript completions disabled by default! You can enable them on Preferences -> Package Settings -> JavaScript Completions.

Some features could use npm!

It will be downloaded automatically with nodejs!

Features list:

"Find JavaScript Description" Feature
"On Hover Description" Feature
"Evaluate JavaScript" Feature
"Can I use?" Feature
"JSDoc" Feature
Context menu options

Usage

To try it, just write.

Examples:

description-Name_of_function/property/method shows to you the explanation of the function/property/method and its syntax.

Information about the description of function/property/method has been taken on this sites:

ENABLE or DISABLE completions

You can ENABLE or DISABLE completions! Just go to Preferences -> Package Settings -> JavaScript Completions

"Find JavaScript Description" Feature

Supported only by Sublime Text 3

You can check the description of function/property/method by selecting the word (or, in case, it will take the first word near the blinking cursor) you want find. "right-click" on your mouse and click on "Find JavaScript Description".

It will show a popup with the list of possible descriptions or, in some case, the direct description.

Key-Map list: Preferences -> Package Settings -> JavaScript Completions -> Key Bindings - Default.

"On Hover Description" Feature

Supported only by Sublime Text 3, Build >= 3124

Just put the cursor over a name of a function, property or constructor and it will appear a little popup with all matching found from the /sublime-completions list enabled.

F = function
P = property
C = constructor

Example:

"Evaluate JavaScript" Feature

Supported only by Sublime Text 3

This feature uses node.js installed locally by this plugin.

You can change the path of "node.js" and "npm" on Preferences -> Package Settings -> JavaScript Completions -> Settings - Default

You can evaluate the entire text selection or the current line! If you select a text region and evaluate it, in the gutter of the editor will appear 2 white dots. The first white dot represents the start of the region and the second white dot represents the end of the region. You can eventually modify the region and, without reselect the same region, you can evaluate it again! If you want hide this 2 dots, there is an entry on the context menu "Evaluate JavaScript".

When you evaluate code, this plugin will prepend "use strict"; automaticaly!

There are two main mode to evaluate code:

eval
print

Key-Map list: Preferences -> Package Settings -> JavaScript Completions -> Key Bindings - Default.

"Can I use?" Feature

Supported only by Sublime Text 3, Build >= 3124

This feature uses "can i use" json data from this repository, that contains raw data from the http://caniuse.com support tables.

Thanks to @Fyrd.

You can use this feature in HTML, CSS and JavaScript context!

Just put the cursor on the word you want to check, "right-click" -> "Can I use?" and it will appear an input panel with all items that have a name matching with the word.

You can use key-map: ctrl+alt+w. Key-Map list: Preferences -> Package Settings -> JavaScript Completions -> Key Bindings - Default.

After selecting an item from the list, it will appear a popup with all information from the http://caniuse.com support tables.

You can find it under "Tools" menu -> "JavaScript Completions" -> Search on "Can I use" list.

Example :

"JSDoc" Feature

Supported only by Sublime Text 3

Requires npm

This feature uses https://github.com/jsdoc3/jsdoc to generate API documentation.

You can find it under "Tools" menu -> "JavaScript Completions".

There are 2 main menu items:

Generate Documentation
Add jsdoc configuration file to the current project folder

These items can be used only with a project folder opened.

"Generate Documentation" uses the jsdoc command line to generate documentation.

It uses the defaukt conf.json file for configuration.

The options (with default values) availables are:

{
  "tags": {
    "allowUnknownTags": true,
    "dictionaries": ["jsdoc","closure"]
  },
  "source": {
    "include": [  ],
    "exclude": [  ],
    "includePattern": ".+\\.js(doc|x)?$",
    "excludePattern": "(^|\\/|\\\\)_"
  },
  "opts": {
    "template": "templates/default",
    "encoding": "utf8",
    "destination": "./out/",
    "recurse": true,
    "tutorials": ""
  },
  "plugins": [],
  "templates": {
    "cleverLinks": false,
    "monospaceLinks": false
  }
}

"Add jsdoc configuration file to the current project folder" will add a conf.json file with default values to the current project folder.

How to use JSDoc: http://usejsdoc.org/

Context menu options:

Surround With
Delete Surrounded
Create Class from object literal
Sort array
Split string lines to variable

Surround With

You MUST first select text to "enable" these options.

You can surround code with:

if statement
if else statement (this works only if you selected 2 regions, see example)
while statement
do while statement
for statement
try catch statement
try catch finally statement

This option works also on multiple selections at once.

Delete Surrounded

Options are:

Strip quoted string

This option works also on multiple selections at once.

Create Class from object literal

This option create a JavaScript Class from an object literal (Constructor with all setter and getter for each field).

You can set default values or use the string "required" to say that a field hasn't a default value.

To work properly, you MUST declare a variable and assign an object literal to it, like this example:

var Person = {
  name: "required",
  surname: "required",
  email: "",
  age: 18
}

This option works also on multiple selections at once.

Sort array

Just put the cursor between brackets and will appear a menu with these options:

Sort array ASC ( compare function: function(x,y){return x-y;} )
Sort array DESC ( compare function: function(x,y){return y-x;} )
Sort array alphabetically ASC
Sort array alphabetically DESC

This option works also on multiple selections at once.

Examples of usage:

Split string lines to variable

Just put the cursor between a string with multiple lines and this option will appear in the context menu.

It will split the string and for each line will be concatenated to a variable named "str".

This option works also on multiple selections at once.

Example:

MIT License

yunsonbai/JavaScript-Completions

JavaScript Completions

Announcement

Usage

ENABLE or DISABLE completions

"Find JavaScript Description" Feature

"On Hover Description" Feature

"Evaluate JavaScript" Feature

"Can I use?" Feature

"JSDoc" Feature

Context menu options

Surround With

Delete Surrounded

Create Class from object literal

Sort array

Split string lines to variable