/* * Copyright (C) 2009 Apple Inc. All rights reserved. * Copyright (C) 2009 Google 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. * 3. Neither the name of Apple Computer, Inc. ("Apple") nor the names of * its contributors may be used to endorse or promote products derived * from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY APPLE 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 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. */ #ifndef InspectorDOMAgent_h #define InspectorDOMAgent_h #include "Document.h" #include "EventListener.h" #include "EventTarget.h" #include "InspectorCSSStore.h" #include "InspectorValues.h" #include "NodeList.h" #include "ScriptState.h" #include "Timer.h" #include #include #include #include #include #include #include namespace WebCore { class ContainerNode; class CSSRule; class CSSRuleList; class CSSStyleDeclaration; class CSSStyleRule; class CSSStyleSheet; class Element; class Event; class InspectorDOMAgent; class RemoteInspectorFrontend; class MatchJob; class NameNodeMap; class Node; class Page; #if ENABLE(INSPECTOR) struct EventListenerInfo { EventListenerInfo(Node* node, const AtomicString& eventType, const EventListenerVector& eventListenerVector) : node(node) , eventType(eventType) , eventListenerVector(eventListenerVector) { } Node* node; const AtomicString eventType; const EventListenerVector eventListenerVector; }; class InspectorDOMAgent : public EventListener { public: static PassRefPtr create(InspectorCSSStore* cssStore, RemoteInspectorFrontend* frontend) { return adoptRef(new InspectorDOMAgent(cssStore, frontend)); } static const InspectorDOMAgent* cast(const EventListener* listener) { return listener->type() == InspectorDOMAgentType ? static_cast(listener) : 0; } InspectorDOMAgent(InspectorCSSStore* cssStore, RemoteInspectorFrontend* frontend); ~InspectorDOMAgent(); void reset(); virtual bool operator==(const EventListener& other); // Methods called from the frontend for DOM nodes inspection. void getChildNodes(long nodeId); void setAttribute(long elementId, const String& name, const String& value, bool* success); void removeAttribute(long elementId, const String& name, bool* success); void removeNode(long nodeId, long* outNodeId); void changeTagName(long nodeId, const String& tagName, long* newId); void getOuterHTML(long nodeId, WTF::String* outerHTML); void setOuterHTML(long nodeId, const String& outerHTML, long* newId); void setTextNodeValue(long nodeId, const String& value, bool* success); void getEventListenersForNode(long nodeId, long* outNodeId, RefPtr* listenersArray); void addInspectedNode(long nodeId); void performSearch(const String& whitespaceTrimmedQuery, bool runSynchronously); void searchCanceled(); // Methods called from the frontend for CSS styles inspection. void getStyles(long nodeId, bool authorOnly, RefPtr* styles); void getAllStyles(RefPtr* styles); void getInlineStyle(long nodeId, RefPtr* styles); void getComputedStyle(long nodeId, RefPtr* styles); void getStyleSheet(long styleSheetId, RefPtr* styleSheetObject); void getRuleRanges(long styleSheetId, RefPtr* ruleRange); void applyStyleText(long styleId, const String& styleText, const String& propertyName, bool* success, RefPtr* styleObject, RefPtr* changedProperties); void setStyleText(long styleId, const String& cssText, bool* success); void setStyleProperty(long styleId, const String& name, const String& value, bool* success); void toggleStyleEnabled(long styleId, const String& propertyName, bool disabled, RefPtr* styleObject); void setRuleSelector(long ruleId, const String& selector, long selectedNodeId, RefPtr* ruleObject, bool* selectorAffectsNode); void addRule(const String& selector, long selectedNodeId, RefPtr* ruleObject, bool* selectorAffectsNode); // Methods called from the InspectorController. void setDocument(Document* document); void releaseDanglingNodes(); void didInsertDOMNode(Node*); void didRemoveDOMNode(Node*); void didModifyDOMAttr(Element*); Node* nodeForId(long nodeId); long pushNodePathToFrontend(Node* node); void pushChildNodesToFrontend(long nodeId); void pushNodeByPathToFrontend(const String& path, long* nodeId); long inspectedNode(unsigned long num); void copyNode(long nodeId); private: static CSSStyleSheet* getParentStyleSheet(CSSStyleDeclaration*); void startListening(Document* document); void stopListening(Document* document); virtual void handleEvent(ScriptExecutionContext*, Event* event); // Node-related methods. typedef HashMap, long> NodeToIdMap; long bind(Node* node, NodeToIdMap* nodesMap); void unbind(Node* node, NodeToIdMap* nodesMap); bool pushDocumentToFrontend(); PassRefPtr buildObjectForAttributeStyles(Element* element); PassRefPtr buildArrayForCSSRules(Document* ownerDocument, CSSRuleList*); PassRefPtr buildArrayForPseudoElements(Element* element, bool authorOnly); PassRefPtr buildObjectForNode(Node* node, int depth, NodeToIdMap* nodesMap); PassRefPtr buildArrayForElementAttributes(Element* element); PassRefPtr buildArrayForContainerChildren(Node* container, int depth, NodeToIdMap* nodesMap); PassRefPtr buildObjectForEventListener(const RegisteredEventListener& registeredEventListener, const AtomicString& eventType, Node* node); // We represent embedded doms as a part of the same hierarchy. Hence we treat children of frame owners differently. // We also skip whitespace text nodes conditionally. Following methods encapsulate these specifics. Node* innerFirstChild(Node* node); Node* innerNextSibling(Node* node); Node* innerPreviousSibling(Node* node); unsigned innerChildNodeCount(Node* node); Node* innerParentNode(Node* node); bool isWhitespace(Node* node); Document* mainFrameDocument() const; String documentURLString(Document* document) const; InspectorCSSStore* cssStore() { return m_cssStore; } void onMatchJobsTimer(Timer*); void reportNodesAsSearchResults(ListHashSet& resultCollector); PassRefPtr buildObjectForStyle(CSSStyleDeclaration*, bool bind); void populateObjectWithStyleProperties(CSSStyleDeclaration*, InspectorObject* result); PassRefPtr buildArrayForDisabledStyleProperties(DisabledStyleDeclaration*); PassRefPtr buildObjectForRule(Document* ownerDocument, CSSStyleRule*); PassRefPtr buildObjectForStyleSheet(Document* ownerDocument, CSSStyleSheet*); Vector longhandProperties(CSSStyleDeclaration*, const String& shorthandProperty); String shorthandValue(CSSStyleDeclaration*, const String& shorthandProperty); String shorthandPriority(CSSStyleDeclaration*, const String& shorthandProperty); bool ruleAffectsNode(CSSStyleRule*, Node*); Node* nodeForPath(const String& path); PassRefPtr toArray(const Vector& data); void discardBindings(); InspectorCSSStore* m_cssStore; RemoteInspectorFrontend* m_frontend; NodeToIdMap m_documentNodeToIdMap; // Owns node mappings for dangling nodes. Vector m_danglingNodeToIdMaps; HashMap m_idToNode; HashMap m_idToNodesMap; HashSet m_childrenRequested; long m_lastNodeId; ListHashSet > m_documents; Deque m_pendingMatchJobs; Timer m_matchJobsTimer; HashSet > m_searchResults; Vector m_inspectedNodes; }; #endif } // namespace WebCore #endif // !defined(InspectorDOMAgent_h)