DOCXKIT_PLUGIN_LOAD_FAILED: 外掛載入失敗

平台環境、安全策略、模組匯入、模組匯出或外掛工廠導致載入失敗。

修復步驟

1. 環境問題使用對應的瀏覽器或 Node.js 載入器。
2. 匯入失敗時檢查進入點、相依套件和網路。
3. 匯出或工廠失敗時回傳有效外掛實例，並檢查原始 cause。
4. 安全策略拒絕時核對來源和權限，繼續阻止不可信程式碼。

問題範例

// An invalid module export:
export default { name: 'example' }

修復範例

import { definePlugin } from 'docx-kit'
import { Paragraph } from 'docx'

export default definePlugin({
  name: 'example',
  render: () => new Paragraph('Hello'),
})

常見原因

• 來源類型不受支援、策略拒絕、匯入錯誤，或外掛匯出無效。

診斷欄位

• code: PLUGIN_LOAD_FAILED
• diagnosticCode: DOCXKIT_PLUGIN_LOAD_FAILED
• name: DocxKitError
• docs: https://docx-kit.ntnyq.dev/errors/docxkit_plugin_load_failed/

訊息範例

Plugin execution blocked by security policy: example

原始碼與相關指南

• 原始碼
• 相關指南
• 捕捉錯誤
• 全部錯誤碼