object-shorthand

要求或禁止对象文字的方法和属性简写语法

ECMAScript 6 提供了一种简洁的形式来定义对象文字方法和属性。这种语法可以使定义复杂的对象文字变得更加简洁。

以下是一些使用 ES5 语法的常见示例

// properties
var foo = {
    x: x,
    y: y,
    z: z,
};

// methods
var foo = {
    a: function() {},
    b: function() {}
};
1
2
3
4
5
6
7
8
9
10
11
12

现在，以下是 ES6 等效项

// properties
var foo = {x, y, z};

// methods
var foo = {
    a() {},
    b() {}
};
1
2
3
4
5
6
7
8

规则详细信息

此规则强制使用简写语法。这适用于在对象文字中定义的所有方法（包括生成器）以及在键名称与分配的变量名称匹配的情况下定义的所有属性。

以下每个属性都会发出警告

/*eslint object-shorthand: "error"*/

var foo = {
    w: function() {},
    x: function *() {},
    [y]: function() {},
    z: z
};
1
2
3
4
5
6
7
8

在这种情况下，预期的语法应该是

/*eslint object-shorthand: "error"*/

var foo = {
    w() {},
    *x() {},
    [y]() {},
    z
};
1
2
3
4
5
6
7
8

此规则不会标记对象文字内部的箭头函数。以下内容将 *不会* 发出警告

/*eslint object-shorthand: "error"*/

var foo = {
    x: (y) => y
};
1
2
3
4
5

选项

该规则采用一个选项来指定何时应用它。它可以设置为以下值之一

• "always"（默认）预期只要可能就使用简写形式。
• "methods" 确保使用方法简写（也适用于生成器）。
• "properties" 确保使用属性简写（在键和变量名称匹配的情况下）。
• "never" 确保在任何对象文字中都不使用属性或方法简写形式。
• "consistent" 确保在一个对象文字中使用所有简写形式或所有长格式。
• "consistent-as-needed" 确保在一个对象文字中使用所有简写形式或所有长格式，但只要可能就确保所有简写形式。

您可以在配置中这样设置选项

{
    "object-shorthand": ["error", "always"]
}
1
2
3

此外，该规则采用可选的对象配置

• "avoidQuotes": true 表示当对象键是字符串文字时（默认：false），更倾向于使用长格式语法。请注意，此选项只能在字符串选项设置为 "always"、"methods" 或 "properties" 时启用。
• "ignoreConstructors": true 可用于防止该规则报告构造函数的错误。（默认情况下，该规则将构造函数与其他函数一样对待。）请注意，此选项只能在字符串选项设置为 "always" 或 "methods" 时启用。
• "methodsIgnorePattern" (string) 对于名称与该正则表达式模式匹配的方法，将不会强制执行方法简写形式。请注意，此选项只能在字符串选项设置为 "always" 或 "methods" 时使用。
• "avoidExplicitReturnArrows": true 表示更倾向于使用方法而不是显式返回箭头函数来表示函数属性。（默认情况下，该规则允许使用这两种方法。）请注意，此选项只能在字符串选项设置为 "always" 或 "methods" 时启用。

avoidQuotes

{
    "object-shorthand": ["error", "always", { "avoidQuotes": true }]
}
1
2
3

使用 "always", { "avoidQuotes": true } 选项，此规则的不正确代码示例

/*eslint object-shorthand: ["error", "always", { "avoidQuotes": true }]*/

var foo = {
    "bar-baz"() {}
};
1
2
3
4
5

使用 "always", { "avoidQuotes": true } 选项，此规则的正确代码示例

/*eslint object-shorthand: ["error", "always", { "avoidQuotes": true }]*/

var foo = {
    "bar-baz": function() {},
    "qux": qux
};
1
2
3
4
5
6

ignoreConstructors

{
    "object-shorthand": ["error", "always", { "ignoreConstructors": true }]
}
1
2
3

使用 "always", { "ignoreConstructors": true } 选项，此规则的正确代码示例

/*eslint object-shorthand: ["error", "always", { "ignoreConstructors": true }]*/

var foo = {
    ConstructorFunction: function() {}
};
1
2
3
4
5

methodsIgnorePattern

使用 "always", { "methodsIgnorePattern": "^bar$" } 选项，此规则的正确代码示例

/*eslint object-shorthand: ["error", "always", { "methodsIgnorePattern": "^bar$" }]*/

var foo = {
    bar: function() {}
};
1
2
3
4
5

avoidExplicitReturnArrows

{
    "object-shorthand": ["error", "always", { "avoidExplicitReturnArrows": true }]
}
1
2
3

使用 "always", { "avoidExplicitReturnArrows": true } 选项，此规则的不正确代码示例

/*eslint object-shorthand: ["error", "always", { "avoidExplicitReturnArrows": true }]*/

var foo = {
  foo: (bar, baz) => {
    return bar + baz;
  },

  qux: (foobar) => {
    return foobar * 2;
  }
};
1
2
3
4
5
6
7
8
9
10
11

使用 "always", { "avoidExplicitReturnArrows": true } 选项，此规则的正确代码示例

/*eslint object-shorthand: ["error", "always", { "avoidExplicitReturnArrows": true }]*/

var foo = {
  foo(bar, baz) {
    return bar + baz;
  },

  qux: foobar => foobar * 2
};
1
2
3
4
5
6
7
8
9

使用 "consistent" 选项，此规则的不正确代码示例

/*eslint object-shorthand: [2, "consistent"]*/

var foo = {
    a,
    b: "foo",
};
1
2
3
4
5
6

使用 "consistent" 选项，此规则的正确代码示例

/*eslint object-shorthand: [2, "consistent"]*/

var foo = {
    a: a,
    b: "foo"
};

var bar = {
    a,
    b,
};
1
2
3
4
5
6
7
8
9
10
11

使用 "consistent-as-needed" 选项的不正确代码示例，它与 "consistent" 非常相似

/*eslint object-shorthand: [2, "consistent-as-needed"]*/

var foo = {
    a: a,
    b: b,
};
1
2
3
4
5
6

何时不使用它

尚未处于 ES6 环境中的任何人都不会想要应用此规则。其他人可能会发现简写语法的简洁性难以阅读，并且可能不想使用此规则来鼓励它。

相关规则

• no-useless-rename

版本

此规则在 ESLint v0.20.0 中引入。

进一步阅读

对象初始化器 - JavaScript | MDN
developer.mozilla.org

资源

• 规则源代码
• 测试源代码