DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
World desk5 min

How to Fix Blank PDFs When Converting a Webpage with Puppeteer

A step-by-step diagnosis for blank Puppeteer PDFs, from the navigation response and rendered content to print CSS, PDF options, and font readiness.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A blank Puppeteer PDF usually means something went wrong before or during printing: navigation reached an unexpected response, the page had not rendered its content, print CSS hid it, or PDF options excluded visible elements. Check those stages in that order rather than adding a fixed delay or assuming one setting fixes every page.

1. Confirm navigation reached the expected page

Start by checking the final URL and the main document response returned by page.goto(). A navigation promise resolving does not by itself establish that the page is the one your job expected. Puppeteer’s API documents that HTTP status should be read from the response; in headless shell mode, valid HTTP error responses such as 404 or 500 do not necessarily make goto() throw. See the Puppeteer Page.goto() API.

As an Amazon Associate I earn from qualifying purchases.

const response = await page.goto(url, { waitUntil: 'networkidle2' });
console.log({ url: page.url(), status: response?.status() });

Use navigation options supported by the Puppeteer version installed in your project. A non-2xx response, redirect to an unexpected destination, or missing response is a reason to investigate the request and target page before debugging PDF settings.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

2. Wait for the content that belongs in the PDF

Navigation completion is not the same as application readiness. A client-rendered page can still be waiting for data or UI updates after its document loads. Prefer a selector or application-specific signal that represents the content to print. Puppeteer documents waitForSelector(), waitForFunction(), and waitForNetworkIdle(); generic network quiet can be a poor readiness test on pages with ongoing background requests. See the Page API and PDF generation guide.

#1 Best Overall
Sale
Epson Workforce ES-50 Compact & Lightweight Mobile Document Scanner
  • PORTABLE SCANNER FOR USE ON-THE-GO — The fastest and lightest mobile single-sheet-fed compact document scanner in its class¹
  • QUICK DOCUMENT SCANNING ― This Epson ultra-fast scanner scans a single page as quickly as 5.5 seconds²; Windows and Mac compatible
  • VERSATILE PAPER HANDLING ― Portable scanner scans documents up to 8.5 x 72 in; Also easily digitizes receipts and ID cards to make accounting, bookkeeping, and organizing simpler
  • INTUITIVE, HIGH-SPEED SOFTWARE — Epson ScanSmart Software³ is a smart tool allowing you to easily scan, review, and save; Stay organized easily with the help of this Epson scanner
  • EASY SETUP — USB-powered connect to your computer for quick and simple scanning; No batteries or external power supply required to operate portable document scanner; Standard Connectivity: USB 2.0
await page.goto(url, { waitUntil: 'domcontentloaded' });
await page.waitForSelector('#report-content', { visible: true });
await page.pdf({ path: 'page.pdf' });

Replace #report-content with a selector that is both meaningful and present on the target page. If the app exposes a reliable ready state, wait for that instead. Do not apply networkidle2 or a fixed sleep as a universal cure: neither proves the specific content you need is present.

3. Check print CSS before changing the PDF settings

Page.pdf() renders using the print CSS media type by default. A page that looks normal in a browser window can therefore become blank or incomplete if its print styles hide content, change visibility, or rearrange the layout. Inspect the page’s @media print rules and its computed styles in print mode first. The official Page.pdf() API documents this default.

Rank #2
Sale
Brother DS-640 Compact Mobile Document Scanner, (Model: DS640)
  • FAST SPEEDS - Scans color and black and white documents a blazing speed up to 16ppm (1). Color scanning won’t slow you down as the color scan speed is the same as the black and white scan speed.
  • ULTRA COMPACT – At less than 1 foot in length and only about 1. 5lbs in weight you can fit this device virtually anywhere (a bag, a purse, even a pocket).
  • READY WHENEVER YOU ARE – The DS-640 mobile scanner is powered via an included micro USB 3. 0 cable allowing you to use it even where there is no outlet available. Plug it into you PC or laptop and you are ready to scan.
  • WORKS YOUR WAY – Use the Brother free iPrint&Scan desktop app for scanning to multiple “Scan-to” destinations like PC, Network, cloud services, Email and OCR. (2) Supports Windows, Mac and Linux and TWAIN/WIA for PC/ICA for Mac/SANE drivers. (3)
  • OPTIMIZE IMAGES AND TEXT – Automatic color detection/adjustment, image rotation (PC only), bleed through prevention/background removal, text enhancement, color drop to enhance scans. Software suite includes document management and OCR software. (4)

