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

Some links on this page are affiliate links: if you buy through them we may earn a commission, at no extra cost to you.

Wait for the page state that supplies the text, then await document.fonts.ready in the browser before calling page.screenshot(). If a particular family, weight, style, or character subset is essential, explicitly request it with document.fonts.load() first. This sequence prevents captures made during a font swap without pretending that every declared font has loaded.

The reliable sequence

Font readiness is a page-state check, not a fixed sleep. A dependable Playwright capture follows this order:

  1. Navigate to the URL.
  2. Wait for the application state that determines what will be visible: a route, hydrated component, API-driven section, or other selector.
  3. Run await page.evaluate(() => document.fonts.ready).
  4. Capture the page or element.

Document.fonts.ready resolves after fonts currently used by the document and associated layout operations are ready. It does not require every @font-face declared in stylesheets to load; unused faces can remain unloaded. The browser APIs are documented by MDN’s FontFaceSet.ready reference and Document.fonts reference.

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

Runnable Playwright example

Install Playwright, then place the wait after the final content state. Replace the example selector with one that is meaningful for your application.

#1 Best Overall
Sale
Philips 24 Inch Computer Monitor FHD 100Hz VA VESA Flicker-Free, 241V8LB
  • CRISP CLARITY: This 23.8″ Philips V line monitor delivers crisp Full HD 1920x1080 visuals. Enjoy movies, shows and videos with remarkable detail
  • INCREDIBLE CONTRAST: The VA panel produces brighter whites and deeper blacks. You get true-to-life images and more gradients with 16.7 million colors
  • THE PERFECT VIEW: The 178/178 degree extra wide viewing angle prevents the shifting of colors when viewed from an offset angle, so you always get consistent colors
  • WORK SEAMLESSLY: This sleek monitor is virtually bezel-free on three sides, so the screen looks even bigger for the viewer. This minimalistic design also allows for seamless multi-monitor setups that enhance your workflow and boost productivity
  • A BETTER READING EXPERIENCE: For busy office workers, EasyRead mode provides a more paper-like experience for when viewing lengthy documents
import { chromium } from 'playwright';

const browser = await chromium.launch();
const page = await browser.newPage({ viewport: { width: 1440, height: 900 } });

await page.goto('https://example.com', { waitUntil: 'domcontentloaded' });

// Wait for the content whose typography will appear in the image.
await page.locator('[data-page-ready="true"]').waitFor();

// Wait in the page context for fonts used by this rendered state.
await page.evaluate(() => document.fonts.ready);

await page.screenshot({ path: 'page.png', fullPage: true });
await browser.close();

If your page has no application-specific marker, use the last reliable state you do have, such as a route-specific heading or a component that appears only after hydration. Do not place the font wait immediately after navigation when client-side rendering can add text later: the set of fonts used by the document can change when that text arrives.

The Playwright Page API supplies navigation, page evaluation, and screenshot methods. The font readiness signal itself comes from the browser’s Document.fonts API.

When to use document.fonts.load()

Use document.fonts.load(font, text) when the screenshot depends on a known face or a specific text subset. The first argument is a CSS font specification, and the second is representative text whose glyphs must be available.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
await page.goto('https://example.com', { waitUntil: 'domcontentloaded' });
await page.locator('main').waitFor();

await page.evaluate(async () => {
  await document.fonts.load('16px "ExampleFont"', 'Headline 0123');
});

await page.screenshot({ path: 'font-specific.png' });

MDN documents that FontFaceSet.load() forces matching fonts to load and fulfills with the loaded FontFace objects. If the requested font fails, the promise rejects, making the problem visible instead of silently capturing a fallback. Read the API details at MDN’s FontFaceSet.load reference.

Rank #2
Philips 22 Inch Computer Monitor FHD 100Hz VA VESA Flicker-Free, 221V8LB
  • CRISP CLARITY: This 22 inch class (21.5″ viewable) Philips V line monitor delivers crisp Full HD 1920x1080 visuals. Enjoy movies, shows and videos with remarkable detail
  • 100HZ FAST REFRESH RATE: 100Hz brings your favorite movies and video games to life. Stream, binge, and play effortlessly
  • SMOOTH ACTION WITH ADAPTIVE-SYNC: Adaptive-Sync technology ensures fluid action sequences and rapid response time. Every frame will be rendered smoothly with crystal clarity and without stutter
  • INCREDIBLE CONTRAST: The VA panel produces brighter whites and deeper blacks. You get true-to-life images and more gradients with 16.7 million colors
  • THE PERFECT VIEW: The 178/178 degree extra wide viewing angle prevents the shifting of colors when viewed from an offset angle, so you always get consistent colors

