Skip to content

Commit 2b90462

Browse files
committed
Wire up a way for users to disable particular kinds of reporting.
1 parent fa09b26 commit 2b90462

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
@@ -501,6 +508,9 @@ <h4 id="generate-report" export algorithm>Generate report of |type| with
501508

502509
1. Let |settings| be |context|'s [=relevant settings object=].
503510

511+
1. If reporting is [=reporting/disabled=] for |type| and |settings|'
512+
[=environment settings object/origin=], return.
513+
504514
2. Let |report| be the result of running [[#queue-report]] with |data|,
505515
|type|, |destination| and |settings|.
506516

@@ -1088,8 +1098,8 @@ <h3 id="disable">Disabling Reporting</h3>
10881098
Sending reports costs bandwidth, and potentially could reveal some small
10891099
amount of additional information above and beyond what a website can obtain
10901100
in-band ([[NETWORK-ERROR-LOGGING]], for instance). User agents MUST allow
1091-
users to disable reporting with some reasonable amount of granularity in order
1092-
to maintain the priority of constituencies espoused in
1101+
users to [=reporting/disabled|disable reporting=] with some reasonable amount
1102+
of granularity in order to maintain the priority of constituencies espoused in
10931103
[[HTML-DESIGN-PRINCIPLES]].
10941104
</section>
10951105

0 commit comments

Comments
 (0)