"success": false, "error": "code": "PDF_GEN_FAILED", "message": "Could not render chart data: time series missing.", "recoverable": true, "suggestedAction": "retry", "userDataPreserved": true
# DON'T DO THIS output = BytesIO() pdf = canvas.Canvas(output) pdf.drawString(100, 750, "Report") # crash here – user gets zero-byte or partial PDF
Send anonymized failure reports to your analytics. gracefully broken pdf download
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 ));
// 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; "error": "code": "PDF_GEN_FAILED"
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.");
// Normal PDF download const blob = await response.blob(); const url = URL.createObjectURL(blob); const a = document.createElement('a'); a.href = url; a.download = 'report.pdf'; a.click(); URL.revokeObjectURL(url); JSON.stringify( errorCode: error.code
Content-Type: application/json
Some browsers treat 4xx/5xx responses as download failures and show generic "Failed – Network error". Step 3: Graceful Failure Response on Frontend When receiving a JSON error instead of a PDF blob, show a user‑friendly overlay.