Bun

外掛程式

Bun 提供一個通用的外掛程式 API,可用於擴充執行時期打包器

外掛程式攔截匯入並執行自訂載入邏輯:讀取檔案、轉譯程式碼等。它們可用於新增對其他檔案類型的支援,例如 .scss.yaml。在 Bun 的打包器中,外掛程式可用於實作架構層級功能,例如 CSS 萃取、巨集和客戶端伺服器程式碼共置。

如需外掛程式 API 的更完整文件,請參閱 執行時期 > 外掛程式

用法

外掛程式定義為包含 name 屬性和 setup 函式的簡單 JavaScript 物件。使用 plugin 函式向 Bun 註冊外掛程式。

myPlugin.ts
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],
});