Skip to content

Commit e736107

Browse files
committed
docs(pools): clarify profile updates do not propagate to idle pool browsers
1 parent a299a79 commit e736107

1 file changed

Lines changed: 6 additions & 0 deletions

File tree

browsers/pools/faq.mdx

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,12 @@ When a browser from a pool is set to be destroyed (by reaching its specified `ti
2424

2525
Yes, use `kernel.browserPools.update()`. By default, idle browsers are discarded and rebuilt with new configuration. Set `discard_all_idle: false` to only apply changes to newly created browsers.
2626

27+
### If I update a profile's contents, will my pool's idle browsers pick up the change?
28+
29+
No. Idle browsers in a pool are pre-loaded with the profile's contents at the time they were filled. Updating the profile (for example, re-saving auth state to the same `profile_id`) does not propagate to already-warmed browsers — only newly-filled browsers will use the updated profile.
30+
31+
To force the pool to pick up new profile contents, either call `kernel.browserPools.flush()` to destroy idle browsers (the pool refills automatically), or call `kernel.browserPools.update()` with `discard_all_idle: true`.
32+
2733
### Should I set `reuse: true` or `reuse: false` when releasing?
2834

2935
Use `reuse: true` (default) for efficiency. Only use `reuse: false` when you suspect browser state corruption or need a guaranteed clean browser session.

0 commit comments

Comments
 (0)