js2-refactor.el

The beginnings of a JavaScript refactoring library in emacs.

This is a collection of small refactoring functions to further the idea of a JavaScript IDE in Emacs that started with js2-mode.

Installation

Start by installing the dependencies:

• js2-mode https://github.com/mooz/js2-mode/
• dash https://github.com/magnars/dash.el
• multiple-cursors https://github.com/magnars/multiple-cursors.el

It is also recommended to get expand-region to more easily mark vars, method calls and functions for refactorings.

Then add this to your emacs settings:

(require 'js2-refactor)

Note: I am working on a smoother installation path through package.el, but I haven't had the time to whip this project into that sort of structure - yet.

Usage

All refactorings start with C-c C-m and then a two-letter mnemonic shortcut.

• ef is extract-function: Extracts the marked expressions out into a new named function.
• em is extract-method: Extracts the marked expressions out into a new named method in an object literal.
• ip is introduce-parameter: Changes the marked expression to a parameter in a local function.
• eo is expand-object: Converts a one line object literal to multiline.
• co is contract-object: Converts a multiline object literal to one line.
• wi is wrap-buffer-in-iife: Wraps the entire buffer in an immediately invoked function expression
• ig is inject-global-in-iife: Creates a shortcut for a marked global by injecting it in the wrapping immediately invoked function expression
• ag is add-to-globals-annotation: Creates a /*global */ annotation if it is missing, and adds the var at point to it.
• ev is extract-var: Takes a marked expression and replaces it with a var.
• iv is inline-var: Replaces all instances of a variable with its initial value.
• rv is rename-var: Renames the variable on point and all occurrences in its lexical scope.
• vt is var-to-this: Changes local var a to be this.a instead.
• ao is arguments-to-object: Replaces arguments to a function call with an object literal of named arguments. Requires yasnippets.
• 3i is ternary-to-if: Converts ternary operator to if-statement.
• sv is split-var-declaration: Splits a var with multiple vars declared, into several var statements.
• uw is unwrap: Replaces the parent statement with the selected region.

There are also some minor conveniences bundled:

• C-S-down and C-S-up moves the current line up or down. If the line is an element in an object or array literal, it makes sure that the commas are still correctly placed.

Todo

A list of some wanted improvements for the current refactorings.

• expand- and contract-object: should work for arrays.
• expand- and contract-object: should work for simple functions.
• wrap-buffer-in-iife: should skip comments and namespace initializations at buffer start.
• extract-variable: could end with a query-replace of the expression in its scope.

Contributions

• Matt Briggs contributed js2r-add-to-globals-annotation

Thanks!

Contribute

This project is still in its infancy, and everything isn't quite sorted out yet. If you're eager to contribute, please add an issue here on github and we can discuss your changes a little before diving into the elisp. :-)

To fetch the test dependencies:

$ cd /path/to/multiple-cursors
$ git submodule init
$ git submodule update

Run the tests with:

$ ./util/ecukes/ecukes features

License

Copyright (C) 2012 Magnar Sveen

Author: Magnar Sveen magnars@gmail.com Keywords: javascript refactorings

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.