Install

Using npm:

npm install browserless puppeteer --save

About

This is the core package of the browserless monorepo. It provides a high-level, performance-oriented API for headless Chrome/Chromium automation built on top of Puppeteer.

What this package does

The browserless package serves as the main entry point and orchestrator for the entire browserless ecosystem. It handles:

• Browser process management: Spawns and manages headless Chrome/Chromium processes with optimized flags for performance and stability. Includes automatic respawning when the browser disconnects.

• Browser context isolation: Creates isolated browser contexts (similar to browser tabs) with separate cookies and cache, enabling concurrent operations without cross-contamination.

• Built-in methods: Provides ready-to-use methods for common tasks:

  • html(url) – Serialize page content to HTML
  • text(url) – Extract plain text from a page
  • pdf(url) – Generate PDF documents
  • screenshot(url) – Capture screenshots with device emulation and overlay support

• Reliability features: Built-in retry logic, timeout handling, and graceful error recovery for production environments.

How it fits in the monorepo

This package integrates and re-exports functionality from other @browserless/* packages:

Dependency	Purpose
@browserless/goto	Page navigation with smart waiting strategies, ad blocking, and evasion techniques
@browserless/screenshot	Screenshot capture with overlays, device emulation, and code highlighting
@browserless/pdf	PDF generation with customizable margins and scaling
@browserless/errors	Standardized error handling and timeout errors

License

browserless © Microlink, released under the MIT License.
Authored and maintained by Microlink with help from contributors.

The logo has been designed by xinh studio.

microlink.io · GitHub microlinkhq · X @microlinkhq