Skip to content

Commit 81f7fcd

Browse files
committed
Wire up a way for users to disable particular kinds of reporting.
1 parent 334a96b commit 81f7fcd

File tree

1 file changed

+12
-2
lines changed

1 file changed

+12
-2
lines changed

index.src.html

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -289,6 +289,13 @@ <h4 id="concept-reports">Reports</h4>
289289
counter, which is a non-negative integer representing the number of times the
290290
user agent attempted to deliver the report.
291291

292+
<h4 id="concept-configuration">User configuration</h4>
293+
294+
Reporting may be <dfn for="reporting">disabled</dfn> for particular [=report
295+
types=], potentially on particular [=origins=]. The specification does not
296+
define how [=/user agents=] determine whether their users prefer to disable
297+
reporting.
298+
292299
<h3 id="media-type">Media Type</h3>
293300

294301
The media type used when POSTing reports to a specified endpoint is
@@ -493,6 +500,9 @@ <h4 id="generate-report" export algorithm>Generate report of |type| with
493500

494501
1. Let |settings| be |context|'s [=relevant settings object=].
495502

503+
1. If reporting is [=reporting/disabled=] for |type| and |settings|'
504+
[=environment settings object/origin=], return.
505+
496506
2. Let |report| be the result of running [=generate a report=] with |data|,
497507
|type|, |destination| and |settings|.
498508

@@ -1086,8 +1096,8 @@ <h3 id="disable">Disabling Reporting</h3>
10861096
Sending reports costs bandwidth, and potentially could reveal some small
10871097
amount of additional information above and beyond what a website can obtain
10881098
in-band ([[NETWORK-ERROR-LOGGING]], for instance). User agents MUST allow
1089-
users to disable reporting with some reasonable amount of granularity in order
1090-
to maintain the priority of constituencies espoused in
1099+
users to [=reporting/disabled|disable reporting=] with some reasonable amount
1100+
of granularity in order to maintain the priority of constituencies espoused in
10911101
[[HTML-DESIGN-PRINCIPLES]].
10921102
</section>
10931103

0 commit comments

Comments
 (0)