Skip to content

Commit 8c65914

Browse files
committed
Remove deprecation reports from main spec
1 parent 01c3dfa commit 8c65914

File tree

1 file changed

+0
-85
lines changed

1 file changed

+0
-85
lines changed

index.src.html

Lines changed: 0 additions & 85 deletions
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)