Skip to content

JavaScript API

Rollup 提供了一个可从 Node.js 使用的 JavaScript API。你很少需要使用它,除非你正在扩展 Rollup 本身或者需要编程式地打包等特殊用途,否则应该使用命令行 API。

rollup.rollup ​

rollup.rollup 函数接收一个输入选项对象作为参数,并返回一个 Promise,该 Promise 解析为一个 bundle 对象,该对象具有下列各种属性和方法。在此步骤中,Rollup 将构建模块图并执行除屑优化,但不会生成任何输出。

在 bundle 对象上,你可以多次调用 bundle.generate 并使用不同的输出选项对象来生成不同的产物到内存中。如果你想直接将它们写入磁盘,请使用 bundle.write 。

完成 bundle 对象后,应调用 bundle.close() ,这将通过 closeBundle 钩子让插件清理它们的外部进程或服务。

如果任一阶段发生错误,它将返回一个 Promise,该 Promise 被 reject 得到一个 Error,你可以通过它们的 code 属性来识别。除了 code 和 message ,许多错误还有其他属性,你可以用于自定义报告,见 utils/logs.ts 以获取完整的错误和日志列表,以及它们的代码和属性。

inputOptions 对象 ​

inputOptions 对象可以包含以下属性(有关详细信息,请参见 选项大全 ):

outputOptions 对象 ​

outputOptions 对象可以包含以下属性(有关详细信息,请参见 选项大全 ):