ready versus load

Method Scope Use it when Important limitation
document.fonts.ready Fonts currently used by the rendered document, plus related layout completion The final page content is present and you want its typography settled Unused declared faces, and optional faces not selected in time, may remain unloaded
document.fonts.load(font, text) Faces matching the CSS specification and text supplied A particular family, weight, style, or character subset must be present The promise can reject; choose a representative CSS specification and text

These methods complement each other. A common pattern is to wait for the application’s final content, call document.fonts.ready, and then call document.fonts.load() for any additional face that must be guaranteed.

Make the content state deterministic first

Client-side routes and hydration

For a single-page application, wait for the route’s visible marker or a hydrated component before checking fonts. Navigation completion alone does not prove that data-dependent text has been inserted.

await page.goto('https://example.com/dashboard');
await page.waitForURL('**/dashboard');
await page.getByRole('heading', { name: 'Dashboard' }).waitFor();
await page.evaluate(() => document.fonts.ready);
await page.screenshot({ path: 'dashboard.png' });

Text that appears after an API response

Wait for the element whose content is populated by that response, not merely for the network request to start. Then perform the font wait. This ensures the browser evaluates readiness against the same text that will be captured.

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

Choosing a specific subset

For multilingual pages, include representative characters from every script that matters in the screenshot when calling load(). A Latin-only sample does not express the need for another character subset.

Rank #3
Sale
Dell 24 Monitor - SE2426H - 23.8-inch FHD (1920x1080) 144Hz 1ms Display, in-Plane Switching (IPS) Technology, AMD FreeSync™, TÜV 3-Star 2X HDMI, Tilt
  • Clear visuals. Fluid motion: A 144Hz refresh rate and 1ms MPRT deliver smooth, tear‑free motion across work, gaming, and streaming for clearer, more fluid viewing.
  • Eye comfort: TÜV Rheinland 3‑star* certification reduces harmful blue light while preserving stunning color quality without compromise. *TÜV Rheinland 3-star eye comfort certification.
  • Wide viewing angle: Get consistent views across a wide 178° /178° viewing angle.
  • In-Plane Switching (IPS): See excellent color accuracy and consistency across wide viewing angles with In-plane Switching (IPS) technology.
  • Ultra-thin bezels: Maximize your viewing experience with thin bezels.

Stabilize screenshots beyond fonts

Disable animation when motion affects pixels

Font readiness and animation control solve different problems. Playwright’s screenshot option animations: 'disabled' stops CSS animations, transitions, and Web Animations for that screenshot operation.

await page.evaluate(() => document.fonts.ready);
await page.screenshot({
  path: 'stable.png',
  fullPage: true,
  animations: 'disabled'
});

Use both controls when both typography and motion can change the image. The option is described in the Playwright Page API.

Use screenshot assertions for visual comparison

expect(page).toHaveScreenshot() waits until two consecutive screenshots match before comparing the final image. That stability check is useful for visual tests, but it is not a replacement for an explicit font wait when the expected face matters.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
await page.evaluate(() => document.fonts.ready);
await expect(page).toHaveScreenshot('dashboard.png', {
  animations: 'disabled'
});

See the behavior and options in the Playwright PageAssertions reference.

Rank #4
Samsung 27" Essential S3 (S36GD) Series FHD 1800R Curved Computer Monitor
  • CURVED FOR ENHANCED ENGAGEMENT: An immersive viewing experience with a curved monitor that wraps more closely around your field of vision; It creates a wider view, enhancing depth perception and minimizing peripheral distraction
  • SMOOTH PERFORMANCE FOR SEAMLESS CONTENT: Stay in the action when playing games, watching videos, or working on creative projects; The 100Hz refresh rate reduces lag and motion blur so you don't miss a thing in fast-paced moments¹
  • MORE GAMING POWER: Gain the edge with optimizable game settings; Color and image contrast can be adjusted to see scenes more vividly and spot enemies hiding in the dark; Game Mode adjusts any game to fill the screen so you can view every detail²
  • KEEP IT EASY ON THE EYES: Care for your eyes and stay comfortable, even during long sessions; Advanced eye comfort technology certified by TÜV reduces eye strain by minimizing blue light and reducing irritating screen flicker²
  • INCREASED VERSATILITY: Connect to more; Plug devices straight into your monitor for increased flexibility, making your computing environment even more convenient

Common failures and fixes

The screenshot still shows a fallback font

  • Cause: The page added or replaced text after the readiness check.
  • Fix: Move the check after the final route, hydration, or data-driven selector, then await document.fonts.ready again.

