/* * Copyright (C) 2013 Apple Inc. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF * THE POSSIBILITY OF SUCH DAMAGE. */ WebInspector.DOMTree = class DOMTree extends WebInspector.Object { constructor(frame) { super(); this._frame = frame; this._rootDOMNode = null; this._requestIdentifier = 0; this._flowMap = {}; this._frame.addEventListener(WebInspector.Frame.Event.PageExecutionContextChanged, this._framePageExecutionContextChanged, this); WebInspector.domTreeManager.addEventListener(WebInspector.DOMTreeManager.Event.DocumentUpdated, this._documentUpdated, this); // Only add extra event listeners when not the main frame. Since DocumentUpdated is enough for the main frame. if (!this._frame.isMainFrame()) { WebInspector.domTreeManager.addEventListener(WebInspector.DOMTreeManager.Event.NodeRemoved, this._nodeRemoved, this); this._frame.addEventListener(WebInspector.Frame.Event.MainResourceDidChange, this._frameMainResourceDidChange, this); } WebInspector.domTreeManager.addEventListener(WebInspector.DOMTreeManager.Event.ContentFlowListWasUpdated, this._contentFlowListWasUpdated, this); WebInspector.domTreeManager.addEventListener(WebInspector.DOMTreeManager.Event.ContentFlowWasAdded, this._contentFlowWasAdded, this); WebInspector.domTreeManager.addEventListener(WebInspector.DOMTreeManager.Event.ContentFlowWasRemoved, this._contentFlowWasRemoved, this); } // Public get frame() { return this._frame; } get flowMap() { return this._flowMap; } get flowsCount() { return Object.keys(this._flowMap).length; } disconnect() { WebInspector.domTreeManager.removeEventListener(null, null, this); this._frame.removeEventListener(null, null, this); } invalidate() { // Set to null so it is fetched again next time requestRootDOMNode is called. this._rootDOMNode = null; // Clear the pending callbacks. It is the responsibility of the client to listen for // the RootDOMNodeInvalidated event and request the root DOM node again. this._pendingRootDOMNodeRequests = null; if (this._invalidateTimeoutIdentifier) return; function performInvalidate() { this._invalidateTimeoutIdentifier = undefined; this.dispatchEventToListeners(WebInspector.DOMTree.Event.RootDOMNodeInvalidated); } // Delay the invalidation on a timeout to coalesce multiple calls to invalidate. this._invalidateTimeoutIdentifier = setTimeout(performInvalidate.bind(this), 0); } requestRootDOMNode(callback) { console.assert(typeof callback === "function"); if (typeof callback !== "function") return; if (this._rootDOMNode) { callback(this._rootDOMNode); return; } if (!this._frame.isMainFrame() && !this._frame.pageExecutionContext) { this._rootDOMNodeRequestWaitingForExecutionContext = true; if (!this._pendingRootDOMNodeRequests) this._pendingRootDOMNodeRequests = []; this._pendingRootDOMNodeRequests.push(callback); return; } if (this._pendingRootDOMNodeRequests) { this._pendingRootDOMNodeRequests.push(callback); return; } this._pendingRootDOMNodeRequests = [callback]; this._requestRootDOMNode(); } requestContentFlowList() { this.requestRootDOMNode(function(rootNode) { // Let the backend know we are interested about the named flow events for this document. WebInspector.domTreeManager.getNamedFlowCollection(rootNode.id); }); } // Private _requestRootDOMNode() { console.assert(this._frame.isMainFrame() || this._frame.pageExecutionContext); console.assert(this._pendingRootDOMNodeRequests.length); // Bump the request identifier. This prevents pending callbacks for previous requests from completing. var requestIdentifier = ++this._requestIdentifier; function rootObjectAvailable(error, result) { // Check to see if we have been invalidated (if the callbacks were cleared). if (!this._pendingRootDOMNodeRequests || requestIdentifier !== this._requestIdentifier) return; if (error) { console.error(JSON.stringify(error)); this._rootDOMNode = null; dispatchCallbacks.call(this); return; } // Convert the RemoteObject to a DOMNode by asking the backend to push it to us. var remoteObject = WebInspector.RemoteObject.fromPayload(result); remoteObject.pushNodeToFrontend(rootDOMNodeAvailable.bind(this, remoteObject)); } function rootDOMNodeAvailable(remoteObject, nodeId) { remoteObject.release(); // Check to see if we have been invalidated (if the callbacks were cleared). if (!this._pendingRootDOMNodeRequests || requestIdentifier !== this._requestIdentifier) return; if (!nodeId) { this._rootDOMNode = null; dispatchCallbacks.call(this); return; } this._rootDOMNode = WebInspector.domTreeManager.nodeForId(nodeId); console.assert(this._rootDOMNode); if (!this._rootDOMNode) { dispatchCallbacks.call(this); return; } // Request the child nodes since the root node is often not shown in the UI, // and the child nodes will be needed immediately. this._rootDOMNode.getChildNodes(dispatchCallbacks.bind(this)); } function mainDocumentAvailable(document) { this._rootDOMNode = document; dispatchCallbacks.call(this); } function dispatchCallbacks() { // Check to see if we have been invalidated (if the callbacks were cleared). if (!this._pendingRootDOMNodeRequests || requestIdentifier !== this._requestIdentifier) return; for (var i = 0; i < this._pendingRootDOMNodeRequests.length; ++i) this._pendingRootDOMNodeRequests[i](this._rootDOMNode); this._pendingRootDOMNodeRequests = null; } // For the main frame we can use the more straight forward requestDocument function. For // child frames we need to do a more roundabout approach since the protocol does not include // a specific way to request a document given a frame identifier. The child frame approach // involves evaluating the JavaScript "document" and resolving that into a DOMNode. if (this._frame.isMainFrame()) WebInspector.domTreeManager.requestDocument(mainDocumentAvailable.bind(this)); else { var contextId = this._frame.pageExecutionContext.id; RuntimeAgent.evaluate.invoke({expression: appendWebInspectorSourceURL("document"), objectGroup: "", includeCommandLineAPI: false, doNotPauseOnExceptionsAndMuteConsole: true, contextId, returnByValue: false, generatePreview: false}, rootObjectAvailable.bind(this)); } } _nodeRemoved(event) { console.assert(!this._frame.isMainFrame()); if (event.data.node !== this._rootDOMNode) return; this.invalidate(); } _documentUpdated(event) { this.invalidate(); } _frameMainResourceDidChange(event) { console.assert(!this._frame.isMainFrame()); this.invalidate(); } _framePageExecutionContextChanged(event) { if (this._rootDOMNodeRequestWaitingForExecutionContext) { console.assert(this._frame.pageExecutionContext); console.assert(this._pendingRootDOMNodeRequests && this._pendingRootDOMNodeRequests.length); this._rootDOMNodeRequestWaitingForExecutionContext = false; this._requestRootDOMNode(); } } _isContentFlowInCurrentDocument(flow) { return this._rootDOMNode && this._rootDOMNode.id === flow.documentNodeIdentifier; } _contentFlowListWasUpdated(event) { if (!this._rootDOMNode || this._rootDOMNode.id !== event.data.documentNodeIdentifier) return; // Assume that all the flows have been removed. var deletedFlows = {}; for (var flowId in this._flowMap) deletedFlows[flowId] = this._flowMap[flowId]; var newFlows = []; var flows = event.data.flows; for (var i = 0; i < flows.length; ++i) { var flow = flows[i]; // All the flows received from WebKit are part of the same document. console.assert(this._isContentFlowInCurrentDocument(flow)); var flowId = flow.id; if (this._flowMap.hasOwnProperty(flowId)) { // Remove the flow name from the deleted list. console.assert(deletedFlows.hasOwnProperty(flowId)); delete deletedFlows[flowId]; } else { this._flowMap[flowId] = flow; newFlows.push(flow); } } for (var flowId in deletedFlows) { delete this._flowMap[flowId]; } // Send update events to listeners. for (var flowId in deletedFlows) this.dispatchEventToListeners(WebInspector.DOMTree.Event.ContentFlowWasRemoved, {flow: deletedFlows[flowId]}); for (var i = 0; i < newFlows.length; ++i) this.dispatchEventToListeners(WebInspector.DOMTree.Event.ContentFlowWasAdded, {flow: newFlows[i]}); } _contentFlowWasAdded(event) { var flow = event.data.flow; if (!this._isContentFlowInCurrentDocument(flow)) return; var flowId = flow.id; console.assert(!this._flowMap.hasOwnProperty(flowId)); this._flowMap[flowId] = flow; this.dispatchEventToListeners(WebInspector.DOMTree.Event.ContentFlowWasAdded, {flow}); } _contentFlowWasRemoved(event) { var flow = event.data.flow; if (!this._isContentFlowInCurrentDocument(flow)) return; var flowId = flow.id; console.assert(this._flowMap.hasOwnProperty(flowId)); delete this._flowMap[flowId]; this.dispatchEventToListeners(WebInspector.DOMTree.Event.ContentFlowWasRemoved, {flow}); } }; WebInspector.DOMTree.Event = { RootDOMNodeInvalidated: "dom-tree-root-dom-node-invalidated", ContentFlowWasAdded: "dom-tree-content-flow-was-added", ContentFlowWasRemoved: "dom-tree-content-flow-was-removed" };