Implementation:Puppeteer Puppeteer Browser Close

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

Overview

Concrete tool for closing a browser instance and terminating its process, provided by the puppeteer-core library.

Description

The Browser.close() method shuts down the browser and cleans up all associated resources. It closes every open page, destroys all browser contexts, terminates the child process, and disconnects the protocol transport. This is an abstract method implemented by both CDP and BiDi backends.

Usage

Call this method at the end of every automation script, preferably in a finally block to ensure cleanup even on error.

Code Reference

Source Location

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

Signature

abstract class Browser {
  abstract close(): Promise<void>;
}

Import

// Accessed through a Browser instance
const browser = await puppeteer.launch();
// ... do work ...
await browser.close();

I/O Contract

Inputs

Name	Type	Required	Description
(none)	—	—	No parameters required

Outputs

Name	Type	Description
return	Promise<void>	Resolves when the browser process has been terminated

Usage Examples

Basic Cleanup

const browser = await puppeteer.launch();
const page = await browser.newPage();
await page.goto('https://example.com');
await page.screenshot({path: 'example.png'});
await browser.close(); // Always close when done

Safe Cleanup With Try/Finally

const browser = await puppeteer.launch();
try {
  const page = await browser.newPage();
  await page.goto('https://example.com');
  // ... automation logic ...
} finally {
  await browser.close(); // Cleanup even on error
}

Related Pages

Implements Principle

• Principle:Puppeteer_Puppeteer_Browser_Lifecycle_Management

Requires Environment

• Environment:Puppeteer_Puppeteer_Node_18_Runtime