When screen styling is the intended output

If the page is meant to be captured as it appears on screen and print styling is the difference, compare with screen media:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
await page.emulateMediaType('screen');
await page.pdf({ path: 'page.pdf' });

This changes the media type used for rendering; it does not repair failed navigation or content that has not loaded. If the page is intended to have a print layout, fix its print CSS rather than forcing screen media.

Rank #3
Sale
Canon imageFORMULA R10 - Portable Document Scanner, USB Powered, Duplex Scanning, Document Feeder, Easy Setup, Convenient, Perfect for Mobile Users, White
  • STAY ORGANIZED – Easily convert your paper documents into digital formats like searchable PDF files, JPEGs, and more.Power Consumption : 2.5W or less (Energy Saving Mode: 0.7W). Suggested Daily Volume : 500 scans..Does it contain liquid: no
  • CONVENIENT AND PORTABLE –lightweight and small in size, you can take the scanner anywhere from home offices, classrooms, remote offices, and anywhere in between
  • HANDLES VARIOUS MEDIA TYPES – Digitize receipts, business cards, plastic or embossed cards, reports, legal documents, and more
  • FAST AND EFFICIENT – No technical hurdles or complicated setups here; easily scan both sides of a document at the same time, in color or black-and-white, at up to 12 pages-per-minute, and with a 20 sheet automatic feeder
  • BROAD COMPATIBILITY – Works with both Windows and Mac devices, be it laptop or computer

Background colors and graphics

printBackground defaults to false. If the page relies on background colors or images for legibility or layout, test printBackground: true. A missing background is different from a missing DOM: first establish whether text and elements are present, then determine whether a background is also needed.

await page.pdf({ path: 'page.pdf', printBackground: true });

Puppeteer also notes that print rendering modifies colors by default; its API documents -webkit-print-color-adjust for requesting exact colors. That affects color reproduction, not whether content was loaded.

Rank #4
IRIScan Express 4 Black Compact Portable USB Simplex Document Scanner, 8 PPM for Contracts, Invoices and Business Cards, Compatible with Windows, Readiris PDF Included
  • IRIScan Express, portable scanner : scans color and black and white documents a blazing speed up to 8ppm simplex. Color scanning won’t slow you down as the color scan speed is the same as the black and white scan speed.
  • IRIScan Express mobile scanner is powered via an included micro USB 2. 0 cable allowing you to use it even where there is no outlet available. Plug it into you PC or laptop and you are ready to scan. USB cable provided. AC Adapter not provided and not needed.
  • IRIScan flatbed scanner uses a simplex scanning mode allows for quick and straightforward scanning of single-sided documents. IRIScan with its full portable features is the ideal document scanners for computers.
  • IRIScan document scanner : Versatile scanning capabilities, including scanning to Word, PDF, and Excel formats with companion software provided Readiris OCR
  • Receipt scanner and card scanner with Additional features include scanning business cards directly to Outlook, photo scanning, and receipt scanning for efficient document management

4. Inspect PDF options that can hide or omit the result

Review the options passed by your code and any wrapper around it. In the documented PDF options, the default paper format is letter, preferCSSPageSize defaults to false, and pageRanges defaults to all pages. An explicit page range, paper-size choice, or CSS page-size preference can change what appears in the output. omitBackground defaults to false; enabling it removes the default white background. Check the PDFOptions API against the version installed in your project.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Remove any unintended pageRanges value while diagnosing.
  • Check format, preferCSSPageSize, and any explicit width or height against the page’s layout.
  • Use printBackground: true only when background graphics are required.
  • Make sure omitBackground is not enabled if the document needs a white page background.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

