[dipikabh]

Description

• Added pages for the following commands of the script module (with corresponding updates to the sidebar and script module landing page):

  • script.disown
  • script.addPreloadScript
  • script.removePreloadScript

• Added sections to the script module landing page to explain "preload scripts" and "channels" in the context of BiDi.

• Some minor consistency fixes in browsingContext.create and session.subscribe to move the ID lookup sentence to end of the field description

Spec links

• https://w3c.github.io/webdriver-bidi/#command-script-disown
• https://w3c.github.io/webdriver-bidi/#event-script-realmCreated
• https://w3c.github.io/webdriver-bidi/#event-script-realmDestroyed

Related issue

Doc issue: mdn/mdn#851

[github-actions]

Preview URLs (8 pages)

• /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext/create
• /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext/locateNodes
• /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/addPreloadScript
• /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/disown
• /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/evaluate
• /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/removePreloadScript
• /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script
• /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/session/subscribe

Flaws (20)

Note! 2 documents with no flaws that don't need to be listed. 🎉

Found an unexpected or unresolvable flaw? Please report it here.

URL: /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/browsingContext/locateNodes
Title: browsingContext.locateNodes command
Flaw count: 3

• broken_links:
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/callFunction doesn't resolve
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/callFunction doesn't resolve
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/callFunction doesn't resolve

---

URL: /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script
Title: script module
Flaw count: 3

• broken_links:
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/callFunction doesn't resolve
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/callFunction#target doesn't resolve
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/callFunction doesn't resolve

---

URL: /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/addPreloadScript
Title: script.addPreloadScript command
Flaw count: 7

• broken_links:
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/message doesn't resolve
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/message doesn't resolve
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/message#data doesn't resolve
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/callFunction#arguments doesn't resolve
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/message doesn't resolve
  • and 2 more flaws omitted

---

URL: /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/disown
Title: script.disown command
Flaw count: 4

• broken_links:
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/callFunction doesn't resolve
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/message doesn't resolve
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/callFunction doesn't resolve
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/callFunction doesn't resolve

---

URL: /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/evaluate
Title: script.evaluate command
Flaw count: 2

• broken_links:
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/callFunction#arguments doesn't resolve
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/callFunction doesn't resolve

---

URL: /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/removePreloadScript
Title: script.removePreloadScript command
Flaw count: 1

• broken_links:
  • Link /en-US/docs/Web/WebDriver/Reference/BiDi/Modules/script/callFunction doesn't resolve

(comment last updated: 2026-10-19 17:01:15)

[github-actions]

This pull request has merge conflicts that must be resolved before it can be merged.

[chrisdavidmills]

Hi, @dipikabh! This looks mostly good; I just have a few comments.

[chrisdavidmills]

It's not clear what you mean by "earlier script.evaluate command" - the script.evaluate command shown earlier doesn't seem to have a context ID.

[dipikabh]

Good catch! That piece of detail was missing. Added getting context ID to the scenario and adjusted existing prose:

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

Suppose you evaluate ({ count: 2 }) in the tab by using script.evaluate.
In that command, you pass the context ID in the target parameter and set the resultOwnership parameter to "root".
The browser returns a handle for the resulting object.

When you no longer need the handle, 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:

[chrisdavidmills]

Sounds good. The only thing I'd query further here is { count: 2 } — I'm not sure what that means. count is not mentioned anywhere in the script.evaluate page. Is this supposed to be the expression that script.evaluate is evaluating, in which case wouldn't something more obvious like document.title be better?

[dipikabh]

Yes, ({ count: 2 }) was supposed to be the expression to evaluate. It creates an object with a count property.

Getting a handle requires both these conditions to be satisfied: "resultOwnership": "root" and a returned value that supports a handle (strings don't support handles, so document.title wouldn’t provide one we need for this example.).

Taking your comment into consideration, I’ve replaced it with document.querySelector('button'), an expression that's already used on the script.evaluate page. I've also expanded the example prose to clarify that the returned element is a DOM node and that it supports a handle.

Update is in 63ee7f7.

[dipikabh]

Thanks for the review, Chris. This is ready for another look.

[chrisdavidmills]

Looks great, @dipikabh, nice work. I've added a few further counter-comments, but no new ones. I'll approve this so you can merge once you've looked them over.

[lutien]

Thanks! That looks good to me!

[dipikabh]

Thanks for reviewing, @lutien.

[dipikabh]

Thanks @chrisdavidmills for going over the fixes!