lib.externalHelpers
- 类型:
boolean - 默认值:
false
是否从 @swc/helpers 导入 SWC 辅助函数而不是内联它们。
默认情况下，输出的 JavaScript 文件可能需要辅助函数来支持目标环境或输出格式，这些辅助函数会被内联到需要它们的文件中。
当 externalHelpers 设置为 true 时，输出的 JavaScript 将从外部模块 @swc/helpers 导入辅助函数，这有助于减少最终包中的重复辅助代码，减小包体积。
Note
请确保在 package.json 的 dependencies 字段中声明并安装了 @swc/helpers。
示例
以下面的代码为例：
index.ts
export default class FOO {
get bar() {
return;
}
}当 externalHelpers 禁用时，输出的 JavaScript 将内联辅助函数。
rslib.config.ts
export default {
lib: [
{
syntax: 'es5',
externalHelpers: false,
},
],
};以下是输出的 JavaScript 文件，高亮部分是内联的辅助函数：
index.js
function _class_call_check(instance, Constructor) {
if (!(instance instanceof Constructor))
throw new TypeError('Cannot call a class as a function');
}
function _defineProperties(target, props) {
for (var i = 0; i < props.length; i++) {
var descriptor = props[i];
descriptor.enumerable = descriptor.enumerable || false;
descriptor.configurable = true;
if ('value' in descriptor) descriptor.writable = true;
Object.defineProperty(target, descriptor.key, descriptor);
}
}
function _create_class(Constructor, protoProps, staticProps) {
if (protoProps) _defineProperties(Constructor.prototype, protoProps);
if (staticProps) _defineProperties(Constructor, staticProps);
return Constructor;
}
var src_FOO = /*#__PURE__*/ (function () {
'use strict';
function FOO() {
_class_call_check(this, FOO);
}
_create_class(FOO, [
{
key: 'bar',
get: function () {},
},
]);
return FOO;
})();
export { src_FOO as default };当启用 externalHelpers 时，输出的 JavaScript 将从外部模块 @swc/helpers 导入辅助函数。
rslib.config.ts
export default {
lib: [
{
syntax: 'es5',
externalHelpers: true,
},
],
};以下是输出的 JavaScript 文件，高亮部分是导入的辅助函数：
index.js
import { _ } from '@swc/helpers/_/_class_call_check';
import { _ as _create_class_ } from '@swc/helpers/_/_create_class';
var src_FOO = /*#__PURE__*/ (function () {
'use strict';
function FOO() {
_(this, FOO);
}
_create_class_(FOO, [
{
key: 'bar',
get: function () {},
},
]);
return FOO;
})();
export { src_FOO as default };