Declarative Web Request: firstPartyForCookiesUrl

chrome/common/extensions/api/declarative_web_request.json

 // Copyright (c) 2012 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.
 
 [
   {
     "namespace": "declarativeWebRequest",
     "documentation_permissions_required": ["declarative", "declarativeWebRequest"],
     "types": [
       {
@@ skipping 49 matching lines @@
           }
         }
       },
       {
         "id": "RequestMatcher",
         "type": "object",
         "description": "Matches network events by various criteria.",
         "properties": {
           "url": {
             "$ref": "events.UrlFilter",
-            "description": "Matches if the condition of the UrlFilter are fulfilled for the URL of the request.",
+            "description": "Matches if the conditions of the UrlFilter are fulfilled for the URL of the request.",
+            "optional": true
+          },
+          "firstPartyForCookiesUrl": {
+            "$ref": "events.UrlFilter",
+            "description": "Matches if the conditions of the UrlFilter are fulfilled for the URL representing first party for cookies.",

[Jeffrey Yasskin, 2012/12/18 03:09:58]

How does a URL "represent first party for cookies"? 

[vabr (Chromium), 2013/01/21 10:57:48]

When it is the same URL, as the one associated to the request as the first party
for cookies. It's bad if this sentence does not make sense, any suggestions for
improvement?

             "optional": true
           },
           "resourceType": {
             "type": "array",
             "optional": true,
             "description": "Matches if the request type of a request is contained in the list. Requests that cannot match any of the types will be filtered out.",
             "items": { "type": "string", "enum": ["main_frame", "sub_frame", "stylesheet", "script", "image", "object", "xmlhttprequest", "other"] }
           },
           "contentType": {
             "type": "array",
@@ skipping 455 matching lines @@
             "declarativeWebRequest.RemoveRequestHeader",
             "declarativeWebRequest.RemoveResponseHeader",
             "declarativeWebRequest.SetRequestHeader",
             "declarativeWebRequest.IgnoreRules"
           ]
         }
       }
     ]
   }
 ]