Part 1.1: Is policy list subsumed under subsuming policy?

third_party/WebKit/Source/core/frame/csp/CSPSource.h

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CSPSource_h
 #define CSPSource_h
 
 #include "core/CoreExport.h"
 #include "core/frame/csp/ContentSecurityPolicy.h"
 #include "platform/heap/Handle.h"
@@ skipping 13 matching lines @@
   CSPSource(ContentSecurityPolicy*,
             const String& scheme,
             const String& host,
             int port,
             const String& path,
             WildcardDisposition hostWildcard,
             WildcardDisposition portWildcard);
   bool matches(const KURL&,
                ResourceRequest::RedirectStatus =
                    ResourceRequest::RedirectStatus::NoRedirect) const;
+  // Check whether this CSPSource is subsumed under a given CSPSource for a

[jochen (gone - plz use gerrit), 2016/11/02 11:11:33]

nit. add empty line before this one

+  // subsumption algorithm described here:
+  // https://w3c.github.io/webappsec-csp/embedded/#subsume-policy
+  bool isSubsumedBy(CSPSource*);
 
   DECLARE_TRACE();
 
  private:
+  FRIEND_TEST_ALL_PREFIXES(CSPSourceTest, IsSimilar);
+
   bool schemeMatches(const String&) const;
   bool hostMatches(const String&) const;
   bool pathMatches(const String&) const;
   // Protocol is necessary to determine default port if it is zero.
   bool portMatches(int port, const String& protocol) const;
   bool isSchemeOnly() const;
+  bool isPathEmptyOrSlashOnly() const;
+  // Check if either one of the two matches the scheme, host, port, path of the
+  // other. More detailed explanation here:
+  // https://docs.google.com/document/d/1xwTxpB_sWYaTrOBJEPSXtfWKO4M2k9Xya7o0zcd6Dec/edit#heading=h.9efhej5pg0hj

[jochen (gone - plz use gerrit), 2016/11/02 11:11:33]

if you put links in the source, please make this a world-readable doc

+  bool isSimilar(CSPSource* other);
+
+  bool isWildcardsSubsumedBy(CSPSource* other);

[jochen (gone - plz use gerrit), 2016/11/02 11:11:33]

isWildcard or areWildcards

+  bool isSchemeSubsumedBy(CSPSource* other);
+  bool isPortSubsumedBy(CSPSource* other);
+  bool isPathSubsumedBy(CSPSource* other);
 
   Member<ContentSecurityPolicy> m_policy;
   String m_scheme;
   String m_host;
   int m_port;
   String m_path;
 
   WildcardDisposition m_hostWildcard;
   WildcardDisposition m_portWildcard;
 };
 
 }  // namespace blink
 
 #endif