跳至主要内容

@babel/plugin-transform-object-rest-spread

信息

此插件包含在 @babel/preset-env 中,位于 ES2018

示例

剩余属性

JavaScript
let { x, y, ...z } = { x: 1, y: 2, a: 3, b: 4 };
console.log(x); // 1
console.log(y); // 2
console.log(z); // { a: 3, b: 4 }

展开属性

JavaScript
let n = { x, y, ...z };
console.log(n); // { x: 1, y: 2, a: 3, b: 4 }

安装

npm install --save-dev @babel/plugin-transform-object-rest-spread

用法

babel.config.json
{
"plugins": ["@babel/plugin-transform-object-rest-spread"]
}

通过 CLI

Shell
babel --plugins @babel/plugin-transform-object-rest-spread script.js

通过 Node API

JavaScript
require("@babel/core").transformSync("code", {
plugins: ["@babel/plugin-transform-object-rest-spread"],
});

选项

默认情况下,此插件将使用 Babel 的 objectSpread 辅助函数生成符合规范的代码。

loose

boolean,默认为 false

启用此选项将使用 Babel 的 extends 辅助函数,它与 Object.assign 基本相同(请参阅下面的 useBuiltIns 以直接使用它)。

注意

请考虑迁移到顶级的 setSpreadProperties 假设。

babel.config.json
{
"assumptions": {
"setSpreadProperties": true
}
}

请记住,即使它们几乎等效,展开和 Object.assign 之间也存在重要区别:**展开定义新属性,而 Object.assign() 设置它们**,因此在这种模式下,在某些情况下可能会产生意外结果。

有关详细信息,请查看 展开 VS. Object.assign分配 VS. 定义属性

useBuiltIns

boolean,默认为 false

启用此选项将直接使用 Object.assign,而不是 Babel 的 extends 辅助函数。

示例

.babelrc

JSON
{
"assumptions": {
"setSpreadProperties": true
},
"plugins": [
["@babel/plugin-transform-object-rest-spread", { "useBuiltIns": true }]
]
}

输入

JavaScript
z = { x, ...y };

输出

JavaScript
z = Object.assign({ x }, y);
提示

您可以在 此处 阅读有关配置插件选项的更多信息

参考