Adding run_at to chrome.tabs.executeScript/insertCss.

chrome/common/extensions/api/tabs.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": "tabs",
     "dependencies": [ "extension", "windows" ],
     "types": [
       {
@@ skipping 558 matching lines @@
         "description": "Injects JavaScript code into a page. For details, see the <a href='content_scripts.html#pi'>programmatic injection</a> section of the content scripts doc.",
         "parameters": [
           {"type": "integer", "name": "tabId", "optional": true, "description": "The ID of the tab in which to run the script; defaults to the active tab of the current window."},
           {
             "type": "object",
             "name": "details",
             "description": "Details of the script to run. Either the code or the file property must be set, but both may not be set at the same time.",
             "properties": {
               "code": {"type": "string", "optional": true, "description": "JavaScript code to execute."},
               "file": {"type": "string", "optional": true, "description": "JavaScript file to execute."},
-              "allFrames": {"type": "boolean", "optional": true, "description": "If allFrames is true, this function injects script into all frames of current page. By default, it's false and script is injected only into the top main frame."}
+              "allFrames": {"type": "boolean", "optional": true, "description": "If allFrames is true, this function injects script into all frames of current page. By default, it's false and script is injected only into the top main frame."},
+              "runAt": {
+                "type": "string",
+                "optional": true,
+                "enum": ["document_start", "document_end", "document_idle"],
+                "descrption": "The soonest that the script will be injected into the tab. Defaults to \"document_idle\"."
+              }
             }
           },
           {
             "type": "function",
             "name": "callback",
             "optional": true,
             "description": "Called after all the JavaScript has been executed.",
             "parameters": []
           }
         ]
       },
       {
         "name": "insertCSS",
         "type": "function",
         "description": "Injects CSS into a page. For details, see the <a href='content_scripts.html#pi'>programmatic injection</a> section of the content scripts doc.",
         "parameters": [
           {"type": "integer", "name": "tabId", "optional": true, "description": "The ID of the tab in which to insert the CSS; defaults to the active tab of the current window."},
           {
             "type": "object",
             "name": "details",
             "description": "Details of the CSS text to insert. Either the code or the file property must be set, but both may not be set at the same time.",
             "properties": {
               "code": {"type": "string", "optional": true, "description": "CSS code to be injected."},
               "file": {"type": "string", "optional": true, "description": "CSS file to be injected."},
-              "allFrames": {"type": "boolean", "optional": true, "description": "If allFrames is true, this function injects CSS text into all frames of current page. By default, it's false and CSS is injected only into the top main frame."}
+              "allFrames": {"type": "boolean", "optional": true, "description": "If allFrames is true, this function injects CSS text into all frames of current page. By default, it's false and CSS is injected only into the top main frame."},
+              "runAt": {
+                "type": "string",
+                "optional": true,
+                "enum": ["document_start", "document_end", "document_idle"],
+                "descrption": "The soonest that the CSS will be injected into the tab. Defaults to \"document_idle\"."

[Aaron Boodman, 2012/03/28 01:04:16]

I think CSS is always injected immediately, so this is not needed.

[eaugusti, 2012/03/28 17:40:19]

I took a closer look, and CSS is not injected immediately.
Besides a localization step, CSS is treated the same as js.

[Aaron Boodman, 2012/03/30 21:47:04]

That is weird, but OK.

+              }
             }
           },
           {
             "type": "function",
             "name": "callback",
             "optional": true,
             "description": "Called when all the CSS has been inserted.",
             "parameters": []
           }
         ]
@@ skipping 229 matching lines @@
             "name": "removeInfo",
             "properties": {
               "isWindowClosing": {"type": "boolean", "description": "True when the tab is being closed because its window is being closed." }
             }
           }
         ]
       }
     ]
   }
 ]