<webview>: Implement ExecuteScript

chrome/common/extensions/api/webview.json

+// Copyright (c) 2013 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": "webview",

[Matt Perry, 2013/01/23 20:23:58]

add "nodoc": true here. Otherwise we'll generate extension docs for this, which
is really just a private implementation detail. I assume the webview API is
documented elsewhere?

[Fady Samuel, 2013/01/23 20:54:32]

Done. Yes, <webview> is documented elsewhere.

+    "dependencies": [ "extension", "tabs" ],
+    "types": [
+      // TODO(fsamuel): We should be usng tabs.InjectDetails. However, due to a
+      // bug in the JSON compiler, we are currently copying-and-pasting this
+      // type: https://crbug.com/171726.
+      {
+        "id": "InjectDetails",
+        "type": "object",
+        "description": "Details of the script or CSS to inject. 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 or CSS code to inject."},
+          "file": {"type": "string", "optional": true, "description": "JavaScript or CSS file to inject."},
+          "allFrames": {"type": "boolean", "optional": true, "description": "If allFrames is <code>true</code>, implies that the JavaScript or CSS should be injected into all frames of current page. By default, it's <code>false</code> and will only be injected into the top frame."},
+          "runAt": {
+            "type": "string",
+            "optional": true,
+            "enum": ["document_start", "document_end", "document_idle"],
+            "description": "The soonest that the JavaScript or CSS will be injected into the tab. Defaults to \"document_idle\"."
+          }
+        }
+      }
+    ],
+    "functions": [
+      {
+        "name": "executeScript",
+        "type": "function",
+        "description": "Injects JavaScript code into a <webview> page.",
+        "parameters": [
+          {
+            "type": "integer",
+            "name": "processId",
+            "description": "The process ID of the guest <webview> process."
+          },
+          {
+            "type": "integer",
+            "name": "routeId",
+            "description": "The route ID of the guest <webview> renderer."
+          },
+          {
+            "$ref": "webview.InjectDetails",
+            "name": "details",
+            "description": "Details of the script to run."
+          },
+          {
+            "type": "function",
+            "name": "callback",
+            "optional": true,
+            "description": "Called after all the JavaScript has been executed.",
+            "parameters": [
+              {
+                "name": "result",
+                "optional": true,
+                "type": "array",
+                "items": {"type": "any", "minimum": 0},
+                "description": "The result of the script in every injected frame."
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  }
+]
+