puppeteer/website/versioned_docs/version-19.4.0/api/puppeteer.pdfoptions.md
release-please[bot] 931d4fced5
chore: release main (#9322)
🤖 I have created a release *beep* *boop*
---


<details><summary>puppeteer: 19.4.0</summary>

##
[19.4.0](https://github.com/puppeteer/puppeteer/compare/puppeteer-v19.3.0...puppeteer-v19.4.0)
(2022-12-07)


### Features

* **chromium:** roll to Chromium 109.0.5412.0 (r1069273)
([#9364](https://github.com/puppeteer/puppeteer/issues/9364))
([1875da6](1875da6191)),
closes [#9233](https://github.com/puppeteer/puppeteer/issues/9233)


### Dependencies

* The following workspace dependencies were updated
  * dependencies
    * puppeteer-core bumped from 19.3.0 to 19.4.0
</details>

<details><summary>puppeteer-core: 19.4.0</summary>

##
[19.4.0](https://github.com/puppeteer/puppeteer/compare/puppeteer-core-v19.3.0...puppeteer-core-v19.4.0)
(2022-12-07)


### Features

* ability to send headers via ws connection to browser in node.js
environment
([#9314](https://github.com/puppeteer/puppeteer/issues/9314))
([937fffa](937fffaedc)),
closes [#7218](https://github.com/puppeteer/puppeteer/issues/7218)
* **chromium:** roll to Chromium 109.0.5412.0 (r1069273)
([#9364](https://github.com/puppeteer/puppeteer/issues/9364))
([1875da6](1875da6191)),
closes [#9233](https://github.com/puppeteer/puppeteer/issues/9233)
* **puppeteer-core:** keydown supports commands
([#9357](https://github.com/puppeteer/puppeteer/issues/9357))
([b7ebc5d](b7ebc5d9bb))


### Bug Fixes

* **puppeteer-core:** avoid type instantiation errors
([#9370](https://github.com/puppeteer/puppeteer/issues/9370))
([17f31a9](17f31a9ee4)),
closes [#9369](https://github.com/puppeteer/puppeteer/issues/9369)
</details>

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2022-12-07 19:35:29 +01:00

10 KiB

sidebar_label
PDFOptions

PDFOptions interface

Valid options to configure PDF generation via Page.pdf().

Signature:

export interface PDFOptions

Properties

Property Modifiers Type Description Default
displayHeaderFooter? boolean (Optional) Whether to show the header and footer. false
footerTemplate? string (Optional) HTML template for the print footer. Has the same constraints and support for special classes as PDFOptions.headerTemplate.
format? PaperFormat (Optional) letter.
headerTemplate? string

(Optional) HTML template for the print header. Should be valid HTML with the following classes used to inject values into them:

- date formatted print date

- title document title

- url document location

- pageNumber current page number

- totalPages total pages in the document

height? string | number (Optional) Sets the height of paper. You can pass in a number or a string with a unit.
landscape? boolean (Optional) Whether to print in landscape orientation. = false
margin? PDFMargin (Optional) Set the PDF margins. no margins are set.
omitBackground? boolean (Optional) Hides default white background and allows generating pdfs with transparency. false
pageRanges? string (Optional) Paper ranges to print, e.g. 1-5, 8, 11-13. The empty string, which means all pages are printed.
path? string (Optional) The path to save the file to. the empty string, which means the PDF will not be written to disk.
preferCSSPageSize? boolean (Optional) Give any CSS @page size declared in the page priority over what is declared in the width or height or format option. false, which will scale the content to fit the paper size.
printBackground? boolean (Optional) Set to true to print background graphics. false
scale? number (Optional) Scales the rendering of the web page. Amount must be between 0.1 and 2. 1
timeout? number (Optional) Timeout in milliseconds 30000
width? string | number (Optional) Sets the width of paper. You can pass in a number or a string with a unit.