Implementation:Puppeteer Puppeteer Browser NewPage

Knowledge Sources	Puppeteer Puppeteer API
Domains	Browser_Automation, Node_JS
Last Updated	2026-02-11 23:00 GMT

Overview

Concrete tool for creating new browser tabs (pages) within a Puppeteer Browser instance.

Description

The Browser.newPage() method creates a new Page in the browser's default browser context. The Page object returned is the primary interface for all page-level automation: navigation, DOM interaction, screenshot capture, PDF generation, and more.

This is an abstract method on the Browser base class, implemented by both the CDP backend (CdpBrowser) and the WebDriver BiDi backend (BidiBrowser).

Usage

Call this method after obtaining a Browser instance from puppeteer.launch() or puppeteer.connect(). Use it whenever you need a new tab to work with.

Code Reference

Source Location

• Repository: puppeteer
• File: packages/puppeteer-core/src/api/Browser.ts
• Lines: 441

Signature

abstract class Browser {
  abstract newPage(options?: CreatePageOptions): Promise<Page>;
}

Import

import puppeteer from 'puppeteer';
// Browser instance obtained via puppeteer.launch()
const browser = await puppeteer.launch();

I/O Contract

Inputs

Name	Type	Required	Description
options	CreatePageOptions	No	Optional page creation configuration

Outputs

Name	Type	Description
return	Promise<Page>	A new Page instance representing a browser tab

Usage Examples

Create a Single Page

const puppeteer = require('puppeteer');

const browser = await puppeteer.launch();
const page = await browser.newPage();
await page.goto('https://example.com');
// Work with the page...
await browser.close();

Create Multiple Pages

const browser = await puppeteer.launch();

// Create three pages for parallel work
const page1 = await browser.newPage();
const page2 = await browser.newPage();
const page3 = await browser.newPage();

await Promise.all([
  page1.goto('https://example.com/page1'),
  page2.goto('https://example.com/page2'),
  page3.goto('https://example.com/page3'),
]);

Related Pages

Implements Principle

• Principle:Puppeteer_Puppeteer_Page_Creation

Requires Environment

• Environment:Puppeteer_Puppeteer_Node_18_Runtime