Bun 提供一個通用的外掛程式 API,可用於擴充執行時期和打包器。
外掛程式攔截匯入並執行自訂載入邏輯:讀取檔案、轉譯程式碼等。它們可用於新增對其他檔案類型的支援,例如 .scss
或 .yaml
。在 Bun 的打包器中,外掛程式可用於實作架構層級功能,例如 CSS 萃取、巨集和客戶端伺服器程式碼共置。
如需外掛程式 API 的更完整文件,請參閱 執行時期 > 外掛程式。
用法
外掛程式定義為包含 name
屬性和 setup
函式的簡單 JavaScript 物件。使用 plugin
函式向 Bun 註冊外掛程式。
import type { BunPlugin } from "bun";
const myPlugin: BunPlugin = {
name: "Custom loader",
setup(build) {
// implementation
},
};
呼叫 Bun.build
時,可以將此外掛程式傳遞至 plugins
陣列中。
Bun.build({
entrypoints: ["./app.ts"],
outdir: "./out",
plugins: [myPlugin],
});