Struct Root 

pub struct Root { /* private fields */ }

Root object for sending the initialize message to the Playwright server

This is an internal object not exposed to end users. It exists solely to send the initialize message to the server during connection setup.

Protocol Flow

When initialize() is called:

1. Sends initialize message with sdkLanguage: "rust"
2. Server creates BrowserType objects (sends __create__ messages)
3. Server creates Playwright object (sends __create__ message)
4. Server responds with Playwright GUID: { "playwright": { "guid": "..." } }
5. All objects are now in the connection’s object registry

The Root object has an empty GUID ("") and is not registered in the object registry. It’s discarded after initialization completes.

Example

// Create root object with connection
let root = Root::new(connection.clone());

// Send initialize message to server
let response = root.initialize().await?;

// Verify Playwright GUID is returned
let playwright_guid = response["playwright"]["guid"]
    .as_str()
    .expect("Missing playwright.guid");
assert!(!playwright_guid.is_empty());
assert!(playwright_guid.contains("playwright"));

// Verify response contains BrowserType objects
assert!(response["playwright"].is_object());

See:

• Python: https://github.com/microsoft/playwright-python/blob/main/playwright/_impl/_connection.py
• Java: https://github.com/microsoft/playwright-java

Implementations

impl Root

pub fn new(connection: Arc<dyn ConnectionLike>) -> Self

Creates a new Root object

Arguments

• connection - The connection to the Playwright server

pub async fn initialize(&self) -> Result<Value>

Send the initialize message to the Playwright server

This is a synchronous request that blocks until the server responds. By the time the response arrives, all protocol objects (Playwright, BrowserType, etc.) will have been created and registered.

Returns

The server response containing the Playwright object GUID:

{
  "playwright": {
    "guid": "playwright"
  }
}

Errors

Returns error if:

• Message send fails
• Server returns protocol error
• Connection is closed

Trait Implementations

impl ChannelOwner for Root

fn guid(&self) -> &str

Returns the unique GUID for this object.

fn type_name(&self) -> &str

Returns the protocol type name (e.g., “Browser”, “Page”).

fn parent(&self) -> Option<Arc<dyn ChannelOwner>>

Returns the parent object, if any.

fn connection(&self) -> Arc<dyn ConnectionLike>

Returns the connection this object belongs to.

fn initializer(&self) -> &Value

Returns the raw initializer JSON from the server.

fn channel(&self) -> &Channel

Returns the channel for RPC communication.

fn dispose(&self, reason: DisposeReason)

Disposes this object and all its children.

fn adopt(&self, child: Arc<dyn ChannelOwner>)

Adopts a child object (moves from old parent to this parent).

fn add_child(&self, guid: Arc<str>, child: Arc<dyn ChannelOwner>)

Adds a child object to this parent’s registry.

fn remove_child(&self, guid: &str)

Removes a child object from this parent’s registry.

fn on_event(&self, method: &str, params: Value)

Handles a protocol event sent to this object.

fn was_collected(&self) -> bool

Returns true if this object was garbage collected.

fn as_any(&self) -> &dyn Any

Enables downcasting to concrete types.

impl Debug for Root

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.