Skip to content

Session Manager

SessionManager

Manages CDP target creation and session attachment.

Wraps Target domain commands for creating targets, attaching sessions, and closing targets via a single Connection.

Source code in cdpwave/session/manager.py 
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
class SessionManager:
    """Manages CDP target creation and session attachment.

    Wraps Target domain commands for creating targets, attaching sessions,
    and closing targets via a single Connection.
    """

    def __init__(self, connection: Connection) -> None:
        self._connection = connection

    async def create_target(
        self,
        url: str = "about:blank",
        browser_context_id: str | None = None,
    ) -> str:
        """Create a new browser target and return its target ID.

        Args:
            url: The initial URL for the new target.
            browser_context_id: Optional browser context ID for isolation.
        """
        params: dict[str, object] = {"url": url}
        if browser_context_id is not None:
            params["browserContextId"] = browser_context_id
        result = await self._connection.send_command(
            "Target.createTarget",
            params,
        )
        target_id = result.get("targetId")
        if target_id is None:
            raise KeyError(
                "Target.createTarget response missing 'targetId' field"
            )
        return str(target_id)

    async def attach_to_target(self, target_id: str) -> str:
        """Attach to a target and return the session ID."""
        result = await self._connection.send_command(
            "Target.attachToTarget",
            {"targetId": target_id, "flatten": True},
        )
        session_id = result.get("sessionId")
        if session_id is None:
            raise KeyError(
                "Target.attachToTarget response missing 'sessionId' field"
            )
        return str(session_id)

    async def detach_session(self, session_id: str) -> None:
        """Detach a session from its target."""
        await self._connection.send_command(
            "Target.detachFromTarget",
            {"sessionId": session_id},
        )

    async def close_target(self, target_id: str) -> None:
        """Close a browser target by target ID."""
        await self._connection.send_command(
            "Target.closeTarget",
            {"targetId": target_id},
        )

create_target async 

create_target(url: str = 'about:blank', browser_context_id: str | None = None) -> str

Create a new browser target and return its target ID.

Parameters:

Name Type Description Default
url str

The initial URL for the new target.

 'about:blank'
browser_context_id str | None

Optional browser context ID for isolation.

 None
Source code in cdpwave/session/manager.py 
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
async def create_target(
    self,
    url: str = "about:blank",
    browser_context_id: str | None = None,
) -> str:
    """Create a new browser target and return its target ID.

    Args:
        url: The initial URL for the new target.
        browser_context_id: Optional browser context ID for isolation.
    """
    params: dict[str, object] = {"url": url}
    if browser_context_id is not None:
        params["browserContextId"] = browser_context_id
    result = await self._connection.send_command(
        "Target.createTarget",
        params,
    )
    target_id = result.get("targetId")
    if target_id is None:
        raise KeyError(
            "Target.createTarget response missing 'targetId' field"
        )
    return str(target_id)

attach_to_target async 

attach_to_target(target_id: str) -> str

Attach to a target and return the session ID.

Source code in cdpwave/session/manager.py 
41
42
43
44
45
46
47
48
49
50
51
52
async def attach_to_target(self, target_id: str) -> str:
    """Attach to a target and return the session ID."""
    result = await self._connection.send_command(
        "Target.attachToTarget",
        {"targetId": target_id, "flatten": True},
    )
    session_id = result.get("sessionId")
    if session_id is None:
        raise KeyError(
            "Target.attachToTarget response missing 'sessionId' field"
        )
    return str(session_id)

detach_session async 

detach_session(session_id: str) -> None

Detach a session from its target.

Source code in cdpwave/session/manager.py 
54
55
56
57
58
59
async def detach_session(self, session_id: str) -> None:
    """Detach a session from its target."""
    await self._connection.send_command(
        "Target.detachFromTarget",
        {"sessionId": session_id},
    )

close_target async 

close_target(target_id: str) -> None

Close a browser target by target ID.

Source code in cdpwave/session/manager.py 
61
62
63
64
65
66
async def close_target(self, target_id: str) -> None:
    """Close a browser target by target ID."""
    await self._connection.send_command(
        "Target.closeTarget",
        {"targetId": target_id},
    )