This extension provides screenshot functions that can render a web page and return a PNG image of the rendered page.

The extension uses Puppeteer, a headless Chrome browser, to render pages. The Puppeteer package is wonderful but quite heavy in size (~100MB).

Usage in Origami

Install this package in your Origami project:

$ npm install --save @weborigami/screenshot

You can convert HTML to a PNG screenshot in a .ori file:

{
  index.html = "Hello, world."
  index.png = package:@weborigami/screenshot/html(index.html)
}

Or you can load and capture screenshots of a publicly-visible URL:

{
  example.png = package:@weborigami/screenshot/url("https://example.com")
}

The screenshot functions accept an optional second options parameter in which you can specify:

• deviceScaleFactor: the device scale factor: 1 (the default) for a classic 96 DPI display. Set this to 2 for HiDPI/Retina displays; this will double both the height and width of the resulting screenshot.
• height: the height of the viewport in pixels.
• width: the width of the viewport in pixels.