Capture website screenshots
npm install pageres

Capture screenshots of websites in various resolutions. A good way to make sure your websites are responsive. It's speedy and generates 100 screenshots from 10 different websites in just over a minute. It can also be used to render SVG images.
See pageres-cli for the command-line tool.
``sh`
npm install pageres
Note to Linux users: If you get a "No usable sandbox!" error, you need to enable system sandboxing.
`js
import Pageres from 'pageres';
await new Pageres({delay: 2})
.source('https://github.com/sindresorhus/pageres', ['480x320', '1024x768'], {crop: true})
.source('https://sindresorhus.com', ['1280x1024', '1920x1080'])
.source('data:text/html,
console.log('Finished generating screenshots!');
`
#### options
Type: object
##### delay
Type: number (Seconds)\0
Default:
Delay capturing the screenshot.
Useful when the site does things after load that you want to capture.
##### timeout
Type: number (Seconds)\60
Default:
Number of seconds after which the request is aborted.
##### crop
Type: boolean\false
Default:
Crop to the set height.
##### css
Type: string
Apply custom CSS to the webpage. Specify some CSS or the path to a CSS file.
##### script
Type: string
Apply custom JavaScript to the webpage. Specify some JavaScript or the path to a file.
##### cookies
Type: Array
A string with the same format as a browser cookie or an object.
Tip: Go to the website you want a cookie for and copy-paste it from DevTools.
##### filename
Type: string\'<%= url %>-<%= size %><%= crop %>'
Default:
Define a customized filename using Lo-Dash templates.\
For example: <%= date %> - <%= url %>-<%= size %><%= crop %>.
Available variables:
- url: The URL in slugified form, eg. http://yeoman.io/blog/ becomes yeoman.io!blogsize
- : Specified size, eg. 1024x1000width
- : Width of the specified size, eg. 1024height
- : Height of the specified size, eg. 1000crop
- : Outputs -cropped when the crop option is truedate
- : The current date (YYYY-MM-DD), eg. 2015-05-18time
- : The current time (HH-mm-ss), eg. 21-15-11
##### incrementalName
Type: boolean\false
Default:
When a file exists, append an incremental number.
##### selector
Type: string
Capture a specific DOM element matching a CSS selector.
##### hide
Type: string[]
Hide an array of DOM elements matching CSS selectors.
##### clickElement
Type: string
Click the DOM element matching the given CSS selector.
##### username
Type: string
Username for authenticating with HTTP auth.
##### password
Type: string
Password for authenticating with HTTP auth.
##### scale
Type: number\1
Default:
Scale webpage n times.
##### format
Type: string\png
Default: \'png' | 'jpg'
Values:
Image format.
##### userAgent
Type: string
Custom user agent.
##### headers
Type: object
Custom HTTP request headers.
##### transparent
Type: boolean\false
Default:
Set background color to transparent instead of white if no background is set.
##### darkMode
Type: boolean\false
Default:
Emulate preference of dark color scheme.
##### launchOptions
Type: object\{}
Default:
Options passed to puppeteer.launch().
##### beforeScreenshot
Type: Function
The specified function is called right before the screenshot is captured, as well as before any bounding rectangle is calculated as part of options.element. It receives the Puppeteer Page instance as the first argument and the browser instance as the second argument. This gives you a lot of power to do custom stuff. The function can be async.
Note: Make sure to not call page.close() or browser.close().
`js
import Pageres from 'pageres';
await new Pageres({
delay: 2,
beforeScreenshot: async (page, browser) => {
await checkSomething();
await page.click('#activate-button');
await page.waitForSelector('.finished');
}
})
.source('https://github.com/sindresorhus/pageres', ['480x320', '1024x768'], {crop: true})
.destination('screenshots')
.run();
console.log('Finished generating screenshots!');
`
Add a page to screenshot.
#### url
Required\
Type: string
URL or local path to the website you want to screenshot. You can also use a data URI.
#### sizes
Required\
Type: string[]
Use a notation.
#### options
Type: object
Options set here will take precedence over the ones set in the constructor.
Capture a screenshot of rendered HTML.
#### html
Required\
Type: string
HTML string to render and screenshot.
#### sizes
Required\
Type: string[]
Use a notation.
#### options
Type: object
Options set here will take precedence over the ones set in the constructor.
Set the destination directory.
#### directory
Type: string
Run pageres.
Returns Promise
Check out grunt-pageres if you're using Grunt.
For Gulp and Broccoli, just use the API directly. No need for a wrapper plugin.
- Break Shot - Desktop app for capturing screenshots of responsive websites.
- capture-website - A different take on screenshotting websites