Skip to content

DOCXKIT_EXPORT_FAILED: 文件匯出失敗 ​

編譯後的文件封裝失敗,呼叫端仍可讀取原始 cause。

修復步驟 ​

  1. 在本機檢查 error.cause,定位失敗資源。
  2. 使用目前平台支援的匯出格式,並確認引用資源有效。

問題範例 ​

ts
// Packaging can fail when a referenced resource is invalid.
// Inspect the original cause at the export boundary.

修復範例 ​

ts
import { createDocx, DocxKitError, serializeDocxKitError } from 'docx-kit'

try {
  const blob = await createDocx().p('Hello').toBlob()
} catch (error) {
  if (error instanceof DocxKitError) {
    console.error(serializeDocxKitError(error))
    // Inspect error.cause locally when needed.
  } else {
    throw error
  }
}

常見原因 ​

  • 文件資源無效,或底層封裝過程失敗。

診斷欄位 ​

訊息範例 ​

text
Failed to pack document to blob

原始碼與相關指南 ​

Released under the MIT License.