title | slug |
---|---|
末尾のカンマ |
Web/JavaScript/Reference/Trailing_commas |
{{JsSidebar("More")}}
末尾のカンマ (「最後のカンマ」と呼ばれることもあります) は、JavaScript のコードに新しい要素や引数、プロパティを追加するときに役立ちます。新しいプロパティを追加するとき、最終行ですでに末尾のカンマを使用していれば、最終行を修正することなく新しい行を追加できます。これによって、バージョン管理の差分がより洗練され、コード編集の煩雑さを軽減できます。
JavaScript は、当初から配列リテラルで末尾のカンマを使用できました。その後でオブジェクトリテラルで、さらに最近では、関数の引数の末尾のカンマが使用できるようになりました。
しかし、JSON では末尾のカンマを許容していません。
,
JavaScript は配列の末尾のカンマを無視します。
var arr = [1, 2, 3];
arr; // [1, 2, 3]
arr.length; // 3
2 つ以上の末尾のカンマがある場合、省略 (または穴) が作られます。穴がある配列は疎らな配列と呼ばれます (密集した配列は穴がありません)。たとえば、{{jsxref("Array.prototype.forEach()")}} や {{jsxref("Array.prototype.map()")}} で配列を反復処理するとき、穴はスキップされます。
var arr = [1, 2, 3, , ,];
arr.length; // 5
ECMAScript 5 から、オブジェクトリテラルでも末尾のカンマを使用できるようになりました。
var object = {
foo: "bar",
baz: "qwerty",
age: 42,
};
ECMAScript 2017 では、関数の引数リストで末尾のカンマが使用できるようになりました。
次の 2 つの関数定義はともに有効で等しいものです。末尾のカンマは、関数の length
プロパティや arguments
オブジェクトに影響を与えません。
function f(p) {}
function f(p,) {}
(p) => {};
(p,) => {};
末尾のカンマは、クラスやオブジェクトのメソッド定義でも使用できます。
class C {
one(a,) {}
two(a, b,) {}
}
var obj = {
one(a,) {},
two(a, b,) {},
};
次の 2 つの関数呼び出しはともに有効で等しいものです。
f(p);
f(p,);
Math.max(10, 20);
Math.max(10, 20,);
関数の定義や呼び出しにおいて引数がカンマしかないと、{{Jsxref("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;
また、残余要素で使用すると、{{jsxref("SyntaxError")}} が発生します。
var [a, ...b,] = [1, 2, 3];
// SyntaxError: rest element may not have a trailing comma
オブジェクトリテラルの末尾のカンマは、ECMAScript 5 から導入されました。JSON は ES5 以前の JavaScript 構文に基づいているため、末尾のカンマを使用できません。
どちらの行も 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 }');
末尾のカンマは名前付きインポートや名前付きエクスポートでも有効です。
import { A, B, C } from "D";
import { X, Y, Z } from "W";
import { A as B, C as D, E as F } from "Z"; // インポートの名前を変更
export { A, B, C };
export { A, B, C };
export { A as B, C as D, E as F }; // エクスポートの名前を変更
//{ DecimalDigits[~Sep], DecimalDigits[~Sep] }
x{n,}
x{n,m}
x{n,m}?
{{Specifications}}
{{Compat}}
- 初期の ECMAScript の提案: trailing function commas by Jeff Morrison