puppeteer/docs/api/puppeteer.pdfoptions.md

396 lines
3.5 KiB
Markdown
Raw Normal View History

2022-07-05 13:41:43 +00:00
---
sidebar_label: PDFOptions
---
# PDFOptions interface
Valid options to configure PDF generation via [Page.pdf()](./puppeteer.page.pdf.md).
#### Signature:
2022-07-05 13:41:43 +00:00
```typescript
export interface PDFOptions
```
## Properties
<table><thead><tr><th>
Property
</th><th>
Modifiers
</th><th>
Type
</th><th>
Description
</th><th>
Default
</th></tr></thead>
<tbody><tr><td>
displayHeaderFooter
</td><td>
`optional`
</td><td>
boolean
</td><td>
Whether to show the header and footer.
</td><td>
`false`
</td></tr>
<tr><td>
footerTemplate
</td><td>
`optional`
</td><td>
string
</td><td>
HTML template for the print footer. Has the same constraints and support for special classes as [PDFOptions.headerTemplate](./puppeteer.pdfoptions.md).
</td><td>
</td></tr>
<tr><td>
format
</td><td>
`optional`
</td><td>
[PaperFormat](./puppeteer.paperformat.md)
</td><td>
</td><td>
`letter`.
</td></tr>
<tr><td>
headerTemplate
</td><td>
`optional`
</td><td>
string
</td><td>
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
</td><td>
</td></tr>
<tr><td>
height
</td><td>
`optional`
</td><td>
string \| number
</td><td>
Sets the height of paper. You can pass in a number or a string with a unit.
</td><td>
</td></tr>
<tr><td>
landscape
</td><td>
`optional`
</td><td>
boolean
</td><td>
Whether to print in landscape orientation.
</td><td>
`false`
</td></tr>
<tr><td>
margin
</td><td>
`optional`
</td><td>
[PDFMargin](./puppeteer.pdfmargin.md)
</td><td>
Set the PDF margins.
</td><td>
`undefined` no margins are set.
</td></tr>
<tr><td>
omitBackground
</td><td>
`optional`
</td><td>
boolean
</td><td>
Hides default white background and allows generating pdfs with transparency.
</td><td>
`false`
</td></tr>
<tr><td>
outline
</td><td>
`optional`
</td><td>
boolean
</td><td>
Generate document outline.
</td><td>
`false`
</td></tr>
<tr><td>
pageRanges
</td><td>
`optional`
</td><td>
string
</td><td>
Paper ranges to print, e.g. `1-5, 8, 11-13`.
</td><td>
The empty string, which means all pages are printed.
</td></tr>
<tr><td>
path
</td><td>
`optional`
</td><td>
string
</td><td>
The path to save the file to.
</td><td>
`undefined`, which means the PDF will not be written to disk.
</td></tr>
<tr><td>
preferCSSPageSize
</td><td>
`optional`
</td><td>
boolean
</td><td>
Give any CSS `@page` size declared in the page priority over what is declared in the `width` or `height` or `format` option.
</td><td>
`false`, which will scale the content to fit the paper size.
</td></tr>
<tr><td>
printBackground
</td><td>
`optional`
</td><td>
boolean
</td><td>
Set to `true` to print background graphics.
</td><td>
`false`
</td></tr>
<tr><td>
scale
</td><td>
`optional`
</td><td>
number
</td><td>
Scales the rendering of the web page. Amount must be between `0.1` and `2`.
</td><td>
`1`
</td></tr>
<tr><td>
tagged
</td><td>
`optional`
</td><td>
boolean
</td><td>
Generate tagged (accessible) PDF.
</td><td>
`true`
</td></tr>
<tr><td>
timeout
</td><td>
`optional`
</td><td>
number
</td><td>
Timeout in milliseconds. Pass `0` to disable timeout.
</td><td>
`30_000`
</td></tr>
<tr><td>
width
</td><td>
`optional`
</td><td>
string \| number
</td><td>
Sets the width of paper. You can pass in a number or a string with a unit.
</td><td>
</td></tr>
</tbody></table>