大网数据广告活动
Web 标准与前端开发

`script.disown` command

· 52CE 我爱测

The `script.disown` command of the `script` module releases the specified handles returned by the `script.evaluate` and `script.callFunction` commands or received in `script.message` events.

The script.disown command of the script module releases the specified handles returned by the script.evaluate and script.callFunction commands or received in script.message events.

Syntax

/* With required parameters */
{
  "method": "script.disown",
  "params": {
    "handles": ["f1e2d3c4-b5a6-4978-8b9c-0d1e2f3a4b5c"],
    "target": {
      "realm": "7c37f4c0-abcd-1234-ef56-789012345678"
    }
  }
}

/* With required and optional parameters */
{
  "method": "script.disown",
  "params": {
    "handles": ["f1e2d3c4-b5a6-4978-8b9c-0d1e2f3a4b5c"],
    "target": {
      "context": "93ee5bd6-d256-4608-a002-9a8995cc0e5f",
      "sandbox": "myAutomationSandbox"
    }
  }
}

Parameters

The params field contains:

  • handles
    • : An array of strings that specifies the handles to release. Any specified handle not found in the target realm is ignored. Handles are returned in a handle field when a command such as script.evaluate is sent with resultOwnership set to root.
  • target
    • : An object that specifies the realm that owns the specified handles. The object must contain either a context field or a realm field:
      • context
        • : A string that contains the ID of the context whose active document provides the realm that owns the handles. Context IDs are returned by commands such as browsingContext.getTree.
      • realm
        • : A string that contains the ID of the realm that owns the handles. Realm IDs are returned by the script.getRealms command.
      • sandbox
        • : A string that contains the name of the sandbox realm that owns the handles. For a non-empty name, the browser creates a sandbox realm with that name in the specified context if one doesn't already exist. For an empty name (""), handles are released from the realm of the active document instead. This field is available only when the target object contains a context field.

Return value

The result field in the response is an empty object ({}).

Errors

  • invalid argument
    • : Thrown if a required parameter is missing or has an invalid type.
  • no such frame
    • : Thrown in any of the following cases:
      • No context with the specified context ID is found.
      • No realm with the specified realm ID is found.

Description

A handle is a string identifier you can use to refer to an object in subsequent script module commands, for example, to pass the object as an argument to script.callFunction. You can use it only in the realm in which it was created. After a handle is released, you can no longer use it in other script commands. The object isn't necessarily garbage collected. Other handles or references from the page's own scripts can keep the object alive.

The browser automatically releases handles when their realm is destroyed (see the script.realmDestroyed event). You can use script.disown to release handles you no longer need before the realm is destroyed.

Examples

Releasing a handle using a context ID

Assume you have a WebDriver BiDi connection and an active session. You get an open tab's context ID by using browsingContext.getTree.

Suppose the tab's page contains a button, and you evaluate the expression document.querySelector('button') by using script.evaluate. In that command, you pass the context ID in the target parameter and set the resultOwnership parameter to root. The expression returns the button element, a DOM node that supports a handle. With resultOwnership set to root, the browser includes a handle for that element in the response.

When you no longer need the handle for this element, send the following message to release it. Use the tab's context ID and the returned handle, without navigating or reloading the page between the two commands:

{
  "id": 5,
  "method": "script.disown",
  "params": {
    "handles": ["f1e2d3c4-b5a6-4978-8b9c-0d1e2f3a4b5c"],
    "target": {
      "context": "93ee5bd6-d256-4608-a002-9a8995cc0e5f"
    }
  }
}

The browser responds with an empty result object:

{
  "id": 5,
  "type": "success",
  "result": {}
}

Releasing multiple handles using a realm ID

Using the same connection and session as in the first example, suppose you have two handles for objects in the same realm. Send the following message to release both handles, using the ID of that realm in target:

{
  "id": 6,
  "method": "script.disown",
  "params": {
    "handles": [
      "a9b8c7d6-e5f4-4321-9a8b-7c6d5e4f3a2b",
      "b2c3d4e5-f6a7-4b89-9c0d-1e2f3a4b5c6d"
    ],
    "target": {
      "realm": "7c37f4c0-abcd-1234-ef56-789012345678"
    }
  }
}

The browser responds with an empty result object:

{
  "id": 6,
  "type": "success",
  "result": {}
}

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。