Struct PlaywrightServer 

pub struct PlaywrightServer {
    pub process: Child,
}

Manages the Playwright server process lifecycle

The PlaywrightServer wraps a Node.js child process that runs the Playwright driver. It communicates with the server via stdio pipes using JSON-RPC protocol.

Example

let server = PlaywrightServer::launch().await?;
// Use the server...
server.shutdown().await?;

Fields

process: Child

The Playwright server child process

This is public to allow integration tests to access stdin/stdout pipes. In production code, you should use the Connection layer instead of accessing the process directly.

Implementations

impl PlaywrightServer

pub async fn launch() -> Result<Self>

Launch the Playwright server process

This will:

1. Check if the Playwright driver exists (download if needed)
2. Launch the server using node <driver>/cli.js run-driver
3. Set environment variable PW_LANG_NAME=rust

Errors

Returns Error::ServerNotFound if the driver cannot be located. Returns Error::LaunchFailed if the process fails to start.

See: https://playwright.dev/docs/api

pub async fn shutdown(self) -> Result<()>

Shut down the server gracefully

Sends a shutdown signal to the server and waits for it to exit.

Platform-Specific Behavior

Windows: Explicitly closes stdio pipes before killing the process to avoid hangs. On Windows, tokio uses a blocking threadpool for child process stdio, and failing to close pipes before terminating can cause the cleanup to hang indefinitely. Uses a timeout to prevent permanent hangs.

Unix: Uses standard process termination with graceful wait.

Errors

Returns an error if the shutdown fails or times out.

pub async fn kill(self) -> Result<()>

Force kill the server process

This should only be used if graceful shutdown fails.

Platform-Specific Behavior

Windows: Closes stdio pipes before killing to prevent hangs.

Unix: Standard force kill operation.

Errors

Returns an error if the kill operation fails.

Trait Implementations

impl Debug for PlaywrightServer

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

Formats the value using the given formatter.