Environment profiles
Generate a coherent environment through CDP, then save the returned profile token for another Context. Pages, frames and workers inherit that Context's environment. Generated and imported environments are immutable; change the environment by creating a new Context. Cookies and storage are independent.
For complete examples, follow the Context profile guide.
Environment JSON is a CDP import/export format, not a CLI configuration file or an arbitrary createContext override. Explicit manual imports validate against the installed baseline. Read the current Context profile contract for supported fields and coherence checks.
Profile fields
These groups describe exported observations. Managed Contexts lock environment mutation; the dynamic boundaries below apply to ordinary mutable CDP contexts.
| Group | Configures | Mutation boundary |
|---|---|---|
display, window | Screen, available area, DPR, orientation, outer size, viewport | Most geometry is dynamic; color depth is creation-only. |
identity | User agent, platform, Client Hints metadata | Dynamic; does not install another Chrome implementation. |
hardware | Reported CPU count, memory bucket, performance class | Creation-only observations, not physical allocation. |
locale | Languages, Accept-Language reduction, timezone, Intl locale | Languages are dynamic; timezone and Intl locale require a new Context. |
graphics, fonts | Reported adapter/capability and font baseline | Selected values are read-only or reject unsupported customization. |
preferences | Color scheme, reduced motion, DNT | Theme and motion are dynamic; DNT is creation-only. |
network | Connection observations and network recipe | Proxy is a separate Context option; WebRTC uses real ICE. |
permissions, capabilities | Initial permissions, quota, keyboard layout | Creation-only; unavailable physical backends remain unsupported. |
features | Restrictions on existing exposure flags | Can restrict captured features, not enable uncaptured ones. |
timing | Execution, navigation, and network scale factors | Creation-only; no arbitrary clock epoch injection. |