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 对象
outputOptions
对象可以包含以下属性(有关详细信息,请参见
选项大全
):