Feat: Expose HTTPRequest intercept resolution state and clarify docs

[benallfree]

What kind of change does this PR introduce?

New API methods on HTTPRequest

Did you add tests for your changes?

Yes

If relevant, did you update the documentation?

Yes

Summary

#6735 introduced cooperative request intercepts and we are now starting to see adoption. puppeteer-extra just started berstend/puppeteer-extra#592 their support for cooperative mode. In the course of doing so, it became clear that exposing the intercept resolution state would be helpful along with a few doc clarifications.

Does this PR introduce a breaking change?

No

Other information

Requesting review by @jschfflr in particular :)

[benallfree]

@FdezRomero Please sign the CLA now that your name is in the commit history :) https://cla.developers.google.com/

[benallfree]

Hello @remusao and @Kikobeats from ghostery/adblocker#2281 and microlinkhq/browserless#321 :)

You are among the first to implement cooperative mode support, I would love to get your feedback/review on this PR.

[FdezRomero]

LGTM! Thanks for the improvements 👍🏻

[benallfree]

@FdezRomero CI is failing and awaiting your CLA, I wasn’t sure if you saw that.

[FdezRomero]

@benallfree Yes, I did and I signed the CLA, but I can't get the bot to rescan it. I tried with @googlebot rescan but didn't work, so I think it would fix itself if you do another commit.

[Tyler-Murphy]

I'm happy for it to be in any version. Probably needs to be v13 now, since v12 was just released.

[benallfree]

@Tyler-Murphy Spelling error fix moved to #7813 for v13 and removed from this PR so we can do this as a dot release. Thanks for that catch!

[benallfree]

@Androbin @OrKoN are either of you able to approve this PR? I’m looking for someone to review it.

[OrKoN]

I will try to find some time to review PRs next week.

[OrKoN]

@sadym-chromium could you PTAL as well?

[sadym-chromium]

Great work, thanks! I just got a bit confused by the Discussion prefix in the Discussion: Cooperative Request Continuation header.

[benallfree]

@sadym-chromium Fixed, thank you! 👍