From 3687062ee6f2ce2fe9f7ad036d388d77d2e90e88 Mon Sep 17 00:00:00 2001
From: "cbentzel@chromium.org"
 <cbentzel@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98>
Date: Thu, 20 Oct 2011 19:35:27 +0000
Subject: Add asyncBlocking support to webRequest event listeners.

If an event listener is registered with "asyncBlocking" listed in the extraInfoSpec, then a callback is passed into the listener in addition to the details argument. The callback expects a BlockingResponse argument, and MUST be invoked by the listener at some point so the request can proceed.

This is supported for the onAuthRequired listener only at this point.

BUG=32056
TEST=Write an extension with an onAuthRequired listener set with "asyncBlocking" in the extra parameters, validate that it works.


Review URL: http://codereview.chromium.org/8354014

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@106543 0039d316-1c4b-4281-b951-d872f2087c98
---
 .../extensions/docs/experimental.webRequest.html   | 74 +++++++++++++++++++++-
 1 file changed, 72 insertions(+), 2 deletions(-)

(limited to 'chrome/common/extensions/docs/experimental.webRequest.html')

diff --git a/chrome/common/extensions/docs/experimental.webRequest.html b/chrome/common/extensions/docs/experimental.webRequest.html
index e8608d5..edb09fd 100644
--- a/chrome/common/extensions/docs/experimental.webRequest.html
+++ b/chrome/common/extensions/docs/experimental.webRequest.html
@@ -999,7 +999,7 @@ chrome.windows.onRemoved.addListener(
 
               <div class="summary">
                 <!-- Note: intentionally longer 80 columns -->
-                <span class="subdued">chrome.experimental.webRequest.</span><span>onAuthRequired</span><span class="subdued">.addListener</span>(function(<span>object details</span>) <span class="subdued">{...}</span><span>, RequestFilter filter, array of string extraInfoSpec</span>);
+                <span class="subdued">chrome.experimental.webRequest.</span><span>onAuthRequired</span><span class="subdued">.addListener</span>(function(<span>object details, function callback</span>) <span class="subdued">{...}</span><span>, RequestFilter filter, array of string extraInfoSpec</span>);
               </div>
 
               <div class="description">
@@ -2100,6 +2100,76 @@ chrome.windows.onRemoved.addListener(
           </dd>
 
         </div>
+                    </div><div>
+                      <div>
+          <dt>
+            <var>callback</var>
+              <em>
+
+                <!-- TYPE -->
+                <div style="display:inline">
+                  (
+                    <span class="optional">optional</span>
+                    <span class="enum" style="display: none; ">enumerated</span>
+                    <span id="typeTemplate">
+                      <span style="display: none; ">
+                        <a> Type</a>
+                      </span>
+                      <span>
+                        <span style="display: none; ">
+                          array of <span><span></span></span>
+                        </span>
+                        <span>function</span>
+                        <span style="display: none; "></span>
+                      </span>
+                    </span>
+                  )
+                </div>
+
+              </em>
+          </dt>
+          <dd class="todo">
+            Undocumented.
+          </dd>
+          <dd style="display: none; ">
+            Description of this parameter from the json schema.
+          </dd>
+          <dd style="display: none; ">
+            This parameter was added in version
+            <b><span></span></b>.
+            You must omit this parameter in earlier versions,
+            and you may omit it in any version.  If you require this
+            parameter, the manifest key
+            <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a>
+            can ensure that your extension won't be run in an earlier browser version.
+          </dd>
+
+          <!-- OBJECT PROPERTIES -->
+          <dd style="display: none; ">
+            <dl>
+              <div>
+                <div>
+                </div>
+              </div>
+            </dl>
+          </dd>
+
+          <!-- OBJECT METHODS -->
+          <dd style="display: none; ">
+            <div></div>
+          </dd>
+
+          <!-- OBJECT EVENT FIELDS -->
+          <dd style="display: none; ">
+            <div></div>
+          </dd>
+
+          <!-- FUNCTION PARAMETERS -->
+          <dd style="display: none; ">
+            <div></div>
+          </dd>
+
+        </div>
                     </div>
                   </dl>
                 </div>
@@ -2202,7 +2272,7 @@ chrome.windows.onRemoved.addListener(
                           array of <span><span></span></span>
                         </span>
                         <span>string</span>
-                        <span>["responseHeaders", "blocking"]</span>
+                        <span>["responseHeaders", "blocking", "asyncBlocking"]</span>
                       </span>
                     </span></span>
                         </span>
-- 
cgit v1.1