To capture an authenticated page with Puppeteer, establish the site’s session before navigating: set the correctly scoped cookies on a BrowserContext (or the browser’s default context), or use page.authenticate() if the site uses HTTP authentication. Then wait for an authenticated application state and call page.screenshot(). These methods solve different authentication problems; page.authenticate() is not a general-purpose web form login.
Choose the authentication method the site actually uses
| Method | Use it when | Important limitation |
|---|---|---|
| Set cookies | The application session is represented by cookies and you have valid cookie data. | Cookie scope and attributes must match the site; a session can expire or depend on other state. |
page.authenticate() |
The protected resource uses HTTP authentication. | Puppeteer enables request interception internally, which may affect performance. This does not submit an HTML login form or complete OAuth, MFA, or a custom identity-provider flow. |
Separate BrowserContext |
You need a distinct browser session for a test or capture. | Establish that context’s storage for each run; contexts isolate cookies and other storage such as local storage. |
Puppeteer’s current API references mark page-level cookie methods deprecated. For new code, use BrowserContext.setCookie() or Browser.setCookie().
As an Amazon Associate I earn from qualifying purchases.
Set cookies before navigating to the protected page
The following CommonJS example creates an isolated context, sets a session cookie, navigates to the target, waits for an element that should only appear to a signed-in user, and saves a full-page PNG. Replace the example domain, URL, cookie name and value, and ready selector with values for your application.
Do these 3 things before closing this tab:
1Clear out junk files and repair common Windows errors2Scan for outdated or missing drivers - takes under a minute3Repair Windows errors before they cause bigger problemsconst puppeteer = require('puppeteer');
(async () => {
const browser = await puppeteer.launch({ headless: true });
let context;
try {
context = await browser.createBrowserContext();
const page = await context.newPage();
await context.setCookie({
name: 'session',
value: process.env.SESSION_COOKIE,
domain: 'example.com',
path: '/',
httpOnly: true,
secure: true,
sameSite: 'Lax',
});
await page.goto('https://example.com/account', {
waitUntil: 'domcontentloaded',
});
// Choose a selector that signals the authenticated page is ready.
await page.waitForSelector('[data-testid="account-dashboard"]', {
timeout: 15000,
});
await page.screenshot({ path: 'account.png', fullPage: true });
} finally {
if (context) await context.close();
await browser.close();
}
})().catch((error) => {
console.error(error);
process.exitCode = 1;
});Install Puppeteer in the project with npm install puppeteer. The cookie object above is an example, not a universal session recipe: supply the attributes required by the site. Puppeteer’s cookie guide describes direct browser-storage manipulation, while the CookieData API documents available cookie fields.
#1 Best Overall
- Compatible with Nintendo Switch 2’s new GameChat mode
- Auto-Light Balance: RightLight boosts brightness by up to 50%, reducing shadows so you look your best—compared to previous-generation Logitech webcams (1)
- Privacy with a Slide: The integrated webcam cover makes it easy to get total, reliable privacy when you're not on a video call
- Built-In Mic: The built-in microphone lets others hear you clearly during video calls
- Easy Plug-And-Play: The Brio 101 works with most video calling platforms, including Microsoft Teams, Zoom and Google Meet—no hassle; it just works
Match cookie scope and attributes
Use the cookie data issued by the site or by a controlled test login. Check its name and value, domain or URL association as supported by the API, path, expiry, secure and HttpOnly flags, SameSite setting, and partition key if applicable. A cookie for a different host or path will not be sent to the target. Do not assume that a copied token alone recreates a working session.
Set cookies before the navigation that needs them. If you use browser.setCookie(...) instead, it applies to the browser’s default context; use the context method when you deliberately created an isolated context.
Use HTTP authentication when the server requests it
For HTTP authentication, configure credentials before navigating. This example waits for a page-specific ready element and captures the visible viewport:
Rank #2
- Compatible with Nintendo Switch 2’s new GameChat mode
- Crisp HD 720p/30 fps video calls with diagonal 55° field of view and auto light correction. Compatible with popular platforms including Skype and Zoom.
- The built-in noise-reducing mic makes sure your voice comes across clearly up to 1.5 meters away, even if you’re in busy surroundings.
- C270’s RightLight 2 feature adjusts to lighting conditions, producing brighter, contrasted images to help you look good in all your conference calls.
- The adjustable universal clip lets you attach the camera securely to your screen or laptop, or fold the clip and set the webcam on a shelf. You’re always ready for your next video call.
const puppeteer = require('puppeteer');
(async () => {
const browser = await puppeteer.launch({ headless: true });
try {
const page = await browser.newPage();
await page.authenticate({
username: process.env.HTTP_AUTH_USER,
password: process.env.HTTP_AUTH_PASSWORD,
});
await page.goto('https://example.com/private', {
waitUntil: 'domcontentloaded',
});
await page.waitForSelector('[data-testid="private-content"]', {
timeout: 15000,
});
await page.screenshot({ path: 'private.png' });
} finally {
await browser.close();
}
})().catch((error) => {
console.error(error);
process.exitCode = 1;
});Page.authenticate() is specifically for HTTP authentication. Puppeteer documents that it turns on request interception behind the scenes, which may affect performance. For an HTML sign-in page, follow the application’s real login flow or use an authorized test session and its supported cookie mechanism instead.
Wait for the right state, then choose the screenshot area
A successful navigation is not proof that authentication succeeded: the site may redirect to a sign-in page, show an error, or still be rendering the account view. Prefer a meaningful application-specific signal, such as an authenticated-only element. A fixed delay can be useful for known animation timing, but it is not a substitute for checking the expected state. Network idle alone does not guarantee that an application is authenticated or visually settled.
Puppeteer’s screenshots guide demonstrates navigation followed by capture. Page.screenshot() supports capture options including output path and type, full-page capture, clipping, and transparent-background behavior; see the Page.screenshot() API and ScreenshotOptions API.
Rank #3
- 【Full HD 1080P Webcam】Powered by a 1080p FHD two-MP CMOS, the NexiGo N60 Webcam produces exceptionally sharp and clear videos at resolutions up to 1920 x 1080 with 30fps. The 3.6mm glass lens provides a crisp image at fixed distances and is optimized between 19.6 inches to 13 feet, making it ideal for almost any indoor use.
- 【Wide Compatibility】Works with USB 2.0/3.0, no additional drivers required. Ready to use in approximately one minute or less on any compatible device. Compatible with Mac OS X 10.7 and higher / Windows 7, 8, 10 & 11 / Android 4.0 or higher / Linux 2.6.24 / Chrome OS 29.0.1547 / Ubuntu Version 10.04 or above. Not compatible with XBOX/PS4/PS5.
- 【Built-in Noise-Cancelling Microphone】The built-in noise-canceling microphone reduces ambient noise to enhance the sound quality of your video. Great for Zoom / Facetime / Video Calling / OBS / Twitch / Facebook / YouTube / Conferencing / Gaming / Streaming / Recording / Online School.
- 【USB Webcam with Privacy Protection Cover】The privacy cover blocks the lens when the webcam is not in use. It's perfect to help provide security and peace of mind to anyone, from individuals to large companies. 【Note:】Please contact our support for firmware update if you have noticed any audio delays.
- 【Wide Compatibility】Works with USB 2.0/3.0, no additional drivers required. Ready to use in approximately one minute or less on any compatible device. Compatible with Mac OS X 10.7 and higher / Windows 7, 10 & 11, Pro / Android 4.0 or higher / Linux 2.6.24 / Chrome OS 29.0.1547 / Ubuntu Version 10.04 or above. Not compatible with XBOX/PS4/PS5.
- Use the default screenshot for the current viewport.
- Use
{ fullPage: true }for the full document; the image can be much taller than the viewport. - Use
clipwhen you need a specific rectangular region. - Use
elementHandle.screenshot()when only one element is needed; Puppeteer scrolls the element into view if necessary. See ElementHandle.screenshot(). - Choose the output path and image type deliberately. If no path is given, the screenshot API returns image bytes rather than saving a file.
Keep sessions isolated and credentials out of logs
Use separate browser contexts when tests or captures need independent signed-in sessions. BrowserContexts isolate cookies and local storage, which helps prevent one run’s state from leaking into another. Create and populate the context for the session you intend to capture, then close it when finished. See the Page class reference for context-related API information.
Session cookies and authentication credentials can grant access to an account. Read them from a secret store or environment variables in automation, avoid printing them to logs, and do not commit real credentials or production session data in fixtures. Use test accounts and rotate or expire credentials according to your organization’s practices.
Troubleshooting Puppeteer authentication screenshots
The screenshot shows a login page
- Confirm that cookies were set before the protected navigation.
- Check that the cookie’s host/domain, path, secure flag, expiry, and SameSite attributes are appropriate for the target URL.
- Verify that the session is still valid and that the app does not require additional cookies or state.
- Wait for an authenticated-only element and fail the capture if it never appears, rather than saving a misleading screenshot.
Cookie API reports an invalid or unsupported value
Compare the object with the installed Puppeteer version’s CookieData reference. Use the current BrowserContext or Browser cookie API rather than deprecated page-level cookie methods. Cookie signatures can vary by installed version, so consult that version’s API reference if an option is rejected.
Rank #4
- 1080P Webcam with Cover for Video Calls - EMEET computer webcam provides design and Optimization for professional video streaming. Realistic 1920 x 1080p video, 5-layer anti-glare lens, providing smooth video. C960 computer camera delivers 1920x1080 video with fixed focus (11.8–118.1 inches), so as to provide a clearer image. C960 USB webcam has a cover and can be removed automatically to meet your needs for privacy. For optimal image performance, use the webcam in a well-lit environment.
- Built-in 2 Omnidirectional Mics - EMEET webcam with microphone for desktop features 2 built-in omnidirectional microphones, picking up your voice to create clear audio for communication. When installing the webcam, select EMEET C960 as the default microphone input device in your computer and video applications and select C960 as the default device in Zoom/Teams and ensure microphone permissions are enabled for proper use. Please note that C960 does not include built-in speakers.
- Automatic Light Adjustment - Automatic exposure adjustment is applied in EMEET HD webcam 1080p so that the streaming webcam can deliver stable image performance. EMEET C960 camera for computer also features color adjustment and exposure optimization to help you look your best. For optimal video quality, it is recommended to use the webcam in normal or well-lit environments and select suitable video settings in your application. Proper lighting helps achieve a clearer and more balanced image.
- Plug-and-Play & Upgraded USB Connectivity - New C960 webcam features both USB Type-A & A-to-C adapter connections for wider compatibility. For stable performance, connect the webcam directly to the computer's main USB port and ensure the device is recognized correctly. If a hub or docking station is used, please ensure it provides sufficient power and stable data transmission, as limited ports may affect performance. 90° wide-angle lens captures more participants without frequent adjustments.
- High Compatibility & Multi Application - C960 webcam for laptop is compatible with Windows 10/11, macOS 10.14+, and Android TV 7.0+. Not supported: Windows Hello, TVs, tablets, or game consoles. It works with Zoom, Teams, Facetime, Google Meet, YouTube and more. Please select C960 webcam as the default camera and microphone device in your application and ensure camera/microphone permissions are enabled, especially on macOS. (Tips: Incompatible with Windows Hello)
HTTP credentials do not sign in to the application
Check whether the server is actually using HTTP authentication. If it displays an HTML login form, a custom identity provider, OAuth, or an MFA challenge, page.authenticate() is the wrong mechanism; it supplies HTTP-auth credentials, not application form submissions.
The capture is blank, incomplete, or taken too early
- Wait for a selector that identifies the desired signed-in view.
- Check for redirects, browser-console errors, and application-level access-denied content.
- Use
fullPage: trueif content below the viewport is required, or an element screenshot if only one component matters. - Do not assume
networkidlemeans client-side rendering or visual transitions have finished; use the site’s actual ready condition.
Captures become slower after adding HTTP authentication
Puppeteer documents that page.authenticate() enables request interception internally and that this may affect performance. If the target uses cookie sessions rather than HTTP authentication, use the cookie flow instead. Avoid treating the two methods as interchangeable.
Free tools Windows power users keep installed
One-click scans. No signup required.
Or skip the browser setup
For a one-request capture, ScreenshotNeo accepts a URL and returns an image or PDF. The API can also use supplied cookies and other capture options; see the ScreenshotNeo documentation for request parameters and authentication details.
Best Value
- Compatible with Nintendo Switch 2’s new GameChat mode
- HD lighting adjustment and autofocus: The Logitech webcam automatically fine-tunes the lighting, producing bright, razor-sharp images even in low-light settings. This makes it a great webcam for streaming and an ideal web camera for laptop use
- Advanced capture software: Easily create and share video content with this Logitech camera that is suitable for use as a desktop computer camera or a monitor webcam
- Stereo audio with dual mics: Capture natural sound during calls and recorded videos with this 1080p webcam, great as a video conference camera or a computer webcam
- Full HD 1080p video calling and recording at 30 fps. You'll make a strong impression with this PC webcam that features crisp, clearly detailed, and vibrantly colored video
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://example.com/account -o shot.webpScreenshotNeo removes cookie/consent banners, newsletter popups, and chat widgets before capture; each cleanup step can be turned off. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, and responses identify the page verdict and billing status in headers. Its MCP server provides take_screenshot, get_page_info, and capture_pdf tools for AI agents and MCP clients. The Free plan includes 1,000 shots per month without a card; paid plans start at $5 for 3,000 shots.
Sign up for ScreenshotNeo’s free plan: 1,000 screenshots a month, no card required.
Frequently Asked Questions
Can I use a Puppeteer cookie from my browser profile?
Only if it is still valid and you can provide the cookie data with the correct scope and attributes; a copied value may not be sufficient to restore the site’s session.
Recommended Free Tools
Does Puppeteer screenshot return an image buffer?
Yes. When you omit the file path, the screenshot call returns image data; with a path, it writes the capture to that location.
Which Puppeteer version should I use for these examples?
The documentation snapshot includes version labels 25.12.0 on the screenshots guide and 25.11.0 on one cookie API page. Check your installed package’s API reference for version-specific signatures.
Quick Recap
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.
