function showGracefulFailureDialog(error) const dialog = <div class="pdf-error-card"> <h3>⚠️ PDF could not be generated</h3> <p>$error.message</p> $error.recoverable ? '<button onclick="retryPDF()">Try again</button>' : '' <button onclick="exportRawData()">Download data as CSV/JSON</button> <button onclick="contactSupport()">Report issue</button> <details> <summary>Technical details</summary> <pre>$error.code</pre> </details> </div> ; showModal(dialog);
// Frontend / API validation example function validatePDFRequest(data) const issues = []; if (!data.content) issues.push("No content provided"); if (data.content?.length > 500_000) issues.push("Content too large (>500k chars)"); if (data.images?.some(img => img.size > 10_000_000)) issues.push("Image exceeds 10MB limit"); return issues;
Return a clean error message before ever calling the PDF engine. Never send an error inside a PDF binary. Use structured responses. Success (200 OK with PDF) Content-Type: application/pdf Content-Disposition: attachment; filename="report.pdf" Failure (200 OK with JSON) Even for errors, use 200 OK to avoid browser download interruption, then handle on frontend. gracefully broken pdf download
function exportRawData() const formData = collectFormData(); const blob = new Blob([JSON.stringify(formData, null, 2)], type: 'application/json' ); const url = URL.createObjectURL(blob); const a = document.createElement('a'); a.href = url; a.download = 'report-data.json'; a.click(); URL.revokeObjectURL(url); showToast("Raw data saved – you can retry PDF generation later.");
If the PDF library fails mid‑generation, catch and transform the error. Use structured responses
try: pdf = generate_pdf(data) return pdf except Exception as e: logger.error(f"PDF generation failed: str(e)") return jsonify( "success": False, "error": "code": "PDF_RENDER_ERROR", "message": "Report could not be assembled due to invalid data.", "recoverable": False, "userDataPreserved": True ), 200 # still 200 to avoid download interrupt If PDF fails, offer structured data export.
function logPDFFailure(error, context) navigator.sendBeacon('/api/log-pdf-error', JSON.stringify( errorCode: error.code, userAction: 'download_pdf', timestamp: Date.now(), page: window.location.pathname, dataSize: context.dataSize )); try: pdf = generate_pdf(data) return pdf except Exception
Send anonymized failure reports to your analytics.
