blob: 8c532217ed17f1222dd3c2fb549575acfdf8085c [file] [log] [blame] [view]
eroman96211952016-02-22 21:42:031# Chrome Network Bug Triage : Components and labels
asankaddd5dc22015-03-20 15:52:402
eroman96211952016-02-22 21:42:033## Some network component caveats
asankaddd5dc22015-03-20 15:52:404
eroman96211952016-02-22 21:42:035**UI>Browser>Downloads**
asankaddd5dc22015-03-20 15:52:406: Despite the name, this covers all issues related to downloading a file except
eroman96211952016-02-22 21:42:037 saving entire pages (which is **Blink>SavePage**), not just UI issues.
asankaddd5dc22015-03-20 15:52:408 Most downloads bugs will have the word "download" or "save as" in the
9 description. Issues with the HTTP server for the Chrome binaries are not
10 downloads bugs.
11
eroman96211952016-02-22 21:42:0312**UI>Browser>SafeBrowsing**
asankaddd5dc22015-03-20 15:52:4013: Bugs that have to do with the process by which a URL or file is determined to
14 be dangerous based on our databases, or the resulting interstitials.
15 Determination of danger based purely on content-type or file extension
eroman96211952016-02-22 21:42:0316 belongs in **UI>Browser>Downloads**, not SafeBrowsing.
asankaddd5dc22015-03-20 15:52:4017
eroman96211952016-02-22 21:42:0318**Internals>Network>SSL**
19: This includes issues that should be also tagged as **Security>UX**
asankaddd5dc22015-03-20 15:52:4020 (certificate error pages or other security interstitials, omnibox indicators
21 that a page is secure), and more general SSL issues. If you see requests
22 that die in the SSL negotiation phase, in particular, this is often the
eroman96211952016-02-22 21:42:0323 correct component.
asankaddd5dc22015-03-20 15:52:4024
eroman96211952016-02-22 21:42:0325**Internals>Network>DataProxy**
asankaddd5dc22015-03-20 15:52:4026: Flywheel / the Data Reduction Proxy. Issues require "Reduce Data Usage" be
27 turned on. Proxy url is [https://proxy.googlezip.net:443](), with
28 [http://compress.googlezip.net:80]() as a fallback. Currently Android and
29 iOS only.
30
eroman96211952016-02-22 21:42:0331**Internals>Network>Cache**
asankaddd5dc22015-03-20 15:52:4032: The cache is the layer that handles most range request logic (Though range
33 requests may also be issued by the PDF plugin, XHRs, or other components).
34
eroman96211952016-02-22 21:42:0335**Internals>Network>SPDY**
asankaddd5dc22015-03-20 15:52:4036: Covers HTTP2 as well.
37
eroman96211952016-02-22 21:42:0338**Internals>Network>HTTP**
asankaddd5dc22015-03-20 15:52:4039: Typically not used. Unclear what it covers, and there's no specific HTTP
40 owner.
41
eroman96211952016-02-22 21:42:0342**Internals>Network>Logging**
asankaddd5dc22015-03-20 15:52:4043: Covers **about:net-internals**, **about:net-export** as well as the what's
44 sent to the NetLog.
45
eroman96211952016-02-22 21:42:0346**Internals>Network>Connectivity**
asankaddd5dc22015-03-20 15:52:4047: Issues related to switching between networks, ERR_NETWORK_CHANGED, Chrome
48 thinking it's online when it's not / navigator.onLine inaccuracies, etc.
49
eroman96211952016-02-22 21:42:0350**Internals>Network>Filters**
asankaddd5dc22015-03-20 15:52:4051: Covers SDCH and gzip issues. ERR_CONTENT_DECODING_FAILED indicates a problem
52 at this layer, and bugs here can also cause response body corruption.
53
eroman96211952016-02-22 21:42:0354## Common non-network components
asankaddd5dc22015-03-20 15:52:4055
eroman96211952016-02-22 21:42:0356Bugs in these areas often receive the **Internals>Network** component, though
asankaddd5dc22015-03-20 15:52:4057they fall largely outside the purview of the network stack team:
58
eroman96211952016-02-22 21:42:0359**Blink>Forms**
asankaddd5dc22015-03-20 15:52:4060: Issues submitting forms, forms having weird data, forms sending the wrong
61 method, etc.
62
eroman96211952016-02-22 21:42:0363**Blink>Loader**
asankaddd5dc22015-03-20 15:52:4064: Cross origin issues are sometimes loader related. Blink also has an
65 in-memory cache, and when it's used, requests don't appear in
66 about:net-internals. Requests for the same URL are also often merged there
67 as well. This does *not* cover issues with content/browser/loader/ files.
68
eroman96211952016-02-22 21:42:0369**Blink>ServiceWorker**
asankaddd5dc22015-03-20 15:52:4070
eroman96211952016-02-22 21:42:0371**Blink>Storage>AppCache**
asankaddd5dc22015-03-20 15:52:4072
eroman96211952016-02-22 21:42:0373**Blink>Network>WebSockets**
74: Issues with the WebSockets. Attach this component to any issue about the
tyoshinoc1ece4b2015-12-01 10:52:5275 WebSocket feature regardless of where the cause of the issue is (net/ or
76 Blink).
asankaddd5dc22015-03-20 15:52:4077
eroman96211952016-02-22 21:42:0378**Blink>Network>FetchAPI**
tyoshinoc1ece4b2015-12-01 10:52:5279: Generic issues with the Fetch API - missing request or response
asankaddd5dc22015-03-20 15:52:4080 headers, multiple headers, etc. These will often run into issues in certain
eroman96211952016-02-22 21:42:0381 corner cases (Cross origin / CORS, proxy, whatever). Attach all components that
asankaddd5dc22015-03-20 15:52:4082 seem appropriate.
83
eroman96211952016-02-22 21:42:0384**Blink>Network>XHR**
tyoshinoc1ece4b2015-12-01 10:52:5285: Generic issues with sync/async XHR requests.
86
davidben62a1c86a2016-05-05 18:33:5187**Blink>WebRTC>Network**
88: Anything WebRTC-related does not use the net stack and should go here.
89
eroman96211952016-02-22 21:42:0390**Services>Sync**
asankaddd5dc22015-03-20 15:52:4091: Sharing data/tabs/history/passwords/etc between machines not working.
92
eroman96211952016-02-22 21:42:0393**Services>Chromoting**
asankaddd5dc22015-03-20 15:52:4094
eroman96211952016-02-22 21:42:0395**Platform>Extensions**
asankaddd5dc22015-03-20 15:52:4096: Issues extensions loading / not loading / hanging.
97
eroman96211952016-02-22 21:42:0398**Platform>Extensions>API**
99: Issues with network related extension APIs should have this component.
asankaddd5dc22015-03-20 15:52:40100 chrome.webRequest is the big one, I believe, but there are others.
101
eroman96211952016-02-22 21:42:03102**Internals>Plugins>Pepper[>SDK]**
asankaddd5dc22015-03-20 15:52:40103
eroman96211952016-02-22 21:42:03104**UI>Browser>Omnibox**
asankaddd5dc22015-03-20 15:52:40105: Basically any issue with the omnibox. URLs being treated as search queries
106 rather than navigations, dropdown results being weird, not handling certain
107 unicode characters, etc. If the issue is new TLDs not being recognized by
108 the omnibox, that's due to Chrome's TLD list being out of date, and not an
109 omnibox issue. Such TLD issues should be duped against
110 http://crbug.com/37436.
111
eroman96211952016-02-22 21:42:03112**Internals>Media>Network**
asankaddd5dc22015-03-20 15:52:40113: Issues related to media. These often run into the 6 requests per hostname
114 issue, and also have fun interactions with the cache, particularly in the
115 range request case.
116
eroman96211952016-02-22 21:42:03117**Internals>Plugins>PDF**
asankaddd5dc22015-03-20 15:52:40118: Issues loading pdf files. These are often related to range requests, which
eroman96211952016-02-22 21:42:03119 also have some logic at the Internals>Network>Cache layer.
asankaddd5dc22015-03-20 15:52:40120
eroman96211952016-02-22 21:42:03121**UI>Browser>Navigation**
asankaddd5dc22015-03-20 15:52:40122
eroman96211952016-02-22 21:42:03123**UI>Browser>History**
asankaddd5dc22015-03-20 15:52:40124: Issues which only appear with forward/back navigation.
125
eroman96211952016-02-22 21:42:03126**OS>Systems>Network** / **OS>Systems>Mobile** / **OS>Systems>Bluetooth**
asankaddd5dc22015-03-20 15:52:40127: These should be used for issues with ChromeOS's platform network code, and
128 not net/ issues on ChromeOS.
129
eroman96211952016-02-22 21:42:03130**Blink>SecurityFeature**
asankaddd5dc22015-03-20 15:52:40131: CORS / Cross origin issues. Main frame cross-origin navigation issues are
eroman96211952016-02-22 21:42:03132 often actually **UI>Browser>Navigation** issues.
asankaddd5dc22015-03-20 15:52:40133
eroman96211952016-02-22 21:42:03134**Privacy**
asankaddd5dc22015-03-20 15:52:40135: Privacy related bug (History, cookies discoverable by an entity that
136 shouldn't be able to do so, incognito state being saved in memory or on disk
137 beyond the lifetime of incognito tabs, etc). Generally used in conjunction
eroman96211952016-02-22 21:42:03138 with other components.
139
140## Common labels
asankaddd5dc22015-03-20 15:52:40141
142**Type-Bug-Security**
143: Security related bug (Allows for code execution from remote site, allows
eroman96211952016-02-22 21:42:03144 crossing security boundaries, unchecked array bounds, etc) should be tagged
145 with this label.