Halloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowHalloween DealsAmazon USOctober picks are moving - compare before checkoutAmazon US: current deals, useful picks and tech finds.See Picks×
FREEDOM251

Freedom251 › Blog › browser automation

How to Dispose of a Puppeteer Connection

By Freedom251 Team · · 3 min read

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Use await browser.disconnect() to detach Puppeteer while leaving the browser running; use await browser.close() to shut down the browser and its pages. To clean up just one isolated browser context, call await context.close().

Choose cleanup by what should remain open

What you want to clean up Call What happens
Only Puppeteer’s connection await browser.disconnect() Puppeteer disconnects; the browser process and its pages remain running. Puppeteer Browser.disconnect() (API reference labeled version 25.10.0).
The browser Puppeteer launched await browser.close() The browser and all associated pages close. Puppeteer Browser.close() (API reference labeled version 25.10.0).
One separate, non-default browser context await context.close() That context and its pages close; other contexts and the browser remain available. The default browser context cannot be closed with this method. Puppeteer BrowserContext.close() (API reference labeled version 25.9.0).

For the usual meaning of “dispose of a Puppeteer connection,” choose disconnect() if Chrome or another browser must keep running, and close() if the browser session is finished. Puppeteer’s browser management guide likewise distinguishes disconnecting from closing: disconnecting does not shut down the browser or close its pages. The guide is labeled Next, so check the documentation for your installed Puppeteer version if behavior or availability is version-sensitive. Puppeteer browser management

As an Amazon Associate I earn from qualifying purchases.

Disconnect and reconnect later

Save the browser’s WebSocket endpoint before disconnecting. A later Puppeteer client can connect to that endpoint and close the browser when its work is complete:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
const browser = await puppeteer.launch();
const browserWSEndpoint = browser.wsEndpoint();

await browser.disconnect();

const browser2 = await puppeteer.connect({browserWSEndpoint});
await browser2.close();

This is the lifecycle shown in Puppeteer’s Browser API example: it demonstrates that another connection can be made after detaching. Reconnecting is not a prerequisite for closing the browser; use it when a later client needs to take over or shut it down. Puppeteer Browser API

#1 Best Overall
Melissa & Doug Chef Puppet (Al Dente) with Detachable Wooden Rod Pretend Play Chef Puppet Pepe
  • Beautifully crafted 15-inch hand-and-rod chef puppet
  • Removable clothing includes traditional chef’s coat, scarf, floppy hat
  • Use one hand to manipulate the puppet's mouth and facial expressions, and the other to gesture with the removable wooden arm rod; rod attaches to either of the puppet’s hands, and is suitable for lefty or righty puppeteers
  • Puppet play is a wonderful way to make connections, explore feelings and new perspectives, help build vocabulary, dexterity, imagination, and creativity

Close a context without closing the browser

Use a separate browser context when a task needs isolated pages and you want to discard that task’s context afterward. Close it when the work is done:

const context = await browser.createBrowserContext();
const page = await context.newPage();

// ... use the page ...

await context.close();

Closing the context also closes its pages. Do not call this as a way to close Puppeteer’s default context; Puppeteer documents that the default context cannot be closed through BrowserContext.close(). BrowserContext.close()

Rank #2
HABA Hand Puppet - Eat it Up Croco Interactive Puppet Show Toy with Belly Bag for Storytelling, Toddler Activities, Speech Therapy Toys and Pretend Play for 18 Months and up
  • INTERACTIVE PUPPET FOR KIDS: Croco the hand puppet makes storytelling fun with a belly bag to "eat" small objects and moveable eyes, sparking pretend play and endless puppet show adventures.
  • EDUCATIONAL & FUN TOOL: Perfect for teachers and parents, this soft puppet for kids makes learning letters, numbers, and words exciting. Great for toddler activities and interactive pretend play.
  • EASY-TO-USE PUPPET: Slip your hand inside to move Croco’s mouth & eyes. This engaging puppet for toddlers 1-3 is perfect for puppet theater or adding to any pretend play toys collection for 18 mo+.
  • DURABLE & SAFE MATERIALS: Made of high-quality polyester, this hand puppet is 15.75" tall and machine washable, ensuring long-lasting fun for toddler pretend play and kids playset storytelling.
  • PERFECT GIFT FOR KIDS:This engaging puppet for kids is a great gift for birthdays and holidays. Ideal for toddler toys, kids toys, and pretend play, encouraging creativity and role-playing.

Use the lifecycle method, not the lower-level connection API

Puppeteer’s Connection.dispose() reference describes a synchronous void method, but does not establish it as the normal application-level cleanup call. For ordinary application cleanup, use the Browser or BrowserContext method that matches the resource you intend to close. The Connection reference is labeled version 25.3.0. Puppeteer Connection.dispose()

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Troubleshoot cleanup that seems to do the wrong thing

  • The browser keeps running after cleanup: that is the expected result of browser.disconnect(). If the browser should stop, call await browser.close() instead.
  • Pages remain open after disconnecting: also expected. Disconnect removes Puppeteer’s connection; it does not close pages. Use browser.close() to close the browser and associated pages.
  • Closing a context fails or is not appropriate: confirm that it is a separately created context, not the default browser context. Close a non-default context with await context.close(); use browser.close() if the entire browser should shut down.
  • You are considering Connection.dispose(): its reference only establishes a synchronous low-level API, not an application cleanup pattern. Prefer the documented browser lifecycle methods above.

