Skip to content

Commit 4e80053

Browse files
committed
Back to identifiers after httpwg/http-extensions#629.
1 parent de75307 commit 4e80053

File tree

2 files changed

+68
-53
lines changed

2 files changed

+68
-53
lines changed

index.bs

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -80,14 +80,14 @@ A request generated by a <{picture}> element would result in a request containin
8080
HTTP request header:
8181

8282
```
83-
Sec-Metadata: destination="image", site="cross-site"
83+
Sec-Metadata: destination=image, site=cross-site
8484
```
8585

8686
A top-level navigation from `https://example.com` to `https://example.com/` caused by a user's click
8787
on an in-page link would result in a request containing the following HTTP request header:
8888

8989
```
90-
Sec-Metadata: cause="user-activated", destination="document", site="same-origin"
90+
Sec-Metadata: cause=user-activated, destination=document, site=same-origin
9191
```
9292

9393
Framework {#framework}
@@ -113,7 +113,7 @@ unknown members, and members whose value is invalid.
113113

114114
[=Navigation requests=] will contain a dictionary member whose key is
115115
"<dfn dict-member for="Sec-Metadata">`cause`</dfn>", and whose value is an
116-
<a for="structured header" grammar>`string`</a>. Other kinds of requests will not contain a
116+
<a for="structured header" grammar>`identifier`</a>. Other kinds of requests will not contain a
117117
{{Sec-Metadata/cause}} member.
118118

119119
Valid {{Sec-Metadata/cause}} values are `user-activated` and `forced`, representing whether or not
@@ -141,8 +141,8 @@ To <dfn abstract-op local-lt="get cause">obtain the `cause` value</dfn> for a [=
141141

142142
All requests will contain a dictionary member whose key is
143143
"<dfn dict-member for="Sec-Metadata">`destination`</dfn>", and whose value is a
144-
<a for="structured header" grammar>`string`</a> representing the [=request=]'s
145-
[=request/destination=].
144+
<a for="structured header" grammar>`identifier`</a> representing the [=request=]'s
145+
[=request/destination=], or the empty <a for="structured header" grammar>`string`</a>.
146146

147147
Valid {{Sec-Metadata/destination}} values include all valid [=request=] [=request/destination=]
148148
values (the empty string, "`audio`", "`audioworklet`", "`document`", "`embed`", "`font`",
@@ -152,6 +152,9 @@ values (the empty string, "`audio`", "`audioworklet`", "`document`", "`embed`",
152152
ISSUE(whatwg/fetch#755): Fetch currently does not define `nested-document`. It would be ideal if
153153
we could add it, as the `target` member doesn't seem to be web-compatible.
154154

155+
ISSUE: Perhaps we should define a specific identifier for the empty string, rather than switching
156+
types from `identifier` to `string` for the empty destination?
157+
155158
<div algorithm="get destination">
156159
To <dfn abstract-op local-lt="get destination">obtain the `destination` value</dfn> for a
157160
[=request=] (|r|), return |r|'s [=request/destination=].
@@ -175,7 +178,7 @@ Sec-Metadata: ..., destination="document", ...
175178

176179
All requests will contain a dictionary member whose key is
177180
"<dfn dict-member for="Sec-Metadata">`site`</dfn>", and whose value is an
178-
<a for="structured header" grammar>`string`</a> representing the relationship between the
181+
<a for="structured header" grammar>`identifier`</a> representing the relationship between the
179182
[=request=]'s [=request/origin=] and the [=url/origins=] for the [=URLs=] in the [=request=]'s
180183
[=request/url list=].
181184

0 commit comments

Comments
 (0)