Adding run_at to chrome.tabs.executeScript/insertCss.

chrome/common/extensions/api/tabs.json

 [
   {
     "namespace": "tabs",
     "dependencies": [ "extension", "windows" ],
     "types": [
       {
         "id": "Tab",
         "type": "object",
         "properties": {
           "id": {"type": "integer", "minimum": 0, "description": "The ID of the tab. Tab IDs are unique within a browser session."},
@@ skipping 544 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": ["now", "document_start", "document_end", "document_idle"],
+                "descrption": "The soonest that the script will be injected into the tab. Defaults to \"document_idle\""

[Aaron Boodman, 2012/03/03 00:59:10]

Add a period to the end of this sentence. Same below.

[eaugusti, 2012/03/27 00:43:33]

Done.

+              }
             }
           },
           {
             "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": ["now", "document_start", "document_end", "document_idle"],
+                "descrption": "The soonest that the CSS will be injected into the tab. Defaults to \"document_idle\""
+              }
             }
           },
           {
             "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." }
             }
           }
         ]
       }
     ]
   }
 ]