[Extensions Bindings] Introduce a supportsLazyListeners property

chrome/common/extensions/api/webview_tag.json

 // Copyright 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": "webviewTag",
     "description": "Use the <code>webview</code> tag to actively load live content from the web over the network and embed it in your Chrome App. Your app can control the appearance of the <code>webview</code> and interact with the web content, initiate navigations in an embedded web page, react to error events that happen within it, and more (see <a href=\"#usage\">Usage</a>).",
     "documentation_options": {
       "title": "<webview> Tag",
@@ skipping 1065 matching lines @@
       {
         "name": "terminate",
         "type": "function",
         "description": "Forcibly kills the guest web page's renderer process. This may affect multiple <code>webview</code> tags in the current app if they share the same process, but it will not affect <code>webview</code> tags in other apps.",
         "parameters": []
       }
     ],
     "events": [
       {
         "name": "close",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false },
         "description": "Fired when the guest window attempts to close itself.<p>The following example code navigates the <code>webview</code> to <code>about:blank</code> when the guest attempts to close itself.</p><pre>webview.addEventListener('close', function() {\r  webview.src = 'about:blank';\r});</pre>",
         "parameters": []
       },
       {
         "name": "consolemessage",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false },
         "description": "Fired when the guest window logs a console message.<p>The following example code forwards all log messages to the embedder's console without regard for log level or other properties.</p><pre>webview.addEventListener('consolemessage', function(e) {\r  console.log('Guest page logged a message: ', e.message);\r});</pre>",
         "parameters": [
           {
             "name": "level",
             "description": "The severity level of the log message. Ranges from -1 to 2. LOG_VERBOSE (console.debug) = -1, LOG_INFO (console.log, console.info) = 0, LOG_WARNING (console.warn) = 1, LOG_ERROR (console.error) = 2.",
             "type": "integer"
           },
           {
             "name": "message",
             "description": "The logged message contents.",
             "type": "string"
           },
           {
             "name": "line",
             "description": "The line number of the message source.",
             "type": "integer"
           },
           {
             "name": "sourceId",
             "description": "A string identifying the resource which logged the message.",
             "type": "string"
           }
         ]
       },
       {
         "name": "contentload",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false},
         "description": "Fired when the guest window fires a <code>load</code> event, i.e., when a new document is loaded. This does <em>not</em> include page navigation within the current document or asynchronous resource loads. <p>The following example code modifies the default font size of the guest's <code>body</code> element after the page loads:</p><pre>webview.addEventListener('contentload', function() {\r  webview.executeScript({ code: 'document.body.style.fontSize = \"42px\"' });\r});</pre>",
         "parameters": []
       },
       {
         "name": "dialog",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false },
         "description": "Fired when the guest window attempts to open a modal dialog via <code>window.alert</code>, <code>window.confirm</code>, or <code>window.prompt</code>.<p>Handling this event will block the guest process until each event listener returns or the <code>dialog</code> object becomes unreachable (if <code>preventDefault()</code> was called.)</p><p>The default behavior is to cancel the dialog.</p>",
         "parameters": [
           {
             "name": "messageType",
             "type": "string",
             "enum": ["alert", "confirm", "prompt"],
             "description": "The type of modal dialog requested by the guest."
           },
           {
             "name": "messageText",
             "type": "string",
             "description": "The text the guest attempted to display in the modal dialog."
           },
           {
             "name": "dialog",
             "$ref": "DialogController",
             "description": "An interface that can be used to respond to the guest's modal request."
           }
         ]
       },
       {
         "name": "exit",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false },
         "description": "Fired when the process rendering the guest web content has exited.<p>The following example code will show a farewell message whenever the guest page crashes:</p><pre>webview.addEventListener('exit', function(e) {\r  if (e.reason === 'crash') {\r    webview.src = 'data:text/plain,Goodbye, world!';\r  }\r});</pre>",
         "parameters": [
           {
             "name": "processID",
             "description": "Chrome's internal ID of the process that exited.",
             "type": "integer"
           },
           {
             "name": "reason",
             "description": "String indicating the reason for the exit.",
             "type": "string",
             "enum": ["normal", "abnormal", "crash", "kill"]
           }
         ]
       },
       {
         "name": "findupdate",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false },
         "description": "Fired when new find results are available for an active find request. This might happen multiple times for a single find request as matches are found.",
         "parameters": [
           {
             "name": "searchText",
             "type": "string",
             "description": "The string that is being searched for in the page."
           },
           {
             "name": "numberOfMatches",
             "type": "integer",
@@ skipping 16 matching lines @@
           },
           {
             "name": "finalUpdate",
             "type": "string",
             "description": "Indicates that all find requests have completed and that no more <code>findupdate</code> events will be fired until more find requests are made."
           }
         ]
       },
       {
         "name": "loadabort",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false },
         "description": "Fired when a top-level load has aborted without committing. An error message will be printed to the console unless the event is default-prevented. <p class=\"note\"><strong>Note:</strong> When a resource load is aborted, a <code>loadabort</code> event will eventually be followed by a <code>loadstop</code> event, even if all committed loads since the last <code>loadstop</code> event (if any) were aborted.</p><p class=\"note\"><strong>Note:</strong> When the load of either an about URL or a JavaScript URL is aborted, <code>loadabort</code> will be fired and then the <code>webview</code> will be navigated to 'about:blank'.</p>",
         "parameters": [
           {
             "name": "url",
             "description": "Requested URL.",
             "type": "string"
           },
           {
             "name": "isTopLevel",
             "description": "Whether the load was top-level or in a subframe.",
             "type": "boolean"
           },
           {
             "name": "code",
             "description": "Unique integer ID for the type of abort. Note that this ID is <em>not</em> guaranteed to remain backwards compatible between releases. You must not act based upon this specific integer.",
             "type": "integer"
           },
           {
             "name": "reason",
             "description": "String indicating what type of abort occurred. This string is <em>not</em> guaranteed to remain backwards compatible between releases. You must not parse and act based upon its content. It is also possible that, in some cases, an error not listed here could be reported.",
             "type": "string",
             "enum": ["ERR_ABORTED", "ERR_INVALID_URL", "ERR_DISALLOWED_URL_SCHEME", "ERR_BLOCKED_BY_CLIENT", "ERR_ADDRESS_UNREACHABLE", "ERR_EMPTY_RESPONSE", "ERR_FILE_NOT_FOUND", "ERR_UNKNOWN_URL_SCHEME"]
           }
         ]
       },
       {
         "name": "loadcommit",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false },
         "description": "Fired when a load has committed. This includes navigation within the current document as well as subframe document-level loads, but does <em>not</em> include asynchronous resource loads.",
         "parameters": [
           {
             "name": "url",
             "description": "The URL that committed.",
             "type": "string"
           },
           {
             "name": "isTopLevel",
             "description": "Whether the load is top-level or in a subframe.",
             "type": "boolean"
           }
         ]
       },
       {
         "name": "loadredirect",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false },
         "description": "Fired when a top-level load request has redirected to a different URL.",
         "parameters": [
           {
             "name": "oldUrl",
             "description": "The requested URL before the redirect.",
             "type": "string"
           },
           {
             "name": "newUrl",
             "description": "The new URL after the redirect.",
             "type": "string"
           },
           {
             "name": "isTopLevel",
             "description": "Whether or not the redirect happened at top-level or in a subframe.",
             "type": "boolean"
           }
         ]
       },
       {
         "name": "loadstart",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false },
         "description": "Fired when a load has begun.",
         "parameters": [
           {
             "name": "url",
             "description": "Requested URL.",
             "type": "string"
           },
           {
             "name": "isTopLevel",
             "description": "Whether the load is top-level or in a subframe.",
             "type": "boolean"
           }
         ]
       },
       {
         "name": "loadstop",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false },
         "description": "Fired when all frame-level loads in a guest page (including all its subframes) have completed. This includes navigation within the current document as well as subframe document-level loads, but does <em>not</em> include asynchronous resource loads. This event fires every time the number of document-level loads transitions from one (or more) to zero. For example, if a page that has already finished loading (i.e., <code>loadstop</code> already fired once) creates a new iframe which loads a page, then a second <code>loadstop</code> will fire when the iframe page load completes. This pattern is commonly observed on pages that load ads. <p class=\"note\"><strong>Note:</strong> When a committed load is aborted, a <code>loadstop</code> event will eventually follow a <code>loadabort</code> event, even if all committed loads since the last <code>loadstop</code> event (if any) were aborted.</p>",
         "parameters": []
       },
       {
         "name": "newwindow",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false },
         "description": "Fired when the guest page attempts to open a new browser window.<p>The following example code will create and navigate a new <code>webview</code> in the embedder for each requested new window:</p><pre>webview.addEventListener('newwindow', function(e) {\r  var newWebview = document.createElement('webview');\r  document.body.appendChild(newWebview);\r  e.window.attach(newWebview);\r});</pre>",
         "parameters": [
           {
             "name": "window",
             "description": "An interface that can be used to either attach the requested target page to an existing <code>webview</code> element or explicitly discard the request.",
             "$ref": "NewWindow"
           },
           {
             "name": "targetUrl",
             "description": "The target URL requested for the new window.",
@@ skipping 17 matching lines @@
           {
             "name": "windowOpenDisposition",
             "description": "The requested disposition of the new window.",
             "type": "string",
             "enum": ["ignore", "save_to_disk", "current_tab", "new_background_tab", "new_foreground_tab", "new_window", "new_popup"]
           }
         ]
       },
       {
         "name": "permissionrequest",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false },
         "description": "Fired when the guest page needs to request special permission from the embedder.<p>The following example code will grant the guest page access to the <code>webkitGetUserMedia</code> API. Note that an app using this example code must itself specify <code>audioCapture</code> and/or <code>videoCapture</code> manifest permissions:</p><pre>webview.addEventListener('permissionrequest', function(e) {\r  if (e.permission === 'media') {\r    e.request.allow();\r  }\r});</pre>",
         "parameters": [
           {
             "name": "permission",
             "description": "The type of permission being requested.",
             "type": "string",
             "enum": ["media", "geolocation", "pointerLock", "download", "loadplugin", "filesystem", "fullscreen"]
           },
           {
             "name": "request",
             "type": "object",
             "properties": {},
             "description": "An object which holds details of the requested permission. Depending on the type of permission requested, this may be a $(ref:webviewTag.MediaPermissionRequest), $(ref:webviewTag.GeolocationPermissionRequest), $(ref:webviewTag.PointerLockPermissionRequest), $(ref:webviewTag.DownloadPermissionRequest), $(ref:webviewTag.LoadPluginPermissionRequest), or $(ref:webviewTag.FullscreenPermissionRequest)."
           }
         ]
       },
       {
         "name": "responsive",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false },
         "description": "Fired when the process rendering the guest web content has become responsive again after being unresponsive.<p>The following example code will fade the <code>webview</code> element in or out as it becomes responsive or unresponsive:</p><pre>webview.style.webkitTransition = 'opacity 250ms';\rwebview.addEventListener('unresponsive', function() {\r  webview.style.opacity = '0.5';\r});\rwebview.addEventListener('responsive', function() {\r  webview.style.opacity = '1';\r});</pre>",
         "parameters": [
           {
             "name": "processID",
             "description": "Chrome's internal ID of the process that became responsive.",
             "type": "integer"
           }
         ]
       },
       {
         "name": "sizechanged",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false },
         "description": "Fired when the embedded web content has been resized via <code>autosize</code>. Only fires if <code>autosize</code> is enabled.",
         "parameters": [
           {
             "name": "oldWidth",
             "description": "Old width of embedded web content.",
             "type": "number"
           },
           {
             "name": "oldHeight",
             "description": "Old height of embedded web content.",
             "type": "number"
           },
           {
             "name": "newWidth",
             "description": "New width of embedded web content.",
             "type": "number"
           },
           {
             "name": "newHeight",
             "description": "New height of embedded web content.",
             "type": "number"
           }
         ]
       },
       {
         "name": "unresponsive",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false },
         "description": "Fired when the process rendering the guest web content has become unresponsive. This event will be generated once with a matching responsive event if the guest begins to respond again.",
         "parameters": [
           {
             "name": "processID",
             "description": "Chrome's internal ID of the process that has become unresponsive.",
             "type": "integer"
           }
         ]
       },
       {
         "name": "zoomchange",
-        "options": { "supportsDom": true },
+        "options": { "supportsDom": true, "supportsLazyListeners": false },
         "description": "Fired when the page's zoom changes.",
         "parameters": [
           {
             "name": "oldZoomFactor",
             "type": "number",
             "description": "The page's previous zoom factor."
           },
           {
             "name": "newZoomFactor",
             "type": "number",
@@ skipping 11 matching lines @@
         "$ref": "WebRequestEventInterface",
         "description": "Interface which provides access to webRequest events on the guest page."
       },
       "contextMenus": {
         "$ref": "ContextMenus",
         "description": "Similar to <a href='contextMenus'>chrome's ContextMenus API</a>, but applies to <code>webview</code> instead of browser. Use the <code>webview.contextMenus</code> API to add items to <code>webview</code>'s context menu. You can choose what types of objects your context menu additions apply to, such as images, hyperlinks, and pages."
       }
     }
   }
 ]