#DOM

本页面介绍 Lynx DevTool 支持的 DOM CDP domain。

#概览

• 作用域：instance
• CDP domain：DOM

#标准方法

• 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 扩展

#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

#参数

#返回字段

无返回字段。

#备注

• 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.

#示例

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

#参数

#返回字段

无返回字段。

#备注

• 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.

#示例

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

#参数

无参数。

#返回字段

#备注

• 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.

#示例

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

#参数

#返回字段

#备注

• 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.

#示例

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.getOriginalNodeSourceInfo

返回与 DevTool 节点 ID 关联的源码信息。

• 来源类型：lynx-extension
• 源码：devtool/lynx_devtool/agent/domain_agent/inspector_dom_agent_ng.cc

#参数

#返回字段

#备注

• 通过 LynxDevToolMediator 分发至 TASM 线程上的 InspectorTasmExecutor。
• 运行时生成的包装节点可通过值为 wrapper 的 tag 字段识别。
• 未找到 params.nodeId 对应的元素时，响应的 result 为空对象。
• 如果 mediator 没有 TASM 任务执行器，当前处理函数不会发送显式的 CDP 响应。

#示例

读取元素节点的源码信息

请求：

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

响应：

{
  "id": 1,
  "result": {
    "nodeId": 42,
    "tag": "view",
    "nodeIndex": 7,
    "debugMetadataUrl": "https://example.com/main.debug-metadata.json",
    "lazyBundleUrl": null
  }
}

#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

#参数

#返回字段

#备注

• 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.

#示例

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"
      }
    ]
  }
}