# nokap

> Capture screenshots and PDFs from web pages using headless Chrome via CDP.

## Docs

### API Reference

#### Core Functions
> The main screenshot and PDF capture API

- [webshot](https://posit-dev.github.io/nokap/reference/webshot.html): Take a screenshot or PDF of a web page
- [from_html](https://posit-dev.github.io/nokap/reference/from_html.html): Take a screenshot or PDF from an HTML string
- [close](https://posit-dev.github.io/nokap/reference/close.html): Explicitly close the module-level browser and CDP connection

#### Browser Management
> Chrome process lifecycle and discovery

- [Chrome](https://posit-dev.github.io/nokap/reference/Chrome.html): Manages a headless Chrome browser process
- [find_chrome](https://posit-dev.github.io/nokap/reference/find_chrome.html): Locate the Chrome or Chromium binary on the system

#### Session
> Low-level browser tab and navigation control

- [Session](https://posit-dev.github.io/nokap/reference/Session.html): A CDP session representing a single browser tab

#### Errors
> Exception hierarchy for error handling

- [NokapError](https://posit-dev.github.io/nokap/reference/NokapError.html): Base exception for all nokap errors
- [CDPError](https://posit-dev.github.io/nokap/reference/CDPError.html): Error returned by the Chrome DevTools Protocol
- [ChromeNotFoundError](https://posit-dev.github.io/nokap/reference/ChromeNotFoundError.html): Raised when Chrome/Chromium cannot be found on the system
- [ChromeStartError](https://posit-dev.github.io/nokap/reference/ChromeStartError.html): Raised when Chrome fails to start or report its DevTools URL
- [NavigationError](https://posit-dev.github.io/nokap/reference/NavigationError.html): Raised when page navigation fails
- [PageLoadTimeout](https://posit-dev.github.io/nokap/reference/PageLoadTimeout.html): Raised when a page does not finish loading within the timeout
- [SelectorError](https://posit-dev.github.io/nokap/reference/SelectorError.html): Raised when a CSS selector matches no elements

#### Types
> Type definitions for configuration

- [PaperSize](https://posit-dev.github.io/nokap/reference/PaperSize.html)