Document Dart HTTP response header handling

[randomizedcoder]

Document the dart client HTTP response header handling, to help with issue: https://github.com/dart-lang/http/issues/726

---

• [ X] I’ve reviewed the contributor guide and applied the relevant portions to this PR.

Contribution guidelines:

• See our contributor guide for general expectations for PRs.
• Larger or significant changes should be discussed in an issue before creating a PR.
• Contributions to our repos should follow the Dart style guide and use dart format.
• Most changes should add an entry to the changelog and may need to rev the pubspec package version.
• Changes to packages require corresponding tests.

Note that many Dart repos have a weekly cadence for reviewing PRs - please allow for some latency before initial review feedback.

[google-cla[bot]]

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

[randomizedcoder]

Thanks Brian.

How about this: https://github.com/dart-lang/http/pull/1083

On Mon, Dec 11, 2023 at 4:23 PM Brian Quinlan @.***> wrote:

@.**** commented on this pull request.

In pkgs/http/CHANGELOG.md https://github.com/dart-lang/http/pull/1062#discussion_r1423261918:

@@ -1,234 +1,238 @@ +## 1.1.3

+- Document HTTP client response header handling

It looks like you replaced "" with "-" - it is "" at HEAD: https://github.com/dart-lang/http/blob/master/pkgs/http/CHANGELOG.md?plain=1

Could you change the version to: 1.1.3-wip

And make the same change in pubspec.yaml

In pkgs/http/lib/src/base_response.dart https://github.com/dart-lang/http/pull/1062#discussion_r1423263792:

@@ -46,6 +46,19 @@ 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.

• ///
• /// Please keep in mind that the Dart HTTP client is likely to be running side

I think that this might be too verbose. How about:

Some headers may be excluded by the client for security or privacy reasons. For example, browser-cased clients can only return headers in the CORS safelist or specifically allowed by the server.

— Reply to this email directly, view it on GitHub https://github.com/dart-lang/http/pull/1062#pullrequestreview-1776386255, or unsubscribe https://github.com/notifications/unsubscribe-auth/APMCHTXH5VSURHESGAXQB33YI6PXJAVCNFSM6AAAAABABUCSK2VHI2DSMVQWIX3LMV43YUDVNRWFEZLROVSXG5CSMV3GSZLXHMYTONZWGM4DMMRVGU . You are receiving this because you authored the thread.Message ID: @.***>

-- Regards, Dave Seddon +1 415 857 5102