${escapeHtml(title || '')}

// filePrint.js /** * 远程文件打印工具 * * 思路：先把文件字节 fetch 到浏览器，再按格式转成浏览器可渲染的内容（HTML 或 PDF）， * 最后塞进隐藏 iframe 调用 print()。这样绕开了文件地址上 Content-Disposition: attachment * 导致的"直接下载"问题，也不依赖后端提供预览/转换接口。 * * mammoth / xlsx 用动态 import 按需加载，不进主包。 */ // 各格式支持情况 const IMAGE_SUFFIX = ['jpg', 'jpeg', 'png', 'gif', 'bmp', 'webp', 'svg'] const TEXT_SUFFIX = ['txt', 'log', 'json', 'xml', 'csv', 'md', 'properties', 'yml', 'yaml', 'ini', 'conf', 'sql'] const WORD_SUFFIX = ['docx'] const EXCEL_SUFFIX = ['xlsx', 'xls', 'xlsm'] // 打印页面的基础样式 const BASE_PRINT_CSS = ` @page { margin: 12mm; } body { margin: 0; font-family: "Microsoft YaHei", "PingFang SC", Arial, sans-serif; font-size: 12px; color: #000; } img { max-width: 100%; } table { width: 100%; border-collapse: collapse; table-layout: auto; page-break-inside: auto; } table, th, td { border: 1px solid #333; } th, td { padding: 4px 6px; word-break: break-all; } thead { display: table-header-group; } tr { page-break-inside: avoid; } h1, h2, h3, h4 { page-break-after: avoid; } pre { white-space: pre-wrap; word-break: break-all; font-family: Consolas, Monaco, monospace; margin: 0; } .zk-print-sheet-title { font-size: 14px; font-weight: bold; margin: 12px 0 6px; } .zk-print-sheet + .zk-print-sheet { page-break-before: always; } ` function escapeHtml(str) { return String(str) .replace(/&/g, '&') .replace(//g, '>') .replace(/"/g, '"') .replace(/'/g, ''') } /** * 拉取文件内容。CORS 必须由文件所在服务（如 OSS）放行，否则这里会抛错。 */ async function fetchArrayBuffer(url) { const res = await fetch(url) if (!res.ok) { throw new Error(`文件请求失败（HTTP ${res.status}）`) } return res.arrayBuffer() } /** * 文本解码：先按 UTF-8 严格解，失败再按 GBK 兜底（老系统导出的中文 txt 常是 GBK）。 */ function decodeText(buffer) { try { return new TextDecoder('utf-8', { fatal: true }).decode(buffer) } catch (e) { try { return new TextDecoder('gbk').decode(buffer) } catch (e2) { return new TextDecoder('utf-8').decode(buffer) } } } /** * 等 iframe 里的图片都加载完再打印，否则可能打出空白图。 */ function waitForImages(doc, timeout = 10000) { const images = Array.from(doc.images || []) if (!images.length) return Promise.resolve() const loaded = Promise.all( images.map( img => new Promise(resolve => { if (img.complete) { resolve() return } img.addEventListener('load', resolve, { once: true }) img.addEventListener('error', resolve, { once: true }) }) ) ) const timer = new Promise(resolve => setTimeout(resolve, timeout)) return Promise.race([loaded, timer]) } function createHiddenIframe() { const iframe = document.createElement('iframe') iframe.setAttribute('aria-hidden', 'true') // 不能用 display:none，部分浏览器不会渲染也不会打印 iframe.style.cssText = 'position:fixed;right:0;bottom:0;width:0;height:0;border:0;visibility:hidden;' document.body.appendChild(iframe) return iframe } /** * 把一段 HTML 放进隐藏 iframe 并唤起打印对话框。 * iframe 是同源的（document.write），所以 print() 不会被跨域限制拦掉。 */ function printHtml(html, title) { return new Promise((resolve, reject) => { const iframe = createHiddenIframe() const remove = () => setTimeout(() => iframe.parentNode && iframe.parentNode.removeChild(iframe), 1000) try { const doc = iframe.contentWindow.document doc.open() doc.write( `` + `${escapeHtml(title || '')}` + `${html}` ) doc.close() waitForImages(doc).then(() => { try { iframe.contentWindow.focus() iframe.contentWindow.print() remove() resolve() } catch (e) { remove() reject(e) } }) } catch (e) { remove() reject(e) } }) } /** * 动态 import 拿到的可能是 ES 命名空间对象，也可能是 CJS 的 module.exports 包了一层 default， * 这里统一取到真正的模块对象。 */ async function loadModule(loader, probeKey) { const mod = await loader() if (mod && typeof mod[probeKey] === 'function') return mod if (mod && mod.default && typeof mod.default[probeKey] === 'function') return mod.default return mod && mod.default ? mod.default : mod } /** * PDF 走 print-js：它内部会把 PDF 塞进 iframe 并等浏览器 PDF 阅读器就绪后打印。 * 这里传 blob URL 而不是原始地址，避免库内请求再受 Content-Disposition / 签名影响。 */ async function printPdf(buffer, title) { const mod = await import('print-js') const printJS = typeof mod === 'function' ? mod : mod.default const blobUrl = URL.createObjectURL(new Blob([buffer], { type: 'application/pdf' })) return new Promise((resolve, reject) => { let settled = false // onLoadingEnd / onPrintDialogClose 在各浏览器触发情况不一致，先到先算， // 再加超时兜底，避免调用方的 loading 提示一直挂着。 const done = () => { if (settled) return settled = true resolve() } const fallbackTimer = setTimeout(done, 8000) printJS({ printable: blobUrl, type: 'pdf', documentTitle: title, onLoadingEnd: done, onPrintDialogClose: done, onError: err => { if (settled) return settled = true clearTimeout(fallbackTimer) URL.revokeObjectURL(blobUrl) reject(err instanceof Error ? err : new Error('PDF 加载失败')) } }) // 打印对话框未关闭前不能回收 blob，否则预览会空白 setTimeout(() => URL.revokeObjectURL(blobUrl), 120000) }) } async function buildImageHtml(buffer, suffix, title) { const mime = suffix === 'svg' ? 'image/svg+xml' : `image/${suffix === 'jpg' ? 'jpeg' : suffix}` const blobUrl = URL.createObjectURL(new Blob([buffer], { type: mime })) // printHtml 打印完成后 iframe 才被移除，这里延迟回收 URL setTimeout(() => URL.revokeObjectURL(blobUrl), 60000) return ` ${escapeHtml(title)}

