Mute use counters for internal pages

third_party/WebKit/Source/core/frame/UseCounter.h

 /*
  * Copyright (C) 2012 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
@@ skipping 11 matching lines @@
  * (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 UseCounter_h
 #define UseCounter_h
 
 #include "core/CSSPropertyNames.h"
 #include "core/CoreExport.h"
 #include "core/css/parser/CSSParserMode.h"
+#include "platform/weborigin/KURL.h"
 #include "wtf/BitVector.h"
 #include "wtf/Noncopyable.h"
 #include "wtf/text/WTFString.h"
 #include <v8.h>
 
 namespace blink {
 
 class CSSStyleSheet;
 class Document;
 class EnumerationHistogram;
@@ skipping 1379 matching lines @@
   static void countCrossOriginIframe(const Document&, Feature);
 
   // Return whether the Feature was previously counted for this document.
   // NOTE: only for use in testing.
   static bool isCounted(Document&, Feature);
   // Return whether the CSSPropertyID was previously counted for this document.
   // NOTE: only for use in testing.
   static bool isCounted(Document&, const String&);
   bool isCounted(CSSPropertyID unresolvedProperty);
 
-  void didCommitLoad();
+  // Invoked when a new document is loaded into the main frame of the page.
+  void didCommitLoad(KURL);
 
   static UseCounter* getFrom(const Document*);
   static UseCounter* getFrom(const CSSStyleSheet*);
   static UseCounter* getFrom(const StyleSheetContents*);
 
   static int mapCSSPropertyIdToCSSSampleIdForHistogram(CSSPropertyID);
 
+  // When muted, all calls to "count" functions are ignoed.  May be nested.
   void muteForInspector();
   void unmuteForInspector();
 
   void recordMeasurement(Feature);
-  void updateMeasurements();
 
+  // Return whether the feature has been seen since the last page load
+  // (except when muted).  Does include features seen in documents which have
+  // reporting disabled.
   bool hasRecordedMeasurement(Feature) const;
 
  private:
   EnumerationHistogram& featuresHistogram() const;
   EnumerationHistogram& cssHistogram() const;
 
+  // If non-zero, ignore all 'count' calls completely.
   unsigned m_muteCount;
+
+  // If true, disable reporting all histogram entries.
+  bool m_disableReporting;
+
+  // The scope represented by this UseCounter instance.
   Context m_context;
 
   // Track what features/properties have been reported to the (non-legacy)
   // histograms.
   BitVector m_featuresRecorded;
   BitVector m_CSSRecorded;
 
   // Encapsulates the work to preserve the old "FeatureObserver" histogram with
   // original semantics
-  // TODO(rbyers): remove this - http://crbug.com/597963
+  // TODO(rbyers): remove this - http://crbug.com/676837
   class CORE_EXPORT LegacyCounter {
    public:
     LegacyCounter();
     ~LegacyCounter();
     void countFeature(Feature);
     void countCSS(CSSPropertyID);
     void updateMeasurements();
 
    private:
     // Tracks what features/properties need to be reported to the legacy
     // histograms.
     BitVector m_featureBits;
     BitVector m_CSSBits;
   } m_legacyCounter;
 };
 
 }  // namespace blink
 
 #endif  // UseCounter_h