1 # History of user-visible changes
5 * New variable `js2-mode-assume-strict`, for use with ES6 modules.
6 * Support for JSDoc @callback, @func and @method tags.
7 * Object properties are highlighted using a different face:
8 `js2-object-property`, which has no color by default.
9 * Experimental support for object rest/spread ECMAScript proposal.
10 * `js2-getter-setter-node` is renamed to `js2-method-node`, together with
11 its related functions. It already handles generator methods, and we
12 added support for async methods (see below), so the old name would get
14 * Support for default parameters in destructuring. It should work for both
15 objects and arrays, in both literals and function arguments.
16 * New mode: `js2-jsx-mode`, deriving from `js2-mode`. Supports indentation of
17 JSXElement expressions wrapped within parentheses or as function arguments.
18 Indentation is customizable via `sgml-attribute-offset`.
19 * Experimental support for async/await ECMAScript proposal.
23 * `js2-mode` now derives from `js-mode`. That means the former
24 function will run `js-mode-hook`, as well as `js2-mode-hook`. The
25 key bindings will default to `js-mode-map` where they're not set in
26 `js2-mode-map`. And in Emacs 25 or later (including the snapshot
27 builds), `js2-mode` uses the indentation code from `js-mode`. Where
28 feasible, the user options (and functions) now have aliases, but if
29 you're using Emacs 25 and you see an indentation-related setting
30 that stopped working, try looking for a corresponding one in the
31 `js` group: `M-x customize-group RET js RET`.
33 * New command: `js2-jump-to-definition`. It's bound to `M-.` by
34 default, via remapping `js-find-symbol`. To get back to the default
35 `M-.` binding (e.g. `find-tag`), put this in your init file:
37 (eval-after-load 'js (define-key js-mode-map (kbd "M-.") nil))
41 * More comprehensive strict mode warnings and syntax errors.
42 * New minor mode: `js2-highlight-unused-variables-mode`.
43 * `js2-pretty-multiline-declarations` can take the value `dynamic` now.
49 * [ES6 modules](http://www.2ality.com/2014/09/es6-modules-final.html).
50 * [Short-hand object literals](http://ariya.ofilabs.com/2013/02/es6-and-object-literal-property-value-shorthand.html).
51 * [Method definitions](http://ariya.ofilabs.com/2013/03/es6-and-method-definitions.html).
52 * ['u' and 'y' RegExp flags](https://mathiasbynens.be/notes/es6-unicode-regex).
53 * [Computed property names](http://people.mozilla.org/~jorendorff/es6-draft.html#sec-object-initializer).
54 * [Class statements and expressions](https://github.com/lukehoban/es6features#classes).
55 * [Template strings](http://tc39wiki.calculist.org/es6/template-strings/), including tagged ones.
57 The variable `js2-allow-keywords-as-property-names` has been
58 removed. Instead we check if `js2-language-version` is 180 or highter.
64 * Unicode characters in identifiers (improved).
65 * [Delegating yield](http://wiki.ecmascript.org/doku.php?id=harmony:generators#delegating_yield).
66 * [ES6 numeric literals](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-literals-numeric-literals) (octal, binary).
67 * Harmony [array and generator comprehensions](http://wingolog.org/archives/2014/03/07/es6-generator-and-array-comprehensions-in-spidermonkey).
73 * [Arrow functions](http://wiki.ecmascript.org/doku.php?id=harmony:arrow_function_syntax)
74 * [Generators](http://wiki.ecmascript.org/doku.php?id=harmony:generators)
75 * [Spread operator](http://wiki.ecmascript.org/doku.php?id=harmony:spread)
79 ### Support for JSLint global declaration
81 See the docstring for `js2-include-jslint-globals`.
85 ### We don't rebind `RET` anymore
87 Because well-behaving major modes aren't supposed to do that.
89 So pressing it won't continue a block comment, or turn a string into a concatenation.
90 Pressing `M-j`, however, will.
92 The options `js2-indent-on-enter-key` and `js2-enter-indents-newline` were also removed.
94 To bring back the previous behavior, put this in your init file:
97 (eval-after-load 'js2-mode
98 '(define-key js2-mode-map (kbd "RET") 'js2-line-break))
103 ### Support for [default](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/default_parameters) and [rest](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/rest_parameters) parameters
107 ### Support for [for..of loops](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/for...of)
111 ### Popular indentation style
114 [foo, bar, baz].forEach(function (v) {
119 [a, b, c].some(function (v) {
124 ### Pretty multiline variable declaration
126 In the original mode,
134 In this mode when the value of `js2-pretty-multiline-declarations` is non-nil,
142 ### Abbreviated destructuring assignments
145 let {a, b} = {a: 10, b: 20}; // Abbreviated (Not supported in the original mode)
146 let {a: a, b: b} = {a: 10, b: 20}; // Same as above (Supported in the original mode)
148 (function ({responseText}) { /* */ })(xhr); // As the argument of function
150 for (let [k, { name, age }] in Iterator(obj)) // nested
154 ### Expression closure in property value
160 fire: function () _fire()
164 ### Fix for odd indentation of "else if" with no braces
166 In the original mode,
184 ### Imenu support for function nesting
186 Supports function nesting and anonymous wrappers:
190 var foo = function() {
191 function bar() { // shown as foo.bar.<definition-1>
192 function baz() {} // foo.bar.baz
193 var qux = function() {}; // foo.bar.quux
201 * [jQuery 1.5](https://gist.github.com/845449)
202 * [Underscore.js](https://gist.github.com/824262)
203 * [Backbone.js](https://gist.github.com/824260)
205 For library-specific extension methods like `$.extend` and `dojo.declare`, see [js2-imenu-extras](/mooz/js2-mode/blob/master/js2-imenu-extras.el).
207 ### Undeclared/external variables highlighting
209 Original mode highlights them only on the left side of assignments:
213 hose = new House(); // highlights "hose"
216 Here they are highlighted in all expressions:
219 function feed(fishes, food) {
220 for each (var fish in fshes) { // highlights "fshes"
221 food.feed(fsh); // highlights "fsh"
223 hood.discard(); // highlights "hood"
227 Destructuring assignments and array comprehensions (JS 1.7) are supported:
230 let three, [one, two] = [1, 2];
231 thee = one + two; // highlights "thee"
233 function revenue(goods) {
234 // highlights "coast"
235 return [price - coast for each ({price, cost} in goods)].reduce(add);