DevTools: [Elements] Implement "Copy CSS Path" context menu item for elements

Source/devtools/front_end/DOMAgent.js

 /*
  * Copyright (C) 2009, 2010 Google Inc. All rights reserved.
  * Copyright (C) 2009 Joseph Pecoraro
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
@@ skipping 101 matching lines @@
 WebInspector.DOMNode.PseudoElementNames = {
     Before: "before",
     After: "after"
 }
 
 /**
  * @constructor
  * @param {string} value
  * @param {boolean} optimized
  */
-WebInspector.DOMNode.XPathStep = function(value, optimized)
+WebInspector.DOMNode.PathStep = function(value, optimized)
 {
     this.value = value;
     this.optimized = optimized;
 }
 
-WebInspector.DOMNode.XPathStep.prototype = {
+WebInspector.DOMNode.PathStep.prototype = {
     toString: function()
     {
         return this.value;
     }
 }
 
 WebInspector.DOMNode.prototype = {
     /**
      * @return {Array.<WebInspector.DOMNode>}
      */
@@ skipping 270 matching lines @@
         {
             if (!error)
                 InspectorFrontendHost.copyText(text);
         }
         DOMAgent.getOuterHTML(this.id, copy);
     },
 
     /**
      * @param {boolean} optimized
      */
+    copyCSSPath: function(optimized)
+    {
+        InspectorFrontendHost.copyText(this.cssPath(optimized));
+    },
+
+    /**
+     * @param {boolean} optimized
+     */
     copyXPath: function(optimized)
     {
         InspectorFrontendHost.copyText(this.xPath(optimized));
     },
 
     /**
      * @param {string} objectGroupId
      * @param {function(?Protocol.Error)=} callback
      */
     eventListeners: function(objectGroupId, callback)
@@ skipping 235 matching lines @@
      */
     isXMLNode: function()
     {
         return !!this.ownerDocument && !!this.ownerDocument.xmlVersion;
     },
 
     /**
      * @param {boolean} optimized
      * @return {string}
      */
+    cssPath: function(optimized)
+    {
+        if (this._nodeType !== Node.ELEMENT_NODE)
+            return "";
+
+        var steps = [];
+        var contextNode = this;
+        while (contextNode) {
+            var step = contextNode._cssPathValue(optimized);
+            if (!step)
+                break; // Error - bail out early.
+            steps.push(step);
+            if (step.optimized)
+                break;
+            contextNode = contextNode.parentNode;
+        }
+
+        steps.reverse();
+        return steps.join(" > ");
+    },
+
+    /**
+     * @param {boolean} optimized
+     * @return {WebInspector.DOMNode.PathStep}
+     */
+    _cssPathValue: function(optimized)
+    {
+        if (this._nodeType !== Node.ELEMENT_NODE)
+            return null;
+        if (optimized) {
+            if (this.getAttribute("id"))
+                return new WebInspector.DOMNode.PathStep("#" + this.getAttribute("id"), true);
+            var nodeNameLower = this._nodeName.toLowerCase();
+            if (nodeNameLower === "body" || nodeNameLower === "head" || nodeNameLower === "html")
+                return new WebInspector.DOMNode.PathStep(this.nodeNameInCorrectCase(), true);
+        }
+        var ownValue = this.nodeNameInCorrectCase();
+        var parent = this.parentNode;
+        if (!parent || parent._nodeType === Node.DOCUMENT_NODE)
+            return new WebInspector.DOMNode.PathStep(ownValue, true);
+
+        var nodeName = this.nodeNameInCorrectCase();

[aandrey, 2013/11/18 13:43:51]

move above and get rid of ownValue

[apavlov, 2013/11/18 15:03:59]

Done.

+        var uniqueClassNamesArray = (this.getAttribute("class") || "").split(/\s+/g);

[aandrey, 2013/11/18 13:43:51]

this array is not unique, and can contain empty strings

[apavlov, 2013/11/18 15:03:59]

It is not unique, but it cannot contain empty strings (\s+). Implemented manual
length computation over the resulting map.

[aandrey, 2013/11/18 15:15:56]

FYI.

a = document.createElement("div");
a.className = " a b a ";
(a.getAttribute("class") || "").split(/\s+/g);

===> ["", "a", "b", "a", ""]

+        var uniqueClassNamesLeft = uniqueClassNamesArray.length;
+        var uniqueClassNames = uniqueClassNamesArray.keySet();
+        var needsClassNames;

[aandrey, 2013/11/18 13:43:51]

plz init (with "false" I believe?)

[apavlov, 2013/11/18 15:03:59]

Done.

+        var needsNthChild;

[aandrey, 2013/11/18 13:43:51]

ditto

[apavlov, 2013/11/18 15:03:59]

Done.

+        var ownIndex = -1;
+        var siblings = parent.children();
+        for (var i = 0; (ownIndex === -1 || !needsNthChild) && i < siblings.length; ++i) {
+            var sibling = siblings[i];
+            if (sibling === this) {
+                ownIndex = i;
+                continue;
+            }
+            if (sibling.nodeNameInCorrectCase() !== nodeName)
+                continue;
+            if (!uniqueClassNamesLeft) {
+                needsNthChild = true;
+                continue;
+            }
+
+            needsClassNames = true;
+            var siblingClasses = (sibling.getAttribute("class") || "").split(/\s+/g).keySet();

[aandrey, 2013/11/18 13:43:51]

code dup, plz extract

[apavlov, 2013/11/18 15:03:59]

Done.

+            for (var siblingClass in siblingClasses) {
+                if (!uniqueClassNames.hasOwnProperty(siblingClass))
+                    continue;
+                delete uniqueClassNames[siblingClass];
+                if (!--uniqueClassNamesLeft) {

[aandrey, 2013/11/18 13:43:51]

Did you mean uniqueClassNamesLeft to be initialized with the size of the keySet,
instead of an "split" array?

[apavlov, 2013/11/18 15:03:59]

Yep. Fixed

+                    needsNthChild = true;
+                    break;
+                }
+            }
+        }
+
+        var result = nodeName;
+        if (needsClassNames && uniqueClassNamesLeft) {
+            for (var className in uniqueClassNames)
+                result += "." + className;
+        }
+        if (needsNthChild)
+            result += ":nth-child(" + (ownIndex + 1) + ")";
+        return new WebInspector.DOMNode.PathStep(result, false);
+    },
+
+    /**
+     * @param {boolean} optimized
+     * @return {string}
+     */
     xPath: function(optimized)
     {
         if (this._nodeType === Node.DOCUMENT_NODE)
             return "/";
 
         var steps = [];
         var contextNode = this;
         while (contextNode) {
             var step = contextNode._xPathValue(optimized);
             if (!step)
                 break; // Error - bail out early.
             steps.push(step);
             if (step.optimized)
                 break;
             contextNode = contextNode.parentNode;
         }
 
         steps.reverse();
         return (steps.length && steps[0].optimized ? "" : "/") + steps.join("/");
     },
 
     /**
      * @param {boolean} optimized
-     * @return {WebInspector.DOMNode.XPathStep}
+     * @return {WebInspector.DOMNode.PathStep}
      */
     _xPathValue: function(optimized)
     {
         var ownValue;
         var ownIndex = this._xPathIndex();
         if (ownIndex === -1)
             return null; // Error.
 
         switch (this._nodeType) {
         case Node.ELEMENT_NODE:
             if (optimized && this.getAttribute("id"))
-                return new WebInspector.DOMNode.XPathStep("//*[@id=\"" + this.getAttribute("id") + "\"]", true);
+                return new WebInspector.DOMNode.PathStep("//*[@id=\"" + this.getAttribute("id") + "\"]", true);
             ownValue = this._localName;
             break;
         case Node.ATTRIBUTE_NODE:
             ownValue = "@" + this._nodeName;
             break;
         case Node.TEXT_NODE:
         case Node.CDATA_SECTION_NODE:
             ownValue = "text()";
             break;
         case Node.PROCESSING_INSTRUCTION_NODE:
             ownValue = "processing-instruction()";
             break;
         case Node.COMMENT_NODE:
             ownValue = "comment()";
             break;
         case Node.DOCUMENT_NODE:
             ownValue = "";
             break;
         default:
             ownValue = "";
             break;
         }
 
         if (ownIndex > 0)
             ownValue += "[" + ownIndex + "]";
 
-        return new WebInspector.DOMNode.XPathStep(ownValue, this._nodeType === Node.DOCUMENT_NODE);
+        return new WebInspector.DOMNode.PathStep(ownValue, this._nodeType === Node.DOCUMENT_NODE);
     },
 
     /**
      * @return {number}
      */
     _xPathIndex: function()
     {
         // Returns -1 in case of error, 0 if no siblings matching the same expression, <XPath index among the same expression-matching sibling nodes> otherwise.
         function areNodesSimilar(left, right)
         {
@@ skipping 988 matching lines @@
     setInspectModeEnabled: function(enabled, inspectShadowDOM, config, callback)
     {
         DOMAgent.setInspectModeEnabled(enabled, inspectShadowDOM, config, callback);
     }
 }
 
 /**
  * @type {?WebInspector.DOMAgent}
  */
 WebInspector.domAgent = null;