尾后逗号 - JavaScript | MDN

切换侧边栏

主题

跟随系统
浅色
深色

中文 (简体)

记住语言了解更多

尾后逗号

基线广泛可用 *

自 2015年7月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

* 此特性的某些部分的支持程度可能有所不同。

尾后逗号 （有时叫做“终止逗号”）在向 JavaScript 代码添加元素、参数、属性时十分有用。如果你想要添加新的属性，并且上一行已经使用了尾后逗号，你可以仅仅添加新的一行，而不需要修改上一行。这使得版本控制的代码比较（diff）更加清晰，代码编辑过程中遇到的麻烦更少。

JavaScript 一开始就支持数组字面量中的尾后逗号，随后向对象字面量（ECMAScript 5）中添加了尾后逗号。最近（ECMAScript 2017），又将其添加到函数参数中。

但是，JSON 不允许尾后逗号。

本文内容

字面量中的尾后逗号

数组

JavaScript 忽略数组中的尾后逗号：

js
const arr = [
  1,
  2,
  3,
];

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

如果使用了多于一个尾后逗号，会产生省略（elision，或者间隙 hole）。带有间隙的数组叫做稀疏数组（sparse 紧凑数组 dense array 没有省略/间隙）。例如，当使用 Array.prototype.forEach() 或 Array.prototype.map() 迭代数组时，会跳过数组间隙。

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

对象

从 ECMAScript 5 开始，对象字面值中的尾后逗号也是符合语法的：

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

函数中的尾后逗号

ECMAScript 2017 支持函数参数中的尾后逗号。

参数定义

下面的两个函数定义都是合法的，并且互相等价。尾后逗号并不影响函数定义，或者其 arguments 对象的 length 属性。

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

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

尾后逗号也可用于类或对象的方法定义。

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

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

函数调用

下面的两个函数调用都是合法的，并且互相等价。

js
f(p);
f(p,);

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

不合法的尾后逗号

仅仅包含逗号的函数参数定义或者函数调用会抛出 SyntaxError。而且，当使用剩余参数的时候，并不支持尾后逗号：

js
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 ','

解构中的尾后逗号

解构模式中也允许使用尾后逗号：

js
// 带有尾后逗号的数组解构
[a, b,] = [1, 2];

// 带有尾后逗号的对象解构
const o = {
  p: 42,
  q: true,
};
const { p, q, } = o;

但是，剩余元素后不允许使用尾后逗号（如果存在）

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

JSON 中的尾后逗号

对象中的尾后逗号仅仅在 ECMAScript 5 中引入。由于 JSON 基于 ES5 之前的语法， JSON 中并不允许尾后逗号。

下面两行都会抛出 SyntaxError：

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

去掉尾后逗号就行了：

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

规范

ECMAScript® 2027 Language Specification
# prod-Elision

ECMAScript® 2027 Language Specification
# prod-ObjectLiteral

ECMAScript® 2027 Language Specification
# prod-ArrayLiteral

ECMAScript® 2027 Language Specification
# prod-Arguments

ECMAScript® 2027 Language Specification
# prod-FormalParameters

ECMAScript® 2027 Language Specification
# prod-CoverParenthesizedExpressionAndArrowParameterList

ECMAScript® 2027 Language Specification
# prod-NamedImports

ECMAScript® 2027 Language Specification
# prod-NamedExports

ECMAScript® 2027 Language Specification
# prod-QuantifierPrefix

ECMAScript® 2027 Language Specification
# prod-annexB-InvalidBracedQuantifier

浏览器兼容性

启用 JavaScript 以查看此浏览器兼容性表。

参见

ECMAScript 初始提案：函数的尾后逗号（由 Jeff Morrison 提出）

帮助改进 MDN

此页面对您有帮助吗？

是否

了解如何参与贡献

此页面最后更新于 2025年7月16日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题