Re: [whatwg/fetch] Describe filtered responses better (PR #1513)

@domenic commented on this pull request.



> @@ -2371,6 +2382,32 @@ is a <a>filtered response</a> whose
  <a attribute for=Response lt=ok><code>response.ok</code></a>, will return rather useless results.
 </div>
 
+<div class=example id=example-filtered-responses>
+ <p>The <a for=response>type</a> of a <a for=/>response</a> is exposed to script through the
+ {{Response/type}} getter:
+
+ <pre><code class=lang-javascript>
+(async function filteredResponseDemo() {

You can assume top-level await now, IMO, so the wrapper is no longer necessary :).

> @@ -2304,18 +2304,29 @@ known as an <dfn export id=concept-aborted-network-error>aborted network error</
 
 <hr>
 
-<p>A <dfn export id=concept-filtered-response>filtered response</dfn> is a limited view on a
-<a for=/>response</a> that is not a
-<a>network error</a>. This
-<a for=/>response</a> is referred to as the
-<a>filtered response</a>'s associated
-<dfn export id=concept-internal-response for="filtered response">internal response</dfn>.
-
-<p class="note no-backref">The <a for=/>fetch</a> algorithm returns such a view to ensure APIs do
-not accidentally leak information. If the information needs to be exposed for legacy reasons, e.g.,
-to feed image data to a decoder, the associated <a for="filtered response">internal response</a> can
-be used, which is only "accessible" to internal specification algorithms and is never a
-<a>filtered response</a> itself.
+<p>A <dfn export id=concept-filtered-response>filtered response</dfn> is a <a for=/>response</a>
+that offers a limited view on an associated <a for=/>response</a>. This associated
+<a for=/>response</a> can be accessed through <a>filtered response</a>'s associated

```suggestion
<a for=/>response</a> can be accessed through <a>filtered response</a>'s
```

to reduce the repetition of "associated"

-- 
Reply to this email directly or view it on GitHub:
https://github.com/whatwg/fetch/pull/1513#pullrequestreview-1153907552
You are receiving this because you are subscribed to this thread.

Message ID: <whatwg/fetch/pull/1513/review/1153907552@github.com>