` } async function buildWordHtml(buffer) { const mammoth = await loadModule(() => import('mammoth'), 'convertToHtml') const result = await mammoth.convertToHtml({ arrayBuffer: buffer }) if (!result.value || !result.value.trim()) { throw new Error('文档内容为空或无法解析') } return result.value } async function buildExcelHtml(buffer) { const XLSX = await loadModule(() => import('xlsx'), 'read') const wb = XLSX.read(buffer, { type: 'array' }) if (!wb.SheetNames.length) { throw new Error('工作簿中没有工作表') } // 多个工作表依次输出，每个表另起一页 return wb.SheetNames.map(name => { const table = XLSX.utils.sheet_to_html(wb.Sheets[name], { editable: false }) const heading = wb.SheetNames.length > 1 ? `

${escapeHtml(name)}

` : '' return `

${heading}${table}

` }).join('') } /** * 打印远程文件。 * * @param {string} url 文件地址（需允许跨域读取） * @param {object} options * @param {string} options.suffix 文件后缀，缺省时从 url / fileName 推断 * @param {string} options.fileName 文件名，用于打印标题 * @returns {Promise} 打印对话框唤起后 resolve；不支持或失败时 reject */ export async function printRemoteFile(url, options = {}) { if (!url) throw new Error('文件地址不存在') const fileName = options.fileName || '' const suffix = String( options.suffix || fileName.split('.').pop() || url.split('?')[0].split('.').pop() || '' ).toLowerCase() if (suffix === 'doc' || suffix === 'ppt' || suffix === 'pptx') { // .doc 是二进制 BIFF 格式，mammoth 不支持；ppt 无成熟的纯前端方案 const err = new Error(`${suffix.toUpperCase()} 格式暂不支持直接打印`) err.unsupported = true throw err } const buffer = await fetchArrayBuffer(url) if (suffix === 'pdf') { return printPdf(buffer, fileName) } let html if (IMAGE_SUFFIX.includes(suffix)) { html = await buildImageHtml(buffer, suffix, fileName) } else if (WORD_SUFFIX.includes(suffix)) { html = await buildWordHtml(buffer) } else if (EXCEL_SUFFIX.includes(suffix)) { html = await buildExcelHtml(buffer) } else if (TEXT_SUFFIX.includes(suffix) || !suffix) { html = `

${escapeHtml(decodeText(buffer))}

` } else { const err = new Error(`${suffix.toUpperCase()} 格式暂不支持直接打印`) err.unsupported = true throw err } return printHtml(html, fileName) } export default { printRemoteFile }