Висящие запятые

Висящие запятые в литералах

Массивы

JavaScript игнорирует висящие запятые в массивах:

var arr = [1, 2, 3,];

arr; // [1, 2, 3]
arr.length; // 3

Если использовано больше одной висящей запятой, будут созданы "дырки". Массив с "дырками" называется разреженным (плотный массив не имеет "дырок"). При итерации массива при помощи, например, Array.prototype.forEach() или Array.prototype.map(), "дырки" будут пропущены.

var arr = [1, 2, 3, , ,];
arr.length; // 5

Объекты

Начиная с ECMAScript 5, висящие запятые в объектах также допустимы:

var object = {
  foo: "bar",
  baz: "qwerty",
  age: 42,
};

Висящие запятые в функциях

ECMAScript 2017 допускает висящие запятые в списке параметров функции.

Определение параметров

Следующие определения параметров функций допустимы и равнозначны друг другу. Висящие запятые не влияют на свойство length функции или их объект arguments.

function f(p) {}
function f(p,) {}

(p) => {};
(p,) => {};

Висящая запятая также работает с определением методов для классов или объектов:

class C {
  one(a,) {},
  two(a, b,) {},
}

var obj = {
  one(a,) {},
  two(a, b,) {},
};

Вызов функции

Следующие вызовов функций допустимы и равнозначны друг другу.

f(p);
f(p,);

Math.max(10, 20);
Math.max(10, 20,);

Недопустимые висящие запятые

Определение параметров функции или вызов функции, содержащих только запятую будет генерировать SyntaxError. Кроме того, при использовании остаточных параметров не допускается использовать висящие запятые:

function f(,) {} // SyntaxError: missing formal parameter
(,) => {};       // SyntaxError: expected expression, got ','
f(,)             // SyntaxError: expected expression, got ','

function f(...p,) {} // SyntaxError: parameter after rest parameter
(...p,) => {}        // SyntaxError: expected closing parenthesis, got ','

Висящие запятые в деструктурировании

Висящие запятые так же можно использовать слева при использовании деструктурирующего присваивания:

// массив деструктурируется с висящей запятой
[a, b,] = [1, 2];

// объект деструктурируется с висящей запятой
var o = {
  p: 42,
  q: true,
};
var { p, q } = o;

Ещё раз, при использовании оставшихся параметров будет сгенерирована SyntaxError:

var [a, ...b,] = [1, 2, 3];
// SyntaxError: rest element may not have a trailing comma

Висящие запятые в JSON

Висящие запятые в объекте допустимы только в ECMAScript 5. Так как JSON основан на синтаксисе JavaScript старше, чем ES5, висящие запятые не допускаются в JSON.

Обе строки генерируют SyntaxError:

JSON.parse("[1, 2, 3, 4, ]");
JSON.parse('{"foo" : 1, }');
// SyntaxError JSON.parse: unexpected character
// at line 1 column 14 of the JSON data

Опустите висящие запятые, чтобы правильно проанализировать JSON:

JSON.parse("[1, 2, 3, 4 ]");
JSON.parse('{"foo" : 1 }');

Спецификации

Совместимость с браузерами

Смотрите также

• Initial ECMAScript proposal: trailing function commas by Jeff Morrison