Skip to content

JavaScript Completions for sublime text. It helps you to write your scripts more quickly with hints and completions.

License

Notifications You must be signed in to change notification settings

pichillilorenzo/JavaScript-Completions

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

JavaScript Completions

Sublime Text Package Control Package Control

JavaScript Completions for sublime text

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

Announcement

I'm implementing new features thanks to Flow (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 under another branch: https://github.com/pichillilorenzo/JavaScript-Completions/tree/v3-beta

but I will move it on a new repository (so it will be a new plugin on Sublime Text) because it 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 platforms, etc … directly on Sublime Text!)
  • Ionic projects (same as Cordova projects!)
  • Node.js projects
  • Local bookmarks project
  • Show javascript errors with Flow
  • etc, etc …

It will be something like a JavaScript IDE on Sublime Text!

It isn’t ready for public testing and there isn’t a documentation at the moment! I will let you know the moment I have any news!!

Email me for any questions or doubts about this new project on: [email protected]

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:

Usage

To try it, just write.

Examples:

example #1 of JavaScript Completions

example #2 of JavaScript Completions

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.

example #1 Find JavaScript Description Feature

example #2 Find JavaScript Description Feature

"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:

example #1 On Hover Description Feature

"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:

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

example #1 Evaluate JavaScript Feature

example #2 Evaluate JavaScript Feature

"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 https://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 https://caniuse.com support tables.

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

Example :

example #1 Can I use? Feature

example #2 Can I use? Feature

example #3 Can I use? Feature

"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: https://usejsdoc.org/

Context menu options

Context menu options:

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:

example #1 Other Context menu option

example #2 Other Context menu option

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:

example #1 Split string lines to variable

MIT License