A required face never appears

  • Cause: The face is declared but not used by the captured text, so ready has no reason to load it.
  • Fix: Call document.fonts.load() with the exact CSS font specification and representative text, and fail the test if that promise rejects.

The explicit load resolves, but the visual result is wrong

  • Cause: The CSS specification does not match the needed family, weight, style, or stretch, or the sample text does not cover the required subset.
  • Fix: Match the declaration used by the element (for example, the correct weight) and include characters that will actually be captured.

Visual assertions remain flaky

  • Cause: Animation or another dynamic page state is changing pixels independently of fonts.
  • Fix: Wait for the application state, await font readiness, disable animations for the capture, and then let toHaveScreenshot() perform its consecutive-image stability check.

Navigation waits too long or times out

  • Cause: The selector chosen as the application-ready signal never appears, or the page failed before rendering it.
  • Fix: Verify the selector in a headed run, choose a marker that is guaranteed for the target route, and diagnose page-load errors separately from font timing. Do not replace a missing state signal with an arbitrary sleep.

Performance and reliability guidance

  • Prefer a state-based wait over a fixed delay. It finishes as soon as the intended content and its used fonts are ready.
  • Keep the font wait in the page context with page.evaluate(); that is where document.fonts exists.
  • Use load() selectively. Requesting only faces and text needed by the screenshot avoids turning unrelated, unused declarations into a prerequisite.
  • Keep the order consistent in CI: final content state, font readiness, animation policy, then screenshot or assertion.
  • Record a rejected explicit font load as a test failure. A fallback image can otherwise look valid while representing the wrong typography.

Actual consistency can still depend on application rendering and other dynamic content. The official references describe the browser and Playwright mechanisms, not a guarantee that every page will become visually identical under every environment.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or skip the browser setup

ScreenshotNeo is a website screenshot API and MCP server. Its capture pipeline accepts cookie and consent banners as a visitor, removes more than 60 known consent platforms plus newsletter popups and chat widgets, and lets you turn each cleanup step off. Only clean shots are billed: bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits cost nothing, and response headers report the page verdict and whether it was billed.

For a one-call capture, see the ScreenshotNeo API documentation:

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.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

Python:

import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"}, timeout=90)
open("shot.webp", "wb").write(r.content)

Node.js:

const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);

ScreenshotNeo also offers an MCP server with take_screenshot, get_page_info, and capture_pdf for Claude, Cursor, and other MCP clients. Its API includes waits for selectors, delays, and network idle, along with full-page capture, element selection, device presets, custom CSS and JavaScript, headers and cookies, caching with a chosen TTL, signed links, asynchronous jobs, webhooks, bulk capture for up to 100 URLs per call, and PDF output.

The Free plan includes 1,000 shots per month with no card. Paid plans start at $5 for 3,000 shots; yearly billing gives two months free, and every feature is available on every plan. Create a free ScreenshotNeo account.

Best Value
Sale
Sceptre New 22-Inch Gaming Monitor, FHD 1080p, Up to 144Hz, HDMI, DisplayPort, Built-in Speakers, Machine Black (E225W-FW144 Series, 2026)
  • 【INTEGRATED SPEAKERS】Whether you're at work or in the midst of an intense gaming session, our built-in speakers provide rich and seamless audio, all while keeping your desk clutter-free.
  • 【EASY ON THE EYES】 Protect your eyes and enhance your comfort with Blue-Light Shift technology. This feature reduces harmful blue light emissions from your screen, helping to alleviate eye strain during long hours of use and promoting healthier viewing habits.
  • 【WIDEN YOUR PERSPECTIVE】Our sleek minimal bezel design ensures undivided attention. The nearly bezel-free display seamlessly connects in a dual monitor arrangement, delivering an unobstructed view that lets you focus on more at once, completely distraction-free.

FAQ

Does FontFaceSet.load() return the font itself?

It fulfills with the loaded FontFace objects that match the requested CSS specification and text. You normally do not need to inspect those objects for a screenshot; awaiting the promise is the readiness gate.

Should a screenshot assertion replace document.fonts.ready?

No. The assertion’s consecutive-capture check addresses pixel stability, while the font promise addresses font loading and related layout. When typography is part of the expected image, use both.

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

Frequently Asked Questions

Does FontFaceSet.load() return the font itself?

It fulfills with the loaded FontFace objects matching the requested CSS specification and text; for screenshots, simply awaiting the promise is usually sufficient.

Should a screenshot assertion replace document.fonts.ready?

No. The assertion checks consecutive-image stability, while document.fonts.ready handles font loading and layout readiness. Use both when typography matters.

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.