5. Verify font readiness using Puppeteer’s documented behavior

The PDF generation guide says Page.pdf() waits for fonts by default. The PDF options describe waitForFonts as waiting for document.fonts.ready, with a default of true; the documentation notes that bringing a background page to the foreground may be necessary. If fonts appear related to missing or shifted content, verify the installed Puppeteer version and this option before adding arbitrary delays. See the PDF generation guide and PDFOptions API.

Best Value
Canon Canoscan Lide 300 Scanner (PDF, AUTOSCAN, Copy, Send)
  • Scanner type: Document
  • Connectivity technology: USB
  • With Auto Scan Mode, the scanner automatically detects what you're scanning
  • Digitize documents and images

6. Use this diagnostic order

  1. Log page.url() and the page.goto() response status; confirm the destination is correct.
  2. Wait for a visible, page-specific content selector or application readiness signal; inspect that the expected content exists before printing.
  3. Compare print and screen media. If print CSS is intended, inspect its rules; if screen styling is intended, test page.emulateMediaType('screen').
  4. Check backgrounds, paper sizing, page ranges, and any PDF options supplied by your application.
  5. Check font readiness through the documented default and waitForFonts option.
  6. Record the installed Puppeteer and browser versions when reducing the problem to a reproducible case.

Or skip the browser setup

ScreenshotNeo provides a website screenshot API and MCP server, but it is not a Puppeteer PDF debugger. For a PDF capture, use its PDF option in the request; the following one-call example shows the documented endpoint and saves the response as a file. See the ScreenshotNeo documentation for request options.

curl -G "https://api.screenshotneo.com/v1/shot" 
  -d access_key=YOUR_API_KEY 
  --data-urlencode url=https://example.com 
  -d format=pdf 
  -o page.pdf

ScreenshotNeo removes cookie banners, newsletter popups, and chat widgets before capture; bot checks, blank pages, and failed loads are never billed. Its MCP server lets AI agents take screenshots. The free plan includes 1,000 screenshots a month with no card, and paid plans start at $5 for 3,000. Sign up for free.

Frequently Asked Questions

Does a blank Puppeteer PDF mean Chromium failed?

Not necessarily. Check the navigation response, page content readiness, print media styling, and PDF options before attributing the result to the browser.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Which Puppeteer version do these API details describe?

The API reference consulted displayed Puppeteer Version 25.12.0; documentation can change, so check the installed version before relying on an option.

Quick Recap

SaleBestseller No. 3
Canon imageFORMULA R10 - Portable Document Scanner, USB Powered, Duplex Scanning, Document Feeder, Easy Setup, Convenient, Perfect for Mobile Users, White
Canon imageFORMULA R10 - Portable Document Scanner, USB Powered, Duplex Scanning, Document Feeder, Easy Setup, Convenient, Perfect for Mobile Users, White
BROAD COMPATIBILITY – Works with both Windows and Mac devices, be it laptop or computer; This product is not intended for scanning photographs on photo paper / photographic media
$153.00
Bestseller No. 4
IRIScan Express 4 Black Compact Portable USB Simplex Document Scanner, 8 PPM for Contracts, Invoices and Business Cards, Compatible with Windows, Readiris PDF Included
IRIScan Express 4 Black Compact Portable USB Simplex Document Scanner, 8 PPM for Contracts, Invoices and Business Cards, Compatible with Windows, Readiris PDF Included
Find our Software here : irislink.com/start; IRIScan Express is only compatible Windows platform and not macintosh
$129.00
Bestseller No. 5
Canon Canoscan Lide 300 Scanner (PDF, AUTOSCAN, Copy, Send)
Canon Canoscan Lide 300 Scanner (PDF, AUTOSCAN, Copy, Send)
Scanner type: Document; Connectivity technology: USB; With Auto Scan Mode, the scanner automatically detects what you're scanning
$75.00

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.