Testing & Browser Support

The package targets modern browsers supported by Vue and the underlying PDF/browser APIs.

Recommended testing:

• Chromium / Chrome / Edge
• Firefox
• WebKit
• Safari when Safari is important to production users

Playwright WebKit tests the WebKit engine; it is not identical to testing the Safari application itself.

Testing

The release verification covers major public workflows, including:

• Canvas and selectable-text PDF generation
• Blob, ArrayBuffer and Base64 output APIs
• preview Blob creation
• download
• native browser print flow
• rendering mode routing
• selectable-text generation
• PDF link annotations
• pagination and page-break mapping
• data-pdf-ignore
• export-only page/body styling
• themes, custom CSS, external stylesheets and auto-fit
• metadata
• compression
• security
• protected/unprotected PDFs
• header page targeting
• selective header spacing
• optional header/footer logos
• custom logo sizing
• header/footer HTML rendering
• selectable header/footer text
• footer page numbering
• per-page watermark targeting
• progress stages
• page-aware currentPage / totalPages
• opt-in generation metrics
• cooperative cancellation and recovery
• portrait and landscape layouts
• large-document regression/stress scenarios
• selectable repeated-image caching
• page-bounded Canvas image-heavy rendering
• temporary rendering DOM/snapshot cleanup
• SSR-safe package import
• Nuxt 3 and Nuxt 4 SSR/hydration/client navigation

Package-manager consumer matrix

Packed-package consumer fixtures run against:

• npm
• pnpm
• Yarn
• Yarn Plug'n'Play
• Bun

These fixtures verify install behavior, TypeScript resolution, production builds, CSS imports, and runtime PDF generation.

Because PDF rendering is CPU-heavy, a small Playwright worker count is recommended:

npx playwright test --workers=2

Use a single worker for heavy stress/regression suites:

npx playwright test --workers=1

Run the package's release checks before publishing changes to the PDF library itself. Application consumers should also test representative real documents on the browsers and devices that matter to their users.