Skip to content

DOCXKIT_PREVIEW_RENDER_FAILED: 預覽渲染失敗 ​

本機 docx-preview 渲染器未能處理此文件。

修復步驟 ​

  1. 確認輸入是有效的 DOCX ZIP 封存檔。
  2. 檢查渲染器原始 cause,並嘗試用 Word 開啟同一檔案。

問題範例 ​

ts
import { createDocx, createDocxPreview } from 'docx-kit'

const container = document.createElement('div')
document.body.append(container)

const preview = createDocxPreview(container)
try {
  await preview.render(new Blob(['plain text']))
} finally { preview.destroy() }

修復範例 ​

ts
import { createDocx, createDocxPreview } from 'docx-kit'

const container = document.createElement('div')
document.body.append(container)

const preview = createDocxPreview(container)
try {
  await preview.render(await createDocx().p('Hello').toBlob())
} finally { preview.destroy() }

常見原因 ​

  • 封存檔損壞、內容不受支援,或渲染器例外。

診斷欄位 ​

訊息範例 ​

text
Failed to render DOCX preview

原始碼與相關指南 ​

Released under the MIT License.