@@ -1136,91 +1136,6 @@ <h3 id="invoke-observers" algorthm>
11361136 exception</ a > .
11371137</ section >
11381138
1139- < section >
1140- < h2 id ="report-types "> Report Types</ h2 >
1141-
1142- < h3 id ="deprecation-report "> Deprecation</ h3 >
1143-
1144- < dfn > Deprecation reports</ dfn > indicate that a browser API or feature has been
1145- used which is expected to stop working in a future update to the browser.
1146-
1147- < a > Deprecation reports</ a > have the < a > report type</ a > "deprecation".
1148-
1149- < a > Deprecation reports</ a > are < a > visible to
1150- < code > ReportingObserver</ code > s</ a > .
1151-
1152- < pre class ="idl ">
1153- [Exposed=(Window,Worker)]
1154- interface DeprecationReportBody : ReportBody {
1155- [Default] object toJSON();
1156- readonly attribute DOMString id;
1157- readonly attribute Date? anticipatedRemoval;
1158- readonly attribute DOMString message;
1159- readonly attribute DOMString? sourceFile;
1160- readonly attribute unsigned long? lineNumber;
1161- readonly attribute unsigned long? columnNumber;
1162- };
1163- </ pre >
1164-
1165- A < a > deprecation report</ a > 's [=report/body=], represented in JavaScript by
1166- {{DeprecationReportBody}}, contains the following fields:
1167-
1168- - < dfn for ="DeprecationReportBody "> id</ dfn > : an implementation-defined
1169- string identifying the feature or API that will be removed. This string
1170- can be used for grouping and counting related reports.
1171-
1172- - < dfn for ="DeprecationReportBody "> anticipatedRemoval</ dfn > : A
1173- JavaScript < a > Date object</ a > (rendered as an ISO 8601 string) indicating
1174- roughly when the browser version without the specified API will be
1175- generally available (excluding "beta" or other pre-release channels). This
1176- value should be used to sort or prioritize warnings. If unknown, this
1177- field should be null, and the deprecation should be considered low
1178- priority (removal may not actually occur).
1179-
1180- - < dfn for ="DeprecationReportBody "> message</ dfn > : A human-readable string
1181- with details typically matching what would be displayed on the developer
1182- console. The message is not guaranteed to be unique for a given
1183- [=DeprecationReportBody/id=] (eg. it may contain additional context on how
1184- the API was used).
1185-
1186- - < dfn for ="DeprecationReportBody "> sourceFile</ dfn > : If known, the file
1187- which first used the indicated API, or null otherwise.
1188-
1189- - < dfn for ="DeprecationReportBody "> lineNumber</ dfn > : If known, the line
1190- number in [=DeprecationReportBody/sourceFile=] where the indicated API
1191- was first used, or null otherwise.
1192-
1193- - < dfn for ="DeprecationReportBody "> columnNumber</ dfn > : If known, the column
1194- number in [=DeprecationReportBody/sourceFile=] where the indicated API
1195- was first used, or null otherwise.
1196-
1197- < div class ="example ">
1198- < pre >
1199- {
1200- "type": "deprecation",
1201- "age": 27,
1202- "url": "https://example.com/",
1203- "user_agent": "Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Firefox/60.0",
1204- "body": {
1205- "id": "websql",
1206- "anticipatedRemoval": "2020-01-01",
1207- "message": "WebSQL is deprecated and will be removed in Chrome 97 around January 2020",
1208- "sourceFile": "https://example.com/index.js",
1209- "lineNumber": 1234,
1210- "columnNumber": 42
1211- }
1212- }
1213- </ pre >
1214- </ div >
1215-
1216- Note: Deprecation reports are always delivered to the < a > endpoint group</ a >
1217- named < code > default</ code > ; there is currently no way to override this. If
1218- you want to receive other kinds of reports, but not deprecation reports, make
1219- sure to use a different name for the endpoint group that you choose for those
1220- reports.
1221-
1222- </ section >
1223-
12241139< section >
12251140 < h2 id ="implementation "> Implementation Considerations</ h2 >
12261141
0 commit comments