Warn developers about deprecated features only once per page-load.

Source/core/page/DeprecationAgent.h

 /*
- * Copyright (C) 2012 Google, Inc. All rights reserved.
+ * Copyright (C) 2013 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.
  *
  * THIS SOFTWARE IS PROVIDED BY GOOGLE INC. ``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 COMPUTER, INC. OR
  * 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 WindowFocusAllowedIndicator_h
-#define WindowFocusAllowedIndicator_h
+#ifndef DeprecationAgent_h
+#define DeprecationAgent_h
 
+#include <wtf/BitVector.h>
 #include <wtf/Noncopyable.h>
-#include <wtf/RefPtr.h>
+#include <wtf/OwnPtr.h>
 
 namespace WebCore {
 
-class WindowFocusAllowedIndicator {
-    WTF_MAKE_NONCOPYABLE(WindowFocusAllowedIndicator);
+class DOMWindow;
+class Document;
+class PageConsole;
+
+// DeprecationAgent is used to notify developers about the deprecation of APIs
+// they make use of on pages. This notification would generally be the first
+// step towards dropping support for a feature from Blink entirely.
+//
+// To notify developers that a feature they're making use of is deprecated:
+//
+// 1. Add the feature to the Feature enum below.
+// 2. Add a deprecation message to DeprecationAgent.cpp.
+// 3. Call DeprecationAgent::notify(FEATURE_TYPE, "Deprecation message.");
+// 4. There is no step 4.
+
+class DeprecationAgent {

[pfeldman, 2013/04/19 13:04:22]

It is so small that it feels like deprecation could be one of the PageConsole's
responsibilities.

+    WTF_MAKE_NONCOPYABLE(DeprecationAgent);
 public:
-    WindowFocusAllowedIndicator();
-    ~WindowFocusAllowedIndicator();
+    DeprecationAgent();
+    ~DeprecationAgent();
 
-    static bool windowFocusAllowed();
+    enum Feature {
+        PrefixedContentSecurityPolicyHeader,
+
+        // Add new features above this line.
+        NumberOfFeatures, // This enum value must be last.
+    };
+
+    static void notify(Document*, Feature);
 
 private:
-    bool m_previousWindowFocusAllowed;
+    void sendNotification(PageConsole*, Feature feature);
+
+    OwnPtr<BitVector> m_countBits;
 };
 
 } // namespace WebCore
 
-#endif // WindowFocusAllowedIndicator_h
+#endif // DeprecationAgent_h