Backend for css rule tracking

third_party/WebKit/Source/devtools/front_end/sdk/CSSModel.js

 /*
  * Copyright (C) 2010 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:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 421 matching lines @@
       this._fireStyleSheetChanged(styleSheetId, edit);
       return true;
     }
 
     WebInspector.userMetrics.actionTaken(WebInspector.UserMetrics.Action.StyleRuleEdited);
     return this._ensureOriginalStyleSheetText(styleSheetId)
         .then(() => this._agent.setKeyframeKey(styleSheetId, range, text, callback.bind(this)))
         .catchException(false);
   }
 
+  startRuleUsageTracking() {
+    this._agent.startRuleUsageTracking();
+  }
+
+  /**
+   * @return {!Promise<?Array<!WebInspector.CSSModel.RuleTextRange>>}
+   */
+  ruleListPromise() {
+    /**
+     * @param {?string} error
+     * @param {!Array<!CSSAgent.RuleUsage>=} CSSRules
+     * @return {?Array<!WebInspector.CSSModel.RuleTextRange>}
+     */
+    function usedRulesCallback(error, CSSRules) {

[pfeldman, 2016/11/02 18:38:26]

variables start with lower case: cssRules or even better ruleUsage.

+      if (error || !CSSRules)
+        return null;
+
+      return CSSRules.map(rule => ({range: rule.range, styleSheetId: rule.styleSheetId, wasUsed: rule.used}));
+    }
+
+    return this._agent.stopRuleUsageTracking(usedRulesCallback);
+  }
+
   /**
    * @return {!Promise.<!Array.<!WebInspector.CSSMedia>>}
    */
   mediaQueriesPromise() {
     /**
      * @param {?Protocol.Error} error
      * @param {?Array.<!CSSAgent.CSSMedia>} payload
      * @return {!Array.<!WebInspector.CSSMedia>}
      * @this {!WebInspector.CSSModel}
      */
@@ skipping 531 matching lines @@
       this._cachedMatchedCascadePromise = this.matchedStylesPromise(node.id);
     return this._cachedMatchedCascadePromise;
   }
 
   discardCachedMatchedCascade() {
     delete this._cachedMatchedCascadeNode;
     delete this._cachedMatchedCascadePromise;
   }
 };
 
+/** @typedef {!{range: !WebInspector.TextRange, styleSheetId: !CSSAgent.StyleSheetId, wasUsed: boolean}} */
+WebInspector.CSSModel.RuleTextRange;

[pfeldman, 2016/11/02 18:38:26]

RuleTextRange should not operate terms such as "wasUsed". Why text range? You
should only operate raw locations for usage, then convert them to UILocations
using bindings. Talk to lushnikov@ about it!

+
 /** @enum {symbol} */
 WebInspector.CSSModel.Events = {
   LayoutEditorChange: Symbol('LayoutEditorChange'),
   FontsUpdated: Symbol('FontsUpdated'),
   MediaQueryResultChanged: Symbol('MediaQueryResultChanged'),
   ModelWasEnabled: Symbol('ModelWasEnabled'),
   PseudoStateForced: Symbol('PseudoStateForced'),
   StyleSheetAdded: Symbol('StyleSheetAdded'),
   StyleSheetChanged: Symbol('StyleSheetChanged'),
   StyleSheetRemoved: Symbol('StyleSheetRemoved'),
@@ skipping 176 matching lines @@
 WebInspector.CSSModel.InlineStyleResult = class {
   /**
    * @param {?WebInspector.CSSStyleDeclaration} inlineStyle
    * @param {?WebInspector.CSSStyleDeclaration} attributesStyle
    */
   constructor(inlineStyle, attributesStyle) {
     this.inlineStyle = inlineStyle;
     this.attributesStyle = attributesStyle;
   }
 };