Skip to content

Commit 19de3ee

Browse files
mintlify[bot]juecd
andauthored
Add Troubleshooting section to Create a Browser page (#117)
* Update browsers/create-a-browser.mdx * Update browsers/create-a-browser.mdx * Update browsers/faq.mdx * Update browsers/create-a-browser.mdx * Update docs.json * Update browsers/faq.mdx * Update browsers/faq.mdx * Add unsupported sites --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: Catherine Jue <catherine.djue@gmail.com>
1 parent b7c2343 commit 19de3ee

File tree

3 files changed

+34
-8
lines changed

3 files changed

+34
-8
lines changed

browsers/create-a-browser.mdx

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -142,10 +142,4 @@ async with async_playwright() as playwright:
142142
await browser.close()
143143
await kernel.browsers.delete_by_id(kernel_browser.session_id)
144144
```
145-
</CodeGroup>
146-
147-
148-
## Connection notes
149-
- **CDP connections** are meant to be long-lived but may eventually close. Websocket connections typically can remain active for up to 1 hour, after which they may close automatically. Browser sessions themselves are unaffected—reconnect to the same `cdp_ws_url` to continue using the browser.
150-
- Browsers persist independently of CDP. Depending on your browser [persistence](/browsers/persistence) or [timeout](/browsers/termination#timeouts-for-non-persisted-browsers) configuration, it will continue running even if the CDP connection closes. You can reconnect to the same `cdp_ws_url` if you're unexpectedly disconnected.
151-
- We recommend implementing reconnect logic, as network interruptions or lifecycle events can cause CDP sessions to close. Detect disconnects and automatically re-establish a CDP connection when this occurs.
145+
</CodeGroup>

browsers/faq.mdx

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
title: "FAQ"
3+
description: "Frequently asked questions about Kernel browsers"
4+
---
5+
6+
## Browser spin-up time
7+
8+
Non-standard configuration can affect browser spin-up time. Settings like non-default [viewport sizing](/browsers/viewport), [extensions](/browsers/extensions), or [Profiles](/browsers/profiles) may increase the time it takes for a browser to become ready.
9+
10+
**Standard configuration** includes:
11+
- Headful and headless browsers
12+
- Stealth mode both enabled and disabled
13+
14+
If you're experiencing slower-than-expected browser creation times, review your configuration to identify any non-standard settings that may be contributing to the delay.
15+
16+
## Connection notes
17+
18+
- **CDP connections** are meant to be long-lived but may eventually close. Websocket connections typically can remain active for up to 1 hour, after which they may close automatically. Browser sessions themselves are unaffected—reconnect to the same `cdp_ws_url` to continue using the browser.
19+
- Browsers persist independently of CDP. Depending on your browser [persistence](/browsers/persistence) or [timeout](/browsers/termination#timeouts-for-non-persisted-browsers) configuration, it will continue running even if the CDP connection closes. You can reconnect to the same `cdp_ws_url` if you're unexpectedly disconnected.
20+
- We recommend implementing reconnect logic, as network interruptions or lifecycle events can cause CDP sessions to close. Detect disconnects and automatically re-establish a CDP connection when this occurs.
21+
22+
## Unsupported Websites
23+
24+
There are some websites that are not supported by Kernel browsers due to their restrictions around automation and associated bot detection. These include:
25+
26+
- LinkedIn
27+
- Facebook
28+
- Instagram
29+
- X (Twitter)
30+
- Amazon
31+
- Reddit

docs.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,8 @@
8484
"browsers/replays",
8585
"browsers/extensions",
8686
"browsers/computer-controls",
87-
"browsers/playwright-execution"
87+
"browsers/playwright-execution",
88+
"browsers/faq"
8889
]
8990
},
9091
{

0 commit comments

Comments
 (0)