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 Debug for Root

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

Formats the value using the given formatter.