From bcd806aa10d022e89b69525790464a26352951ca Mon Sep 17 00:00:00 2001
From: Alex Rudenko <OrKoN@users.noreply.github.com>
Date: Thu, 4 Apr 2024 09:20:32 +0200
Subject: [PATCH] docs: document more debugging tips (#12198)

---
 docs/guides/debugging.md | 30 +++++++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/docs/guides/debugging.md b/docs/guides/debugging.md
index 97880f22b74..85d44ec31cb 100644
--- a/docs/guides/debugging.md
+++ b/docs/guides/debugging.md
@@ -12,7 +12,7 @@ In general, there are two possible sources of an issue: Code running on Node.js
 (which we call _server code_), and
 [code running in the browser](../api/puppeteer.page.evaluate)
 (which we call _client code_). There is also a third possible source being the
-browser itself (which we call _internal code_), but if you suspect this is the
+browser itself (which we call _internal code_ or _browser code_), but if you suspect this is the
 source **after attempting the methods below**, we suggest
 [searching existing issues](https://github.com/puppeteer/puppeteer/issues)
 before
@@ -139,3 +139,31 @@ env DEBUG="puppeteer:*" env DEBUG_COLORS=true node script.js 2>&1 | grep -v '"Ne
 # Filter out all protocol messages but keep all other logging
 env DEBUG="puppeteer:*,-puppeteer:protocol:*" node script.js
 ```
+
+### Log pending protocol calls
+
+If you encounter issues with async Puppeteer calls not getting resolved, try logging
+pending callbacks by using the [`debugInfo`](https://pptr.dev/api/puppeteer.browser/#properties) interface
+to see what call is the cause:
+
+```ts
+console.log(browser.debugInfo.pendingProtocolErrors);
+```
+
+The getter returns a list of `Error` objects and the stacktraces of the error objects
+indicate which code triggered a protocol call.
+
+## Debugging methods for the browser code
+
+### Print browser logs
+
+If the browser unexpectedly crashes or does not launch properly, it could be useful
+to inspect logs from the browser process by setting the launch attribute `dumpio` to `true`.
+
+```ts
+const browser = await puppeteer.launch({
+  dumpio: true,
+});
+```
+
+In this case, Puppeteer forwards browser logs to the Node process' stdio.