Question 1

How do I use Pageres to take a screenshot after logging into a website?

Accepted Answer

Use the username and password options for basic HTTP auth, or set cookies and custom headers for session-based logins. The beforeScreenshot function can also handle complex authentication flows by interacting with the page via Puppeteer.

Question 2

Pageres vs Puppeteer directly: which is better for screenshots?

Accepted Answer

Pageres abstracts Puppeteer with a higher-level API optimized for multi-resolution captures and batch processing, saving development time. For fine-grained control over browser instances, raw Puppeteer might be preferable.

Question 3

Can Pageres capture screenshots of localhost or development servers?

Accepted Answer

Yes, provide the local URL or file path as the source. Ensure the server is running and accessible, and use delays if needed to wait for page loads, as supported by the delay option.

Question 4

How to handle dynamic content that loads after page render with Pageres?

Accepted Answer

Use the delay option to wait a specified number of seconds, or employ the beforeScreenshot function to run custom JavaScript that ensures content is fully loaded before capturing.

Question 5

Does Pageres work with Docker or CI/CD pipelines?

Accepted Answer

Yes, but it requires proper Puppeteer sandbox configuration in Docker images. The README links to Puppeteer's troubleshooting guide for Linux, which is critical for CI/CD setups to avoid sandbox errors.

Question 6

What image formats does Pageres support?

Accepted Answer

It supports PNG and JPG formats via the format option, with PNG as the default. However, it doesn't support newer formats like WebP or vector outputs like PDF, limiting some use cases.

pageres

What is pageres?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions