http headers comment

dart-lang · Dec 17, 2023 · da8e5f7 · da8e5f7
1 parent c114aa0
commit da8e5f7
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/pkgs/http/lib/src/base_response.dart b/pkgs/http/lib/src/base_response.dart
@@ -46,6 +46,11 @@ abstract class BaseResponse {
   /// If a header value contains whitespace then that whitespace may be replaced
   /// by a single space. Leading and trailing whitespace in header values are
   /// always removed.
+  ///
+  /// Some headers may be excluded by the client for security or privacy
+  /// reasons. For example, browser-based clients can only return headers in the
+  /// CORS safelist or specifically allowed by the server.
+  ///
   // TODO(nweiz): make this a HttpHeaders object.
   final Map<String, String> headers;