|
1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ |
|
2 /* This Source Code Form is subject to the terms of the Mozilla Public |
|
3 * License, v. 2.0. If a copy of the MPL was not distributed with this |
|
4 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ |
|
5 |
|
6 #include "nsISupports.idl" |
|
7 |
|
8 interface nsIChannel; |
|
9 interface nsIHttpChannel; |
|
10 interface nsIURI; |
|
11 |
|
12 /** |
|
13 * nsIHttpEventSink |
|
14 * |
|
15 * Implement this interface to receive control over various HTTP events. The |
|
16 * HTTP channel will try to get this interface from its notificationCallbacks |
|
17 * attribute, and if it doesn't find it there it will look for it from its |
|
18 * loadGroup's notificationCallbacks attribute. |
|
19 * |
|
20 * These methods are called before onStartRequest, and should be handled |
|
21 * SYNCHRONOUSLY. |
|
22 * |
|
23 * @deprecated Newly written code should use nsIChannelEventSink instead of this |
|
24 * interface. |
|
25 */ |
|
26 [scriptable, uuid(9475a6af-6352-4251-90f9-d65b1cd2ea15)] |
|
27 interface nsIHttpEventSink : nsISupports |
|
28 { |
|
29 /** |
|
30 * Called when a redirect occurs due to a HTTP response like 302. The |
|
31 * redirection may be to a non-http channel. |
|
32 * |
|
33 * @return failure cancels redirect |
|
34 */ |
|
35 void onRedirect(in nsIHttpChannel httpChannel, |
|
36 in nsIChannel newChannel); |
|
37 }; |