Or skip the browser setup

If your goal is a website screenshot rather than managing a browser process, ScreenshotNeo provides a screenshot API and MCP server. One GET request can return an image or PDF; the call below follows its API documentation:

Rank #3
GUND Sesame Street Elmo 11-Inch Plush Hand Puppet for Ages 1+
  • SESAME STREET ELMO HAND PUPPET: This 11” hand puppet features the classic Muppet with soft, slightly shaggy bright red plush, Elmo’s large eyes, and his excited, friendly expression. Designed to fit children and most adult hands.
  • SOFT & HUGGABLE: This adorable Sesame Street plush hand puppet toy features surface-washable construction for easy cleaning and is made from a soft, premium material that meets our famous GUND quality standards. Appropriate for ages 1 and up
  • GIFT GUND: Our stuffed animals, teddy bears, and sensory toys make timeless birthday and baby shower gifts, home decor, and gifts for every other occasion. Our official Sesame Street plushies are crafted for kids, fans and collectors of all ages
  • Quality Cuddles: Our plush toys feature timeless designs and durable fabrics that stay soft for years. From cute stuff like baby toys, decor, and playsets to anime merch and more, GUND toys are made to be collected, loved, and cuddled for a lifetime
  • Premier Plush: As one of America’s first teddy bear makers, GUND has crafted unique and classic stuffed animals and soft toys for 125 years. Today we proudly carry this legacy and stand by our toys, known worldwide for their quality and innovation
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

ScreenshotNeo removes cookie banners, newsletter popups and chat widgets before capture; bot checks, blank pages and failed loads are not billed. Its MCP server lets AI agents take screenshots. The free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000. Sign up for 1,000 free screenshots a month—no card required.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Frequently Asked Questions

Does disconnecting Puppeteer close Chrome?

No. browser.disconnect() detaches Puppeteer while leaving the browser process running.

Can I close only one Puppeteer page?

This article’s documented context cleanup closes a non-default context and all its pages. For page-level cleanup, consult the API documentation for the Puppeteer version in your project.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Quick Recap

Bestseller No. 1
Melissa & Doug Chef Puppet (Al Dente) with Detachable Wooden Rod Pretend Play Chef Puppet Pepe
Melissa & Doug Chef Puppet (Al Dente) with Detachable Wooden Rod Pretend Play Chef Puppet Pepe
Beautifully crafted 15-inch hand-and-rod chef puppet; Removable clothing includes traditional chef’s coat, scarf, floppy hat
$30.99
Bestseller No. 3
GUND Sesame Street Elmo 11-Inch Plush Hand Puppet for Ages 1+
GUND Sesame Street Elmo 11-Inch Plush Hand Puppet for Ages 1+
Includes: 1 GUND Sesame Street Hand Puppet, Poly Bag
$22.99
SaleBestseller No. 4
Aurora® Interactive Hand Puppet Garth™ Stuffed Animal - Storytelling Adventures - Playful Learning - Brown 10 Inches
Aurora® Interactive Hand Puppet Garth™ Stuffed Animal - Storytelling Adventures - Playful Learning - Brown 10 Inches
This plush is approx. 6.5" x 6.5" x 9" in size; Made from the finest quality of material for lasting love
$9.99
Bestseller No. 5
HollyHOME Shark Hand Puppets Stuffed Ocean Animals Hand Puppet Plush Animal Toys 13 Inches
HollyHOME Shark Hand Puppets Stuffed Ocean Animals Hand Puppet Plush Animal Toys 13 Inches
Access into both front flippers and mouth for easy manipulation; Made from premium soft fabric with embroidered eyes for added safety
$13.99
Best Value
HollyHOME Shark Hand Puppets Stuffed Ocean Animals Hand Puppet Plush Animal Toys 13 Inches
  • Access into both front flippers and mouth for easy manipulation
  • Made from premium soft fabric with embroidered eyes for added safety
  • 13 inches in height,fit for hands of both adults and kids
  • Great to improve motor skills, hand-eye coordination, communication skills, self-confidence, and social-emotional connections
  • Perfect gift for baby stage performance, storytelling, teaching, birthday party, family party and so on
Rank #4
Sale
Aurora® Interactive Hand Puppet Garth™ Stuffed Animal - Storytelling Adventures - Playful Learning - Brown 10 Inches
  • This plush is approx. 6.5" x 6.5" x 9" in size
  • Made from the finest quality of material for lasting love
  • A hand puppet toy that showcases this amazing dog, allowing you to control its mouth!
  • Lock-washer eyes ensure safety and long-term enjoyment
  • To ensure stability and quality, this plush contains bean pellets suitable for all ages

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

browser automationJavaScriptPuppeteerWeb development

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
Windows Errors? Fix Them Before They SpreadFree repair scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.