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, 2013/01/24 00:39:17]

As a fairly naive user of this API, "representing first party for cookies"
doesn't mean much to me. Can you elaborate a bit in this description or link to
a more detailed explanation?

[vabr (Chromium), 2013/01/24 18:24:08]

Done. How does that sound now?

[Jeffrey Yasskin, 2013/01/24 19:54:46]

Not great, sorry to say. Again, go ahead and submit without getting this
perfect. We can work on it later, possibly with Meggin's input.

[vabr (Chromium), 2013/01/24 21:12:19]

I agree. Unless Yoyo, who I need to review this file anyway, has a good
suggestion at this time, let's postpone rewording it to another CL.

             "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 496 matching lines @@
               "tabId": {"type": "integer", "description": "The ID of the tab in which the request takes place. Set to -1 if the request isn't related to a tab."},
               "type": {"type": "string", "enum": ["main_frame", "sub_frame", "stylesheet", "script", "image", "object", "xmlhttprequest", "other"], "description": "How the requested resource will be used."},
               "timeStamp": {"type": "number", "description": "The time when this signal is triggered, in milliseconds since the epoch."}
             }
           }
         ]
       }
     ]
   }
 ]