OLD | NEW |
1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 // This is the list of load flags and their values. For the enum values, | 5 // This is the list of load flags and their values. For the enum values, |
6 // include the file "net/base/load_flags.h". | 6 // include the file "net/base/load_flags.h". |
7 // | 7 // |
8 // Here we define the values using a macro LOAD_FLAG, so it can be | 8 // Here we define the values using a macro LOAD_FLAG, so it can be |
9 // expanded differently in some places (for example, to automatically | 9 // expanded differently in some places (for example, to automatically |
10 // map a load flag value to its symbolic name). | 10 // map a load flag value to its symbolic name). |
11 | 11 |
12 LOAD_FLAG(NORMAL, 0) | 12 LOAD_FLAG(NORMAL, 0) |
13 | 13 |
14 // This is "normal reload", meaning an if-none-match/if-modified-since query | 14 // This is "normal reload", meaning an if-none-match/if-modified-since query |
15 LOAD_FLAG(VALIDATE_CACHE, 1 << 0) | 15 LOAD_FLAG(VALIDATE_CACHE, 1 << 0) |
16 | 16 |
17 // This is "shift-reload", meaning a "pragma: no-cache" end-to-end fetch | 17 // This is "shift-reload", meaning a "pragma: no-cache" end-to-end fetch |
18 LOAD_FLAG(BYPASS_CACHE, 1 << 1) | 18 LOAD_FLAG(BYPASS_CACHE, 1 << 1) |
19 | 19 |
20 // This is a back/forward style navigation where the cached content should | 20 // This is a back/forward style navigation where the cached content should |
21 // be preferred over any protocol specific cache validation. | 21 // be preferred over any protocol specific cache validation. |
22 LOAD_FLAG(PREFERRING_CACHE, 1 << 2) | 22 LOAD_FLAG(PREFERRING_CACHE, 1 << 2) |
23 | 23 |
24 // This is a navigation that will fail if it cannot serve the requested | 24 // This is a navigation that will fail if it cannot serve the requested |
25 // resource from the cache (or some equivalent local store). | 25 // resource from the cache (or some equivalent local store). |
26 LOAD_FLAG(ONLY_FROM_CACHE, 1 << 3) | 26 LOAD_FLAG(ONLY_FROM_CACHE, 1 << 3) |
27 | 27 |
| 28 // Indicate that if the request fails at the network level in a way that |
| 29 // indicates the source is unreachable, the request should fail over |
| 30 // to as if LOAD_PREFERRING_CACHE had been set. |
| 31 LOAD_FLAG(FROM_CACHE_IF_OFFLINE, 1 << 4) |
| 32 |
28 // This is a navigation that will not use the cache at all. It does not | 33 // This is a navigation that will not use the cache at all. It does not |
29 // impact the HTTP request headers. | 34 // impact the HTTP request headers. |
30 LOAD_FLAG(DISABLE_CACHE, 1 << 4) | 35 LOAD_FLAG(DISABLE_CACHE, 1 << 5) |
31 | 36 |
32 // This is a navigation that will not be intercepted by any registered | 37 // This is a navigation that will not be intercepted by any registered |
33 // URLRequest::Interceptors. | 38 // URLRequest::Interceptors. |
34 LOAD_FLAG(DISABLE_INTERCEPT, 1 << 5) | 39 LOAD_FLAG(DISABLE_INTERCEPT, 1 << 6) |
35 | 40 |
36 // If present, upload progress messages should be provided to initiator. | 41 // If present, upload progress messages should be provided to initiator. |
37 LOAD_FLAG(ENABLE_UPLOAD_PROGRESS, 1 << 6) | 42 LOAD_FLAG(ENABLE_UPLOAD_PROGRESS, 1 << 7) |
38 | 43 |
39 // If present, collect load timing for the request. | 44 // If present, collect load timing for the request. |
40 LOAD_FLAG(ENABLE_LOAD_TIMING, 1 << 7) | 45 LOAD_FLAG(ENABLE_LOAD_TIMING, 1 << 8) |
41 | 46 |
42 // If present, ignores certificate mismatches with the domain name. | 47 // If present, ignores certificate mismatches with the domain name. |
43 // (The default behavior is to trigger an OnSSLCertificateError callback.) | 48 // (The default behavior is to trigger an OnSSLCertificateError callback.) |
44 LOAD_FLAG(IGNORE_CERT_COMMON_NAME_INVALID, 1 << 8) | 49 LOAD_FLAG(IGNORE_CERT_COMMON_NAME_INVALID, 1 << 9) |
45 | 50 |
46 // If present, ignores certificate expiration dates | 51 // If present, ignores certificate expiration dates |
47 // (The default behavior is to trigger an OnSSLCertificateError callback). | 52 // (The default behavior is to trigger an OnSSLCertificateError callback). |
48 LOAD_FLAG(IGNORE_CERT_DATE_INVALID, 1 << 9) | 53 LOAD_FLAG(IGNORE_CERT_DATE_INVALID, 1 << 10) |
49 | 54 |
50 // If present, trusts all certificate authorities | 55 // If present, trusts all certificate authorities |
51 // (The default behavior is to trigger an OnSSLCertificateError callback). | 56 // (The default behavior is to trigger an OnSSLCertificateError callback). |
52 LOAD_FLAG(IGNORE_CERT_AUTHORITY_INVALID, 1 << 10) | 57 LOAD_FLAG(IGNORE_CERT_AUTHORITY_INVALID, 1 << 11) |
53 | 58 |
54 // If present, causes certificate revocation checks to be skipped on secure | 59 // If present, causes certificate revocation checks to be skipped on secure |
55 // connections. | 60 // connections. |
56 LOAD_FLAG(DISABLE_CERT_REVOCATION_CHECKING, 1 << 11) | 61 LOAD_FLAG(DISABLE_CERT_REVOCATION_CHECKING, 1 << 12) |
57 | 62 |
58 // If present, ignores wrong key usage of the certificate | 63 // If present, ignores wrong key usage of the certificate |
59 // (The default behavior is to trigger an OnSSLCertificateError callback). | 64 // (The default behavior is to trigger an OnSSLCertificateError callback). |
60 LOAD_FLAG(IGNORE_CERT_WRONG_USAGE, 1 << 12) | 65 LOAD_FLAG(IGNORE_CERT_WRONG_USAGE, 1 << 13) |
61 | 66 |
62 // This load will not make any changes to cookies, including storing new | 67 // This load will not make any changes to cookies, including storing new |
63 // cookies or updating existing ones. | 68 // cookies or updating existing ones. |
64 LOAD_FLAG(DO_NOT_SAVE_COOKIES, 1 << 13) | 69 LOAD_FLAG(DO_NOT_SAVE_COOKIES, 1 << 14) |
65 | 70 |
66 // Do not resolve proxies. This override is used when downloading PAC files | 71 // Do not resolve proxies. This override is used when downloading PAC files |
67 // to avoid having a circular dependency. | 72 // to avoid having a circular dependency. |
68 LOAD_FLAG(BYPASS_PROXY, 1 << 14) | 73 LOAD_FLAG(BYPASS_PROXY, 1 << 15) |
69 | 74 |
70 // Indicate this request is for a download, as opposed to viewing. | 75 // Indicate this request is for a download, as opposed to viewing. |
71 LOAD_FLAG(IS_DOWNLOAD, 1 << 15) | 76 LOAD_FLAG(IS_DOWNLOAD, 1 << 16) |
72 | 77 |
73 // Requires EV certificate verification. | 78 // Requires EV certificate verification. |
74 LOAD_FLAG(VERIFY_EV_CERT, 1 << 16) | 79 LOAD_FLAG(VERIFY_EV_CERT, 1 << 17) |
75 | 80 |
76 // This load will not send any cookies. | 81 // This load will not send any cookies. |
77 LOAD_FLAG(DO_NOT_SEND_COOKIES, 1 << 17) | 82 LOAD_FLAG(DO_NOT_SEND_COOKIES, 1 << 18) |
78 | 83 |
79 // This load will not send authentication data (user name/password) | 84 // This load will not send authentication data (user name/password) |
80 // to the server (as opposed to the proxy). | 85 // to the server (as opposed to the proxy). |
81 LOAD_FLAG(DO_NOT_SEND_AUTH_DATA, 1 << 18) | 86 LOAD_FLAG(DO_NOT_SEND_AUTH_DATA, 1 << 19) |
82 | 87 |
83 // This should only be used for testing (set by HttpNetworkTransaction). | 88 // This should only be used for testing (set by HttpNetworkTransaction). |
84 LOAD_FLAG(IGNORE_ALL_CERT_ERRORS, 1 << 19) | 89 LOAD_FLAG(IGNORE_ALL_CERT_ERRORS, 1 << 20) |
85 | 90 |
86 // Indicate that this is a top level frame, so that we don't assume it is a | 91 // Indicate that this is a top level frame, so that we don't assume it is a |
87 // subresource and speculatively pre-connect or pre-resolve when a referring | 92 // subresource and speculatively pre-connect or pre-resolve when a referring |
88 // page is loaded. | 93 // page is loaded. |
89 LOAD_FLAG(MAIN_FRAME, 1 << 20) | 94 LOAD_FLAG(MAIN_FRAME, 1 << 21) |
90 | 95 |
91 // Indicate that this is a sub frame, and hence it might have subresources that | 96 // Indicate that this is a sub frame, and hence it might have subresources that |
92 // should be speculatively resolved, or even speculatively preconnected. | 97 // should be speculatively resolved, or even speculatively preconnected. |
93 LOAD_FLAG(SUB_FRAME, 1 << 21) | 98 LOAD_FLAG(SUB_FRAME, 1 << 22) |
94 | 99 |
95 // If present, intercept actual request/response headers from network stack | 100 // If present, intercept actual request/response headers from network stack |
96 // and report them to renderer. This includes cookies, so the flag is only | 101 // and report them to renderer. This includes cookies, so the flag is only |
97 // respected if renderer has CanReadRawCookies capability in the security | 102 // respected if renderer has CanReadRawCookies capability in the security |
98 // policy. | 103 // policy. |
99 LOAD_FLAG(REPORT_RAW_HEADERS, 1 << 22) | 104 LOAD_FLAG(REPORT_RAW_HEADERS, 1 << 23) |
100 | 105 |
101 // Indicates that this load was motivated by the rel=prefetch feature, | 106 // Indicates that this load was motivated by the rel=prefetch feature, |
102 // and is (in theory) not intended for the current frame. | 107 // and is (in theory) not intended for the current frame. |
103 LOAD_FLAG(PREFETCH, 1 << 23) | 108 LOAD_FLAG(PREFETCH, 1 << 24) |
104 | 109 |
105 // Indicates that this is a load that ignores limits and should complete | 110 // Indicates that this is a load that ignores limits and should complete |
106 // immediately. | 111 // immediately. |
107 LOAD_FLAG(IGNORE_LIMITS, 1 << 24) | 112 LOAD_FLAG(IGNORE_LIMITS, 1 << 25) |
108 | 113 |
109 // Suppress login prompts for this request. Cached credentials or | 114 // Suppress login prompts for this request. Cached credentials or |
110 // default credentials may still be used for authentication. | 115 // default credentials may still be used for authentication. |
111 LOAD_FLAG(DO_NOT_PROMPT_FOR_LOGIN, 1 << 25) | 116 LOAD_FLAG(DO_NOT_PROMPT_FOR_LOGIN, 1 << 26) |
112 | 117 |
113 // Indicates that the operation is somewhat likely to be due to an | 118 // Indicates that the operation is somewhat likely to be due to an |
114 // explicit user action. This can be used as a hint to treat the | 119 // explicit user action. This can be used as a hint to treat the |
115 // request with higher priority. | 120 // request with higher priority. |
116 LOAD_FLAG(MAYBE_USER_GESTURE, 1 << 26) | 121 LOAD_FLAG(MAYBE_USER_GESTURE, 1 << 27) |
OLD | NEW |