Prepare declarativeContent API for new script injection feature. Added Javascript types and functio…

chrome/common/extensions/api/declarative_content.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": "declarativeContent",
     "description": "Use the <code>chrome.declarativeContent</code> API to take actions depending on the content of a page, without requiring permission to read the page's content.",
     "types": [
       {
@@ skipping 30 matching lines @@
       {
         "id": "ShowPageAction",
         "description": "Declarative event action that shows the extension's $(ref:pageAction page action) while the corresponding conditions are met.  This action can be used without <a href=\"declare_permissions#host-permissions\">host permissions</a>, but the extension must have a page action.  If the extension takes the <a href=\"activeTab.html\">activeTab</a> permission, a click on the page action will grant access to the active tab.",
         "type": "object",
         "properties": {
           "instanceType": {
             "type": "string", "enum": ["declarativeContent.ShowPageAction"],
             "nodoc": true
           }
         }
+      },
+      {
+        "id": "ContentScript",
+        "description": "Declarative content script definition.",
+        "type": "object",
+        "properties": {
+          "css": {
+            "type": "array",
+            "optional": true,
+            "description": "Names of CSS files to be injected as a part of content script.",
+            "items": { "type": "string" }
+          },
+          "js": {
+            "type": "array",
+            "optional": true,
+            "description": "Names of Javascript files to be injected as a part of content script.",
+            "items": { "type": "string" }
+          },
+          "callback": {

[not at google - send to devlin, 2014/06/24 15:06:43]

We weren't going to have a callback, right?

[Mark Dittmer, 2014/06/25 14:36:05]

Done.

+            "type": "function",
+            "optional": true,
+            "description": "Function to be called after content script injection attempt is complete."
+          },
+          "instanceType": {
+            "type": "string", "enum": ["declarativeContent.ContentScript"],
+            "nodoc": true
+          }
+        }
+      },
+      {
+        "id": "RequestContentScript",

[not at google - send to devlin, 2014/06/24 15:06:43]

I don't think we need 2 different types here. If it's actually useful separating
the idioms - a content script which always attempts to be injected, or a content
script which fails if it can't be injected - then it could be a flag on the
[Request]ContentScript type.

[Mark Dittmer, 2014/06/25 14:36:05]

Done.

+        "description": "Declarative event action that injects a content script.",
+        "type": "object",
+        "properties": {
+          "script": {
+            "$ref": "ContentScript"
+          },
+          "callback": {
+            "type": "function",
+            "optional": true
+          },
+          "instanceType": {
+            "type": "string", "enum": ["declarativeContent.RequestContentScript"],
+            "nodoc": true
+          }
+        }
       }
     ],
     "functions": [
     ],
     "events": [
       {
         "name": "onPageChanged",
         "options": {
           "supportsListeners": false,
           "supportsRules": true,
           "conditions": ["declarativeContent.PageStateMatcher"],
           "actions": [
             "declarativeContent.ShowPageAction"
           ]
         }
+      },
+      {
+        "name": "onDocumentStart",
+        "options": {
+          "supportsListeners": false,
+          "supportsRules": true,
+          "conditions": ["declarativeContent.PageStateMatcher"],
+          "actions": [
+            "declarativeContent.RequestContentScript"
+          ]
+        }
+      },
+      {
+        "name": "onDocumentEnd",
+        "options": {
+          "supportsListeners": false,
+          "supportsRules": true,
+          "conditions": ["declarativeContent.PageStateMatcher"],
+          "actions": [
+            "declarativeContent.RequestContentScript"
+          ]
+        }
+      },
+      {
+        "name": "onDocumentIdle",
+        "options": {
+          "supportsListeners": false,
+          "supportsRules": true,
+          "conditions": ["declarativeContent.PageStateMatcher"],
+          "actions": [
+            "declarativeContent.RequestContentScript"
+          ]
+        }
       }
     ]
   }
 ]