w3c / reporting

Reporting API
https://w3c.github.io/reporting/
Other
75 stars 36 forks source link

Inconsistent optionality for settings when generating reports #257

Open jyasskin opened 2 years ago

jyasskin commented 2 years ago

https://www.w3.org/TR/reporting-1/#generate-and-queue-a-report says that settings is required, but then says "If settings is given".

https://www.w3.org/TR/reporting-1/#generate-a-report, which it calls, says both settings and url are optional, but has "If url was not provided by the caller, let url be settings’s creation URL." with no consideration of what happens if both are missing.

Probably "generate a report" should say ~"and either a settings or a url", and "generate and queue a report" should also say "either a settings or a url", since some call sites in HTTP don't have a settings immediately available.