#DOM

This page documents the DOM CDP domain supported by Lynx DevTool.

#Overview

• Scope: instance
• CDP domain: DOM

#Standard Methods

• DOM.copyTo
• DOM.describeNode
• DOM.disable
• DOM.discardSearchResults
• DOM.enable
• DOM.focus
• DOM.getAttributes
• DOM.getBoxModel
• DOM.getDocument
• DOM.getNodeForLocation
• DOM.getOuterHTML
• DOM.getSearchResults
• DOM.markUndoableState
• DOM.moveTo
• DOM.performSearch
• DOM.pushNodesByBackendIdsToFrontend
• DOM.querySelector
• DOM.querySelectorAll
• DOM.removeNode
• DOM.requestChildNodes
• DOM.scrollIntoViewIfNeeded
• DOM.setAttributesAsText
• DOM.setInspectedNode
• DOM.setOuterHTML

#Lynx Extensions

#DOM.disableDomTree

Disables Lynx DOM tree capture and reloads the current page.

• Origin: lynx-extension
• Source: devtool/lynx_devtool/agent/domain_agent/inspector_dom_agent_ng.cc

#Parameters

#Returns

No return fields.

#Notes

• Dispatches through LynxDevToolMediator to InspectorTasmExecutor on the TASM thread.
• Sets the local Lynx environment flag kLynxEnableDomTree to false.
• Calls Page.reload with params.ignoreCache. Missing params or a missing ignoreCache field are treated as false.
• Returns an empty result object after scheduling the reload.
• If the mediator has no TASM task runner, the current handler does not send an explicit CDP response.

#Examples

Disable DOM tree capture and reload

Request:

{
  "id": 1,
  "method": "DOM.disableDomTree",
  "params": {
    "ignoreCache": false
  }
}

Response:

{
  "id": 1,
  "result": {}
}

#DOM.enableDomTree

Enables Lynx DOM tree capture and reloads the current page.

• Origin: lynx-extension
• Source: devtool/lynx_devtool/agent/domain_agent/inspector_dom_agent_ng.cc

#Parameters

#Returns

No return fields.

#Notes

• Dispatches through LynxDevToolMediator to InspectorTasmExecutor on the TASM thread.
• Sets the local Lynx environment flag kLynxEnableDomTree to true.
• Calls Page.reload with params.ignoreCache. Missing params or a missing ignoreCache field are treated as false.
• Returns an empty result object after scheduling the reload.
• If the mediator has no TASM task runner, the current handler does not send an explicit CDP response.

#Examples

Enable DOM tree capture and reload

Request:

{
  "id": 1,
  "method": "DOM.enableDomTree",
  "params": {
    "ignoreCache": true
  }
}

Response:

{
  "id": 1,
  "result": {}
}

#DOM.getDocumentWithBoxModel

Returns the Lynx DOM tree with per-node box model data when it can be computed.

• Origin: lynx-extension
• Source: devtool/lynx_devtool/agent/domain_agent/inspector_dom_agent_ng.cc

#Parameters

No parameters.

#Returns

#Notes

• Dispatches through LynxDevToolMediator to InspectorTasmExecutor on the TASM thread, then asks the platform for native box models before sending the response.
• The returned tree is built from the current element root and uses the same node fields as the standard DOM tree, with Lynx's box_model field added to each serializable node.
• Coordinates are adjusted relative to the root box model in LynxView screenshot mode and converted by LayoutsUnitPerPx.
• If the serialized root exceeds the native DOM compression threshold and compression succeeds, result.compress is true and result.root is a compressed base64 string.
• If a node cannot produce a valid box model, that node's box_model field is null.
• The native implementation does not read request params.
• If the mediator has no TASM task runner or the element root is unavailable, the current handler does not send an explicit CDP response.

#Examples

Read the DOM tree with box models

Request:

{
  "id": 1,
  "method": "DOM.getDocumentWithBoxModel"
}

Response:

{
  "id": 1,
  "result": {
    "compress": false,
    "root": {
      "nodeId": 1,
      "backendNodeId": 1,
      "nodeType": 1,
      "localName": "page",
      "nodeName": "page",
      "nodeValue": "",
      "attributes": [],
      "childNodeCount": 1,
      "box_model": {
        "width": 390,
        "height": 844,
        "content": [0, 0, 390, 0, 390, 844, 0, 844],
        "padding": [0, 0, 390, 0, 390, 844, 0, 844],
        "border": [0, 0, 390, 0, 390, 844, 0, 844],
        "margin": [0, 0, 390, 0, 390, 844, 0, 844]
      },
      "children": []
    }
  }
}

#DOM.getOriginalNodeIndex

Returns the Lynx source node index associated with a DevTool node id.

• Origin: lynx-extension
• Source: devtool/lynx_devtool/agent/domain_agent/inspector_dom_agent_ng.cc

#Parameters

#Returns

#Notes

• Dispatches through LynxDevToolMediator to InspectorTasmExecutor on the TASM thread.
• The handler resolves params.nodeId with the current inspector element map and returns Element::NodeIndex().
• The response result is an empty object when no element is found for params.nodeId.
• If the mediator has no TASM task runner, the current handler does not send an explicit CDP response.

#Examples

Resolve a DevTool node to its Lynx source index

Request:

{
  "id": 1,
  "method": "DOM.getOriginalNodeIndex",
  "params": {
    "nodeId": 42
  }
}

Response:

{
  "id": 1,
  "result": {
    "nodeIndex": 7
  }
}

#DOM.innerText

Returns raw text child values for a Lynx text node.

• Origin: lynx-extension
• Source: devtool/lynx_devtool/agent/domain_agent/inspector_dom_agent_ng.cc

#Parameters

#Returns

#Notes

• Dispatches through LynxDevToolMediator to InspectorTasmExecutor on the TASM thread.
• The handler only scans attached elements whose localName is text.
• For matching text elements, the handler walks direct raw-text children and reads their text attributes.
• The method does not concatenate text; callers receive one rawTextValues item per raw-text child that contributes text.
• If the mediator has no TASM task runner, the current handler does not send an explicit CDP response.

#Examples

Read raw text children

Request:

{
  "id": 1,
  "method": "DOM.innerText",
  "params": {
    "nodeId": 42
  }
}

Response:

{
  "id": 1,
  "result": {
    "nodeId": 42,
    "rawTextValues": [
      {
        "nodeId": 43,
        "text": "Hello Lynx"
      }
    ]
  }
}