iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more
Angular warning NG02802 means browser-side code read a response header that was not included in the server-rendered HttpTransferCache entry. Angular transfers no response headers by default. If the browser needs the header, add only that header to includeHeaders; otherwise, remove or relocate the access.
What NG02802 means
During server-side rendering, Angular can cache eligible HttpClient responses and reuse them as the browser application starts, avoiding a duplicate request. The transfer cache does not include response headers by default. If browser code accesses a header that is absent from the transferred response, Angular reports NG02802 and identifies the header and request URL. Angular documents this default as a way to avoid potential security issues and unnecessary data transfer. See the NG02802 error guide and the Angular SSR guide.
Choose whether the browser needs the header
- It does not: Remove the client-side header access or move it to code that runs on the server. This avoids transferring data the browser does not need.
- It does: Include the specific response header in the transfer-cache configuration. Avoid including sensitive values, such as authentication tokens, unless your security design explicitly permits exposing them to browser code.
Include a response header in the transfer cache
Use the casing shown in your application or Angular’s examples; HTTP header names are case-insensitive. Include only the headers required by browser-side logic.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
For one request
Set transferCache.includeHeaders in that request’s options:
#1 Best Overall
- The Anker Advantage: Join the 65 million+ powered by our leading technology.
- Instant Internet: Connect to the internet instantly from virtually any USB-C 3.0 device, and enjoy stable connection speeds of up to 1 Gbps.
- Lightweight and Compact: The space-saving and portable design measures just over half an inch thick and weighs about the same as a AA battery.
- Premium Build: Features a sleek aluminum exterior and braided-nylon cable to complement the design of high-end devices.
- What You Get: PowerExpand USB-C to Gigabit Ethernet Adapter, welcome guide, 18-month worry-free warranty, and friendly customer service.
this.http.get('/api/data', {
transferCache: { includeHeaders: ['cache-control', 'etag'] },
});This scopes the change to the request where the headers are needed. Angular documents this request-level option in its NG02802 guidance.
Across the application
Pass the headers to withHttpTransferCacheOptions in the hydration setup:
Rank #2
- USB-C Meets 1000Mbps Ethernet in Seconds：UGREEN usb c to ethernet adapter supports fast speeds up to 1000Mbps and is backward compatible with 100/10Mbps network. Perfect for work, gaming, streaming, or downloading with a stable, reliable wired connection
- Extend a Ethernet Port for Your Device：This ethernet to usb c adds a Gigabit RJ45 port to your device. It’s the perfect solution for new laptops without built-in Ethernet, devices with damaged LAN ports, or when WiFi is unavailable or unstable
- Plug and Play: This Ethernet adapter is driver-free for Windows 11/10/8.1/8, macOS, Chrome OS, and Android. Drivers are required for Windows XP/7/Vista and Linux, and can be easily installed using our instructions. LED indicator shows status at a glance
- Small Adapter, Big Attention to Detail: The usb c to ethernet features a durable aluminum alloy case for faster heat dissipation than plastic. Its reinforced cable tail and wear-resistant port ensure long-lasting durability. Compact size and easy to carry
- Widely Compatible: The usbc to ethernet adapter is compatible with most laptops, tablets, smartphones, Nintendo Switch, and Steam Deck with USB-C or Thunderbolt 4/3 port, like MacBook Pro/Air, XPS, iPhone 17/16/15 Pro/Pro Max, Mac Mini, Chromebook, iPad
provideClientHydration(
withHttpTransferCacheOptions({
includeHeaders: ['ETag', 'Cache-Control'],
}),
);The SSR guide documents this application-wide configuration. A request’s own transferCache option can override the global transfer-cache settings for that request; see HttpTransferCacheOptions. Check the API documentation for the Angular version used by your application.
Do these 3 things before closing this tab:
1Clear out junk files and repair common Windows errors2Fix the driver behind crashes, sound loss and screen glitches3Repair Windows errors before they cause bigger problemsCheck that the response is eligible for transfer caching
Adding a header to includeHeaders addresses which response headers are transferred; it does not make an otherwise ineligible request cacheable. Angular’s SSR guide says GET and HEAD requests are cached by default when eligible. By default, the transfer cache excludes requests with Authorization, Proxy-Authorization, or Cookie headers; requests using credential modes that send credentials; requests or responses with cache-control directives such as no-store, no-cache, or private; and responses containing Set-Cookie. Review the SSR guide if the expected response is not being reused.
Rank #3
- Adapter for converting a USB 3.1 Type-C port to a RJ45 Gigabit Ethernet port
- Integrated Ethernet port supports 10M/100M/1000M bandwidth; offers instant Internet connection to the host
- USB-C input allows for reversible plugging; offers complete compatibility with current computers and devices; compatible with Nintendo Switch
- Ready to use, right out of the box; no external power adapter needed
- Slim, compact size and lightweight aluminum housing for easy portability
When server and browser API origins differ
If the server and browser address the same API through different origins, Angular may not recognize the requests as matching for cache reuse. The HTTP_TRANSFER_CACHE_ORIGIN_MAP token can map the server origin to the client origin. Angular specifies that this token should be provided only in server code. This is a separate origin-matching consideration, not the fix for NG02802 itself; see the HTTP_TRANSFER_CACHE_ORIGIN_MAP API reference.
Quick Recap
Best Value
- 【Reliable & Endurance Connectivity】Designed specifically for plug-and-play connection between USB-C devices and wired network, provides gigabit ethernet connectivity even when wireless connectivity is Inconsistent or over extended.
- 【Surfing at Full Speed】Obtain stable connection speeds up to 1Gbps; downward compatible with 100Mbps/10Mbps networks. Our Type-C to LAN Gigabit Ethernet (RJ45) Network Adapter supports large downloads at maximum speeds without interruption.✅ To reach 1Gbps, make sure to use CAT6 & up Ethernet cables.
- 【Compact & Friendly Design】Compact and lightweight, with a user-friendly non-slip design for easier plug and unplug. Braided nylon cable for extra durability. Premium aluminum casing for better heat insulation. Fits snugly with the USB-C ports on your devices, better signal transfer protection.
- 【Wide Compatibility】Compatible with iPhone 15 Series, MacBook Pro 16''/15” (2023/2022/2021/2020/2019/2018/2017), MacBook (2019/2018/2017), MacBook Air 13” (2022/2018), iPad Pro (2022/2020/2018); XPS 13/15/17; Surface Book 2; Google Pixelbook, Chromebook, Pixel, Pixel 2; Asus ZenBook. Compatible with Samsung S20/S10/S9/S8/S8+, Note 8/9, Galaxy Tablet Tab A 10.5, and many other USB-C laptops, tablets, and smartphones. (NOT compatible with Nintendo Switch.)
- 【18 MONTH WARRANTY】: Exclusive BENFEI Unconditional 18-month Warranty ensures long-time satisfaction of your purchase; Friendly and easy-to-reach customer service to solve your problems timely
Rank #4
- 𝐇𝐢𝐠𝐡-𝐒𝐩𝐞𝐞𝐝 𝐔𝐒𝐁-𝐂 𝐄𝐭𝐡𝐞𝐫𝐧𝐞𝐭 𝐀𝐝𝐚𝐩𝐭𝐞𝐫 - Instantly transform your laptop or tablet’s USB-C port into a reliable wired connection with a 10/100/1000 Mbps RJ45 Ethernet port. Perfect for replacing unstable Wi-Fi in situations that require uninterrupted connectivity, such as online meetings, gaming, and media streaming.
- 𝐔𝐒𝐁-𝐂 𝟑.𝟎 𝐟𝐨𝐫 𝐅𝐚𝐬𝐭𝐞𝐫, 𝐌𝐨𝐫𝐞 𝐒𝐭𝐚𝐛𝐥𝐞 𝐂𝐨𝐧𝐧𝐞𝐜𝐭𝐢𝐨𝐧𝐬 - Experience full Gigabit Ethernet performance over your laptop’s USB-C 3.0 port and elevate your browsing experience to transfer files, play games, video chat, and stream HD videos seamlessly. (To reach 1Gbps, please use CAT6 or up Ethernet cables.)
- 𝐔𝐥𝐭𝐫𝐚-𝐂𝐨𝐦𝐩𝐚𝐜𝐭 𝐚𝐧𝐝 𝐅𝐨𝐥𝐝𝐚𝐛𝐥𝐞 𝐃𝐞𝐬𝐢𝐠𝐧 - At just 2.8 x 1.0 x 0.6 inches, the UE300C slips easily into your laptop bag or pocket. The lightweight yet durable build makes it perfect for travel, remote work, or quick setup in conference rooms.
- 𝐏𝐥𝐮𝐠 𝐚𝐧𝐝 𝐏𝐥𝐚𝐲- No driver required for Windows 11/10/8.1/8/7, macOS, Chrome OS, and Linux (Ubuntu). Simply connect and enjoy instant wired internet access without complicated setup.
- 𝐁𝐫𝐨𝐚𝐝 𝐃𝐞𝐯𝐢𝐜𝐞 𝐂𝐨𝐦𝐩𝐚𝐭𝐢𝐛𝐢𝐥𝐢𝐭𝐲- Works seamlessly with most USB-C devices, including MacBook Pro/Air, iPad Pro, Dell XPS, Surface Laptop, Chromebook, and more—making it a versatile network upgrade for home, office, or on-the-go use.
Diagnose the warning efficiently
- Read the header name and request URL in the NG02802 message.
- Find the browser-side code that reads that response header and decide whether it needs to run in the browser.
- If the value is unnecessary in the browser, remove or relocate the access. If it is needed, add only that header to the request’s
transferCache.includeHeadersor to the global hydration options. - If the response still is not reused, check request eligibility and whether server and browser origins need mapping.
- Confirm the option names and behavior against the Angular documentation for the version in your project.
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
