@types/serviceworker 0.0.162 → 0.0.164

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/ts5.9/index.d.ts CHANGED
@@ -882,19 +882,19 @@ interface WriteParams {
882
882
  */
883
883
  interface ANGLE_instanced_arrays {
884
884
  /**
885
- * The **`ANGLE_instanced_arrays.drawArraysInstancedANGLE()`** method of the WebGL API renders primitives from array data like the WebGLRenderingContext.drawArrays() method.
885
+ * The **`ANGLE_instanced_arrays.drawArraysInstancedANGLE()`** method of the WebGL API renders primitives from array data like the gl.drawArrays() method. In addition, it can execute multiple instances of the range of elements.
886
886
  *
887
887
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ANGLE_instanced_arrays/drawArraysInstancedANGLE)
888
888
  */
889
889
  drawArraysInstancedANGLE(mode: GLenum, first: GLint, count: GLsizei, primcount: GLsizei): void;
890
890
  /**
891
- * The **`ANGLE_instanced_arrays.drawElementsInstancedANGLE()`** method of the WebGL API renders primitives from array data like the WebGLRenderingContext.drawElements() method.
891
+ * The **`ANGLE_instanced_arrays.drawElementsInstancedANGLE()`** method of the WebGL API renders primitives from array data like the gl.drawElements() method. In addition, it can execute multiple instances of a set of elements.
892
892
  *
893
893
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ANGLE_instanced_arrays/drawElementsInstancedANGLE)
894
894
  */
895
895
  drawElementsInstancedANGLE(mode: GLenum, count: GLsizei, type: GLenum, offset: GLintptr, primcount: GLsizei): void;
896
896
  /**
897
- * The **ANGLE_instanced_arrays.vertexAttribDivisorANGLE()** method of the WebGL API modifies the rate at which generic vertex attributes advance when rendering multiple instances of primitives with ANGLE_instanced_arrays.drawArraysInstancedANGLE() and ANGLE_instanced_arrays.drawElementsInstancedANGLE().
897
+ * The **`ANGLE_instanced_arrays.vertexAttribDivisorANGLE()`** method of the WebGL API modifies the rate at which generic vertex attributes advance when rendering multiple instances of primitives with ext.drawArraysInstancedANGLE() and ext.drawElementsInstancedANGLE().
898
898
  *
899
899
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ANGLE_instanced_arrays/vertexAttribDivisorANGLE)
900
900
  */
@@ -915,7 +915,7 @@ interface AbortController {
915
915
  */
916
916
  readonly signal: AbortSignal;
917
917
  /**
918
- * The **`abort()`** method of the AbortController interface aborts an asynchronous operation before it has completed.
918
+ * The **`abort()`** method of the AbortController interface aborts an asynchronous operation before it has completed. This is able to abort fetch requests, the consumption of any response bodies, or streams.
919
919
  *
920
920
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController/abort)
921
921
  */
@@ -938,7 +938,7 @@ interface AbortSignalEventMap {
938
938
  */
939
939
  interface AbortSignal extends EventTarget {
940
940
  /**
941
- * The **`aborted`** read-only property returns a value that indicates whether the asynchronous operations the signal is communicating with are aborted (`true`) or not (`false`).
941
+ * The **`aborted`** read-only property returns a value that indicates whether the asynchronous operations the signal is communicating with are aborted (true) or not (false).
942
942
  *
943
943
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/aborted)
944
944
  */
@@ -952,7 +952,7 @@ interface AbortSignal extends EventTarget {
952
952
  */
953
953
  readonly reason: any;
954
954
  /**
955
- * The **`throwIfAborted()`** method throws the signal's abort AbortSignal.reason if the signal has been aborted; otherwise it does nothing.
955
+ * The **`throwIfAborted()`** method throws the signal's abort reason if the signal has been aborted; otherwise it does nothing.
956
956
  *
957
957
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/throwIfAborted)
958
958
  */
@@ -967,13 +967,13 @@ declare var AbortSignal: {
967
967
  prototype: AbortSignal;
968
968
  new(): AbortSignal;
969
969
  /**
970
- * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an AbortSignal/abort_event event).
970
+ * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an abort event).
971
971
  *
972
972
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_static)
973
973
  */
974
974
  abort(reason?: any): AbortSignal;
975
975
  /**
976
- * The **`AbortSignal.any()`** static method takes an iterable of abort signals and returns an AbortSignal.
976
+ * The **`AbortSignal.any()`** static method takes an iterable of abort signals and returns an AbortSignal. The returned abort signal is aborted when any of the input iterable abort signals are aborted. The abort reason will be set to the reason of the first signal that is aborted. If any of the given abort signals are already aborted then so will be the returned AbortSignal.
977
977
  *
978
978
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/any_static)
979
979
  */
@@ -1030,13 +1030,13 @@ interface Blob {
1030
1030
  */
1031
1031
  bytes(): Promise<Uint8Array<ArrayBuffer>>;
1032
1032
  /**
1033
- * The **`slice()`** method of the Blob interface creates and returns a new `Blob` object which contains data from a subset of the blob on which it's called.
1033
+ * The **`slice()`** method of the Blob interface creates and returns a new Blob object which contains data from a subset of the blob on which it's called.
1034
1034
  *
1035
1035
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/slice)
1036
1036
  */
1037
1037
  slice(start?: number, end?: number, contentType?: string): Blob;
1038
1038
  /**
1039
- * The **`stream()`** method of the Blob interface returns a ReadableStream which upon reading returns the data contained within the `Blob`.
1039
+ * The **`stream()`** method of the Blob interface returns a ReadableStream which upon reading returns the data contained within the Blob.
1040
1040
  *
1041
1041
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/stream)
1042
1042
  */
@@ -1079,13 +1079,13 @@ interface BroadcastChannelEventMap {
1079
1079
  }
1080
1080
 
1081
1081
  /**
1082
- * The **`BroadcastChannel`** interface represents a named channel that any browsing context of a given origin can subscribe to.
1082
+ * The **`BroadcastChannel`** interface represents a named channel that any browsing context of a given origin can subscribe to. It allows communication between different documents (in different windows, tabs, frames or iframes) of the same origin. Messages are broadcasted via a message event fired at all BroadcastChannel objects listening to the channel, except the object that sent the message.
1083
1083
  *
1084
1084
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/BroadcastChannel)
1085
1085
  */
1086
1086
  interface BroadcastChannel extends EventTarget {
1087
1087
  /**
1088
- * The **`name`** read-only property of the BroadcastChannel interface returns a string, which uniquely identifies the given channel with its name.
1088
+ * The **`name`** read-only property of the BroadcastChannel interface returns a string, which uniquely identifies the given channel with its name. This name is passed to the BroadcastChannel() constructor at creation time and is therefore read-only.
1089
1089
  *
1090
1090
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/BroadcastChannel/name)
1091
1091
  */
@@ -1095,13 +1095,13 @@ interface BroadcastChannel extends EventTarget {
1095
1095
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/BroadcastChannel/messageerror_event) */
1096
1096
  onmessageerror: ((this: BroadcastChannel, ev: MessageEvent) => any) | null;
1097
1097
  /**
1098
- * The **`close()`** method of the BroadcastChannel interface terminates the connection to the underlying channel, allowing the object to be garbage collected.
1098
+ * The **`close()`** method of the BroadcastChannel interface terminates the connection to the underlying channel, allowing the object to be garbage collected. This is a necessary step to perform as there is no other way for a browser to know that this channel is not needed anymore.
1099
1099
  *
1100
1100
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/BroadcastChannel/close)
1101
1101
  */
1102
1102
  close(): void;
1103
1103
  /**
1104
- * The **`postMessage()`** method of the BroadcastChannel interface sends a message, which can be of any kind of Object, to each listener in any browsing context with the same origin.
1104
+ * The **`postMessage()`** method of the BroadcastChannel interface sends a message, which can be of any kind of Object, to each listener in any browsing context with the same origin. The message is transmitted as a message event targeted at each BroadcastChannel bound to the channel.
1105
1105
  *
1106
1106
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/BroadcastChannel/postMessage)
1107
1107
  */
@@ -1158,7 +1158,7 @@ declare var CSSImageValue: {
1158
1158
  */
1159
1159
  interface CSSKeywordValue extends CSSStyleValue {
1160
1160
  /**
1161
- * The **`value`** property of the CSSKeywordValue interface returns or sets the value of the `CSSKeywordValue`.
1161
+ * The **`value`** property of the CSSKeywordValue interface returns or sets the value of the CSSKeywordValue.
1162
1162
  *
1163
1163
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSKeywordValue/value)
1164
1164
  */
@@ -1182,13 +1182,13 @@ declare var CSSMathClamp: {
1182
1182
  };
1183
1183
 
1184
1184
  /**
1185
- * The **`CSSMathInvert`** interface of the CSS Typed Object Model API represents a CSS calc used as `calc(1 / <value>)`.
1185
+ * The **`CSSMathInvert`** interface of the CSS Typed Object Model API represents a CSS calc() used as calc(1 / <value>). It inherits properties and methods from its parent CSSNumericValue.
1186
1186
  *
1187
1187
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathInvert)
1188
1188
  */
1189
1189
  interface CSSMathInvert extends CSSMathValue {
1190
1190
  /**
1191
- * The CSSMathInvert.value read-only property of the CSSMathInvert interface returns a CSSNumericValue object.
1191
+ * The **`CSSMathInvert.value`** read-only property of the CSSMathInvert interface returns a CSSNumericValue object.
1192
1192
  *
1193
1193
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathInvert/value)
1194
1194
  */
@@ -1201,13 +1201,13 @@ declare var CSSMathInvert: {
1201
1201
  };
1202
1202
 
1203
1203
  /**
1204
- * The **`CSSMathMax`** interface of the CSS Typed Object Model API represents the CSS max function.
1204
+ * The **`CSSMathMax`** interface of the CSS Typed Object Model API represents the CSS max() function. It inherits properties and methods from its parent CSSNumericValue.
1205
1205
  *
1206
1206
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathMax)
1207
1207
  */
1208
1208
  interface CSSMathMax extends CSSMathValue {
1209
1209
  /**
1210
- * The CSSMathMax.values read-only property of the CSSMathMax interface returns a CSSNumericArray object which contains one or more CSSNumericValue objects.
1210
+ * The **`CSSMathMax.values`** read-only property of the CSSMathMax interface returns a CSSNumericArray object which contains one or more CSSNumericValue objects.
1211
1211
  *
1212
1212
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathMax/values)
1213
1213
  */
@@ -1220,13 +1220,13 @@ declare var CSSMathMax: {
1220
1220
  };
1221
1221
 
1222
1222
  /**
1223
- * The **`CSSMathMin`** interface of the CSS Typed Object Model API represents the CSS min function.
1223
+ * The **`CSSMathMin`** interface of the CSS Typed Object Model API represents the CSS min() function. It inherits properties and methods from its parent CSSNumericValue.
1224
1224
  *
1225
1225
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathMin)
1226
1226
  */
1227
1227
  interface CSSMathMin extends CSSMathValue {
1228
1228
  /**
1229
- * The CSSMathMin.values read-only property of the CSSMathMin interface returns a CSSNumericArray object which contains one or more CSSNumericValue objects.
1229
+ * The **`CSSMathMin.values`** read-only property of the CSSMathMin interface returns a CSSNumericArray object which contains one or more CSSNumericValue objects.
1230
1230
  *
1231
1231
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathMin/values)
1232
1232
  */
@@ -1239,13 +1239,13 @@ declare var CSSMathMin: {
1239
1239
  };
1240
1240
 
1241
1241
  /**
1242
- * The **`CSSMathNegate`** interface of the CSS Typed Object Model API negates the value passed into it.
1242
+ * The **`CSSMathNegate`** interface of the CSS Typed Object Model API negates the value passed into it. It inherits properties and methods from its parent CSSNumericValue.
1243
1243
  *
1244
1244
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathNegate)
1245
1245
  */
1246
1246
  interface CSSMathNegate extends CSSMathValue {
1247
1247
  /**
1248
- * The CSSMathNegate.value read-only property of the CSSMathNegate interface returns a CSSNumericValue object.
1248
+ * The **`CSSMathNegate.value`** read-only property of the CSSMathNegate interface returns a CSSNumericValue object.
1249
1249
  *
1250
1250
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathNegate/value)
1251
1251
  */
@@ -1258,7 +1258,7 @@ declare var CSSMathNegate: {
1258
1258
  };
1259
1259
 
1260
1260
  /**
1261
- * The **`CSSMathProduct`** interface of the CSS Typed Object Model API represents the result obtained by calling CSSNumericValue.add, CSSNumericValue.sub, or CSSNumericValue.toSum on CSSNumericValue.
1261
+ * The **`CSSMathProduct`** interface of the CSS Typed Object Model API represents the result obtained by calling add(), sub(), or toSum() on CSSNumericValue. It inherits properties and methods from its parent CSSNumericValue.
1262
1262
  *
1263
1263
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathProduct)
1264
1264
  */
@@ -1277,7 +1277,7 @@ declare var CSSMathProduct: {
1277
1277
  };
1278
1278
 
1279
1279
  /**
1280
- * The **`CSSMathSum`** interface of the CSS Typed Object Model API represents the result obtained by calling CSSNumericValue.add, CSSNumericValue.sub, or CSSNumericValue.toSum on CSSNumericValue.
1280
+ * The **`CSSMathSum`** interface of the CSS Typed Object Model API represents the result obtained by calling add(), sub(), or toSum() on CSSNumericValue.
1281
1281
  *
1282
1282
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathSum)
1283
1283
  */
@@ -1302,7 +1302,7 @@ declare var CSSMathSum: {
1302
1302
  */
1303
1303
  interface CSSMathValue extends CSSNumericValue {
1304
1304
  /**
1305
- * The **`CSSMathValue.operator`** read-only property of the CSSMathValue interface indicates the operator that the current subtype represents.
1305
+ * The **`CSSMathValue.operator`** read-only property of the CSSMathValue interface indicates the operator that the current subtype represents. For example, if the current CSSMathValue subtype is CSSMathSum, this property will return the string "sum".
1306
1306
  *
1307
1307
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathValue/operator)
1308
1308
  */
@@ -1315,7 +1315,7 @@ declare var CSSMathValue: {
1315
1315
  };
1316
1316
 
1317
1317
  /**
1318
- * The **`CSSMatrixComponent`** interface of the CSS Typed Object Model API represents the matrix() and matrix3d() values of the individual transform property in CSS.
1318
+ * The **`CSSMatrixComponent`** interface of the CSS Typed Object Model API represents the matrix() and matrix3d() values of the individual transform property in CSS. It inherits properties and methods from its parent CSSTransformValue.
1319
1319
  *
1320
1320
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMatrixComponent)
1321
1321
  */
@@ -1361,43 +1361,43 @@ declare var CSSNumericArray: {
1361
1361
  */
1362
1362
  interface CSSNumericValue extends CSSStyleValue {
1363
1363
  /**
1364
- * The **`add()`** method of the CSSNumericValue interface adds a supplied number to the `CSSNumericValue`.
1364
+ * The **`add()`** method of the CSSNumericValue interface adds a supplied number to the CSSNumericValue.
1365
1365
  *
1366
1366
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/add)
1367
1367
  */
1368
1368
  add(...values: CSSNumberish[]): CSSNumericValue;
1369
1369
  /**
1370
- * The **`div()`** method of the CSSNumericValue interface divides the `CSSNumericValue` by the supplied value.
1370
+ * The **`div()`** method of the CSSNumericValue interface divides the CSSNumericValue by the supplied value.
1371
1371
  *
1372
1372
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/div)
1373
1373
  */
1374
1374
  div(...values: CSSNumberish[]): CSSNumericValue;
1375
1375
  /**
1376
- * The **`equals()`** method of the CSSNumericValue interface returns a boolean indicating whether the passed value are strictly equal.
1376
+ * The **`equals()`** method of the CSSNumericValue interface returns a boolean indicating whether the passed value are strictly equal. To return a value of true, all passed values must be of the same type and value and must be in the same order. This allows structural equality to be tested quickly.
1377
1377
  *
1378
1378
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/equals)
1379
1379
  */
1380
1380
  equals(...value: CSSNumberish[]): boolean;
1381
1381
  /**
1382
- * The **`max()`** method of the CSSNumericValue interface returns the highest value from among the values passed.
1382
+ * The **`max()`** method of the CSSNumericValue interface returns the highest value from among the values passed. The passed values must be of the same type.
1383
1383
  *
1384
1384
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/max)
1385
1385
  */
1386
1386
  max(...values: CSSNumberish[]): CSSNumericValue;
1387
1387
  /**
1388
- * The **`min()`** method of the CSSNumericValue interface returns the lowest value from among those values passed.
1388
+ * The **`min()`** method of the CSSNumericValue interface returns the lowest value from among those values passed. The passed values must be of the same type.
1389
1389
  *
1390
1390
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/min)
1391
1391
  */
1392
1392
  min(...values: CSSNumberish[]): CSSNumericValue;
1393
1393
  /**
1394
- * The **`mul()`** method of the CSSNumericValue interface multiplies the `CSSNumericValue` by the supplied value.
1394
+ * The **`mul()`** method of the CSSNumericValue interface multiplies the CSSNumericValue by the supplied value.
1395
1395
  *
1396
1396
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/mul)
1397
1397
  */
1398
1398
  mul(...values: CSSNumberish[]): CSSNumericValue;
1399
1399
  /**
1400
- * The **`sub()`** method of the CSSNumericValue interface subtracts a supplied number from the `CSSNumericValue`.
1400
+ * The **`sub()`** method of the CSSNumericValue interface subtracts a supplied number from the CSSNumericValue.
1401
1401
  *
1402
1402
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/sub)
1403
1403
  */
@@ -1415,7 +1415,7 @@ interface CSSNumericValue extends CSSStyleValue {
1415
1415
  */
1416
1416
  toSum(...units: string[]): CSSMathSum;
1417
1417
  /**
1418
- * The **`type()`** method of the CSSNumericValue interface returns the type of `CSSNumericValue`, one of `angle`, `flex`, `frequency`, `length`, `resolution`, `percent`, `percentHint`, or `time`.
1418
+ * The **`type()`** method of the CSSNumericValue interface returns the type of CSSNumericValue, one of angle, flex, frequency, length, resolution, percent, percentHint, or time.
1419
1419
  *
1420
1420
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/type)
1421
1421
  */
@@ -1428,7 +1428,7 @@ declare var CSSNumericValue: {
1428
1428
  };
1429
1429
 
1430
1430
  /**
1431
- * The **`CSSPerspective`** interface of the CSS Typed Object Model API represents the perspective() value of the individual transform property in CSS.
1431
+ * The **`CSSPerspective`** interface of the CSS Typed Object Model API represents the perspective() value of the individual transform property in CSS. It inherits properties and methods from its parent CSSTransformValue.
1432
1432
  *
1433
1433
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPerspective)
1434
1434
  */
@@ -1447,13 +1447,13 @@ declare var CSSPerspective: {
1447
1447
  };
1448
1448
 
1449
1449
  /**
1450
- * The **`CSSRotate`** interface of the CSS Typed Object Model API represents the rotate value of the individual transform property in CSS.
1450
+ * The **`CSSRotate`** interface of the CSS Typed Object Model API represents the rotate value of the individual transform property in CSS. It inherits properties and methods from its parent CSSTransformValue.
1451
1451
  *
1452
1452
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSRotate)
1453
1453
  */
1454
1454
  interface CSSRotate extends CSSTransformComponent {
1455
1455
  /**
1456
- * The **`angle`** property of the CSSRotate interface gets and sets the angle of rotation.
1456
+ * The **`angle`** property of the CSSRotate interface gets and sets the angle of rotation. A positive angle denotes a clockwise rotation, a negative angle a counter-clockwise one.
1457
1457
  *
1458
1458
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSRotate/angle)
1459
1459
  */
@@ -1471,7 +1471,7 @@ interface CSSRotate extends CSSTransformComponent {
1471
1471
  */
1472
1472
  y: CSSNumberish;
1473
1473
  /**
1474
- * The **`z`** property of the CSSRotate interface representing the z-component of the translating vector.
1474
+ * The **`z`** property of the CSSRotate interface representing the z-component of the translating vector. A positive value moves the element towards the viewer, and a negative value farther away.
1475
1475
  *
1476
1476
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSRotate/z)
1477
1477
  */
@@ -1485,7 +1485,7 @@ declare var CSSRotate: {
1485
1485
  };
1486
1486
 
1487
1487
  /**
1488
- * The **`CSSScale`** interface of the CSS Typed Object Model API represents the scale() and scale3d() values of the individual transform property in CSS.
1488
+ * The **`CSSScale`** interface of the CSS Typed Object Model API represents the scale() and scale3d() values of the individual transform property in CSS. It inherits properties and methods from its parent CSSTransformValue.
1489
1489
  *
1490
1490
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSScale)
1491
1491
  */
@@ -1503,7 +1503,7 @@ interface CSSScale extends CSSTransformComponent {
1503
1503
  */
1504
1504
  y: CSSNumberish;
1505
1505
  /**
1506
- * The **`z`** property of the CSSScale interface representing the z-component of the translating vector.
1506
+ * The **`z`** property of the CSSScale interface representing the z-component of the translating vector. A positive value moves the element towards the viewer, and a negative value farther away.
1507
1507
  *
1508
1508
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSScale/z)
1509
1509
  */
@@ -1516,7 +1516,7 @@ declare var CSSScale: {
1516
1516
  };
1517
1517
 
1518
1518
  /**
1519
- * The **`CSSSkew`** interface of the CSS Typed Object Model API is part of the CSSTransformValue interface.
1519
+ * The **`CSSSkew`** interface of the CSS Typed Object Model API is part of the CSSTransformValue interface. It represents the skew() value of the individual transform property in CSS.
1520
1520
  *
1521
1521
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSSkew)
1522
1522
  */
@@ -1541,7 +1541,7 @@ declare var CSSSkew: {
1541
1541
  };
1542
1542
 
1543
1543
  /**
1544
- * The **`CSSSkewX`** interface of the CSS Typed Object Model API represents the `skewX()` value of the individual transform property in CSS.
1544
+ * The **`CSSSkewX`** interface of the CSS Typed Object Model API represents the skewX() value of the individual transform property in CSS. It inherits properties and methods from its parent CSSTransformValue.
1545
1545
  *
1546
1546
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSSkewX)
1547
1547
  */
@@ -1560,7 +1560,7 @@ declare var CSSSkewX: {
1560
1560
  };
1561
1561
 
1562
1562
  /**
1563
- * The **`CSSSkewY`** interface of the CSS Typed Object Model API represents the `skewY()` value of the individual transform property in CSS.
1563
+ * The **`CSSSkewY`** interface of the CSS Typed Object Model API represents the skewY() value of the individual transform property in CSS. It inherits properties and methods from its parent CSSTransformValue.
1564
1564
  *
1565
1565
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSSkewY)
1566
1566
  */
@@ -1579,7 +1579,7 @@ declare var CSSSkewY: {
1579
1579
  };
1580
1580
 
1581
1581
  /**
1582
- * The **`CSSStyleValue`** interface of the CSS Typed Object Model API is the base class of all CSS values accessible through the Typed OM API.
1582
+ * The **`CSSStyleValue`** interface of the CSS Typed Object Model API is the base class of all CSS values accessible through the Typed OM API. An instance of this class may be used anywhere a string is expected.
1583
1583
  *
1584
1584
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleValue)
1585
1585
  */
@@ -1619,7 +1619,7 @@ declare var CSSTransformComponent: {
1619
1619
  };
1620
1620
 
1621
1621
  /**
1622
- * The **`CSSTransformValue`** interface of the CSS Typed Object Model API represents `transform-list` values as used by the CSS transform property.
1622
+ * The **`CSSTransformValue`** interface of the CSS Typed Object Model API represents transform-list values as used by the CSS transform property.
1623
1623
  *
1624
1624
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSTransformValue)
1625
1625
  */
@@ -1652,7 +1652,7 @@ declare var CSSTransformValue: {
1652
1652
  };
1653
1653
 
1654
1654
  /**
1655
- * The **`CSSTranslate`** interface of the CSS Typed Object Model API represents the translate() value of the individual transform property in CSS.
1655
+ * The **`CSSTranslate`** interface of the CSS Typed Object Model API represents the translate() value of the individual transform property in CSS. It inherits properties and methods from its parent CSSTransformValue.
1656
1656
  *
1657
1657
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSTranslate)
1658
1658
  */
@@ -1670,7 +1670,7 @@ interface CSSTranslate extends CSSTransformComponent {
1670
1670
  */
1671
1671
  y: CSSNumericValue;
1672
1672
  /**
1673
- * The **`z`** property of the CSSTranslate interface representing the z-component of the translating vector.
1673
+ * The **`z`** property of the CSSTranslate interface representing the z-component of the translating vector. A positive value moves the element towards the viewer, and a negative value farther away.
1674
1674
  *
1675
1675
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSTranslate/z)
1676
1676
  */
@@ -1683,7 +1683,7 @@ declare var CSSTranslate: {
1683
1683
  };
1684
1684
 
1685
1685
  /**
1686
- * The **`CSSUnitValue`** interface of the CSS Typed Object Model API represents values that contain a single unit type.
1686
+ * The **`CSSUnitValue`** interface of the CSS Typed Object Model API represents values that contain a single unit type. For example, "42px" would be represented by a CSSNumericValue.
1687
1687
  *
1688
1688
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSUnitValue)
1689
1689
  */
@@ -1708,7 +1708,7 @@ declare var CSSUnitValue: {
1708
1708
  };
1709
1709
 
1710
1710
  /**
1711
- * The **`CSSUnparsedValue`** interface of the CSS Typed Object Model API represents property values that reference custom properties.
1711
+ * The **`CSSUnparsedValue`** interface of the CSS Typed Object Model API represents property values that reference custom properties. It consists of a list of string fragments and variable references.
1712
1712
  *
1713
1713
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSUnparsedValue)
1714
1714
  */
@@ -1729,7 +1729,7 @@ declare var CSSUnparsedValue: {
1729
1729
  };
1730
1730
 
1731
1731
  /**
1732
- * The **`CSSVariableReferenceValue`** interface of the CSS Typed Object Model API allows you to create a custom name for a built-in CSS value.
1732
+ * The **`CSSVariableReferenceValue`** interface of the CSS Typed Object Model API allows you to create a custom name for a built-in CSS value. This object functionality is sometimes called a "CSS variable" and serves the same purpose as the var() function. The custom name must begin with two dashes.
1733
1733
  *
1734
1734
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSVariableReferenceValue)
1735
1735
  */
@@ -1754,7 +1754,7 @@ declare var CSSVariableReferenceValue: {
1754
1754
  };
1755
1755
 
1756
1756
  /**
1757
- * The **`Cache`** interface provides a persistent storage mechanism for Request / Response object pairs that are cached in long lived memory.
1757
+ * The **`Cache`** interface provides a persistent storage mechanism for Request / Response object pairs that are cached in long lived memory. How long a Cache object lives is browser dependent, but a single origin's scripts can typically rely on the presence of a previously populated Cache object. Note that the Cache interface is exposed to windowed scopes as well as workers. You don't have to use it in conjunction with service workers, even though it is defined in the service worker spec.
1758
1758
  * Available only in secure contexts.
1759
1759
  *
1760
1760
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Cache)
@@ -1767,13 +1767,13 @@ interface Cache {
1767
1767
  */
1768
1768
  add(request: RequestInfo | URL): Promise<void>;
1769
1769
  /**
1770
- * The **`addAll()`** method of the Cache interface takes an array of URLs, retrieves them, and adds the resulting response objects to the given cache.
1770
+ * The **`addAll()`** method of the Cache interface takes an array of URLs, retrieves them, and adds the resulting response objects to the given cache. The request objects created during retrieval become keys to the stored response operations.
1771
1771
  *
1772
1772
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Cache/addAll)
1773
1773
  */
1774
1774
  addAll(requests: RequestInfo[]): Promise<void>;
1775
1775
  /**
1776
- * The **`delete()`** method of the Cache interface finds the Cache entry whose key is the request, and if found, deletes the Cache entry and returns a Promise that resolves to `true`.
1776
+ * The **`delete()`** method of the Cache interface finds the Cache entry whose key is the request, and if found, deletes the Cache entry and returns a Promise that resolves to true. If no Cache entry is found, it resolves to false.
1777
1777
  *
1778
1778
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Cache/delete)
1779
1779
  */
@@ -1785,7 +1785,7 @@ interface Cache {
1785
1785
  */
1786
1786
  keys(request?: RequestInfo | URL, options?: CacheQueryOptions): Promise<ReadonlyArray<Request>>;
1787
1787
  /**
1788
- * The **`match()`** method of the Cache interface returns a Promise that resolves to the Response associated with the first matching request in the Cache object.
1788
+ * The **`match()`** method of the Cache interface returns a Promise that resolves to the Response associated with the first matching request in the Cache object. If no match is found, the Promise resolves to undefined.
1789
1789
  *
1790
1790
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Cache/match)
1791
1791
  */
@@ -1817,31 +1817,31 @@ declare var Cache: {
1817
1817
  */
1818
1818
  interface CacheStorage {
1819
1819
  /**
1820
- * The **`delete()`** method of the CacheStorage interface finds the Cache object matching the `cacheName`, and if found, deletes the Cache object and returns a Promise that resolves to `true`.
1820
+ * The **`delete()`** method of the CacheStorage interface finds the Cache object matching the cacheName, and if found, deletes the Cache object and returns a Promise that resolves to true. If no Cache object is found, it resolves to false.
1821
1821
  *
1822
1822
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CacheStorage/delete)
1823
1823
  */
1824
1824
  delete(cacheName: string): Promise<boolean>;
1825
1825
  /**
1826
- * The **`has()`** method of the CacheStorage interface returns a Promise that resolves to `true` if a Cache object matches the `cacheName`.
1826
+ * The **`has()`** method of the CacheStorage interface returns a Promise that resolves to true if a Cache object matches the cacheName.
1827
1827
  *
1828
1828
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CacheStorage/has)
1829
1829
  */
1830
1830
  has(cacheName: string): Promise<boolean>;
1831
1831
  /**
1832
- * The **`keys()`** method of the CacheStorage interface returns a Promise that will resolve with an array containing strings corresponding to all of the named Cache objects tracked by the CacheStorage object in the order they were created.
1832
+ * The **`keys()`** method of the CacheStorage interface returns a Promise that will resolve with an array containing strings corresponding to all of the named Cache objects tracked by the CacheStorage object in the order they were created. Use this method to iterate over a list of all Cache objects.
1833
1833
  *
1834
1834
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CacheStorage/keys)
1835
1835
  */
1836
1836
  keys(): Promise<string[]>;
1837
1837
  /**
1838
- * The **`match()`** method of the CacheStorage interface checks if a given Request or URL string is a key for a stored Response.
1838
+ * The **`match()`** method of the CacheStorage interface checks if a given Request or URL string is a key for a stored Response. This method returns a Promise for a Response, or a Promise which resolves to undefined if no match is found.
1839
1839
  *
1840
1840
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CacheStorage/match)
1841
1841
  */
1842
1842
  match(request: RequestInfo | URL, options?: MultiCacheQueryOptions): Promise<Response | undefined>;
1843
1843
  /**
1844
- * The **`open()`** method of the CacheStorage interface returns a Promise that resolves to the Cache object matching the `cacheName`.
1844
+ * The **`open()`** method of the CacheStorage interface returns a Promise that resolves to the Cache object matching the cacheName.
1845
1845
  *
1846
1846
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CacheStorage/open)
1847
1847
  */
@@ -1908,13 +1908,13 @@ interface CanvasFilters {
1908
1908
  }
1909
1909
 
1910
1910
  /**
1911
- * The **`CanvasGradient`** interface represents an opaque object describing a gradient.
1911
+ * The **`CanvasGradient`** interface represents an opaque object describing a gradient. It is returned by the methods CanvasRenderingContext2D.createLinearGradient(), CanvasRenderingContext2D.createConicGradient() or CanvasRenderingContext2D.createRadialGradient().
1912
1912
  *
1913
1913
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CanvasGradient)
1914
1914
  */
1915
1915
  interface CanvasGradient {
1916
1916
  /**
1917
- * The **`CanvasGradient.addColorStop()`** method adds a new color stop, defined by an `offset` and a `color`, to a given canvas gradient.
1917
+ * The **`CanvasGradient.addColorStop()`** method adds a new color stop, defined by an offset and a color, to a given canvas gradient.
1918
1918
  *
1919
1919
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CanvasGradient/addColorStop)
1920
1920
  */
@@ -2085,13 +2085,13 @@ interface CanvasTransform {
2085
2085
  }
2086
2086
 
2087
2087
  /**
2088
- * The `Client` interface represents an executable context such as a Worker, or a SharedWorker.
2088
+ * The **`Client`** interface represents an executable context such as a Worker, or a SharedWorker. Window clients are represented by the more-specific WindowClient. You can get Client/WindowClient objects from methods such as Clients.matchAll() and Clients.get().
2089
2089
  *
2090
2090
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Client)
2091
2091
  */
2092
2092
  interface Client {
2093
2093
  /**
2094
- * The **`frameType`** read-only property of the Client interface indicates the type of browsing context of the current Client.
2094
+ * The **`frameType`** read-only property of the Client interface indicates the type of browsing context of the current Client. This value can be one of "auxiliary", "top-level", "nested", or "none".
2095
2095
  *
2096
2096
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Client/frameType)
2097
2097
  */
@@ -2115,7 +2115,7 @@ interface Client {
2115
2115
  */
2116
2116
  readonly url: string;
2117
2117
  /**
2118
- * The **`postMessage()`** method of the Client interface allows a service worker to send a message to a client (a Window, Worker, or SharedWorker).
2118
+ * The **`postMessage()`** method of the Client interface allows a service worker to send a message to a client (a Window, Worker, or SharedWorker). The message is received in the message event on navigator.serviceWorker.
2119
2119
  *
2120
2120
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Client/postMessage)
2121
2121
  */
@@ -2129,31 +2129,31 @@ declare var Client: {
2129
2129
  };
2130
2130
 
2131
2131
  /**
2132
- * The `Clients` interface provides access to Client objects.
2132
+ * The **`Clients`** interface provides access to Client objects. Access it via self.clients within a service worker.
2133
2133
  *
2134
2134
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Clients)
2135
2135
  */
2136
2136
  interface Clients {
2137
2137
  /**
2138
- * The **`claim()`** method of the Clients interface allows an active service worker to set itself as the ServiceWorkerContainer.controller for all clients within its ServiceWorkerRegistration.scope.
2138
+ * The **`claim()`** method of the Clients interface allows an active service worker to set itself as the controller for all clients within its scope. This triggers a controllerchange event on navigator.serviceWorker in any clients that become controlled by this service worker.
2139
2139
  *
2140
2140
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Clients/claim)
2141
2141
  */
2142
2142
  claim(): Promise<void>;
2143
2143
  /**
2144
- * The **`get()`** method of the Clients interface gets a service worker client matching a given `id` and returns it in a Promise.
2144
+ * The **`get()`** method of the Clients interface gets a service worker client matching a given id and returns it in a Promise.
2145
2145
  *
2146
2146
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Clients/get)
2147
2147
  */
2148
2148
  get(id: string): Promise<Client | undefined>;
2149
2149
  /**
2150
- * The **`matchAll()`** method of the Clients interface returns a Promise for a list of service worker Client objects.
2150
+ * The **`matchAll()`** method of the Clients interface returns a Promise for a list of service worker Client objects. Include the options parameter to return all service worker clients whose origin is the same as the associated service worker's origin. If options are not included, the method returns only the service worker clients controlled by the service worker.
2151
2151
  *
2152
2152
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Clients/matchAll)
2153
2153
  */
2154
2154
  matchAll<T extends ClientQueryOptions>(options?: T): Promise<ReadonlyArray<T["type"] extends "window" ? WindowClient : Client>>;
2155
2155
  /**
2156
- * The **`openWindow()`** method of the Clients interface creates a new top level browsing context and loads a given URL.
2156
+ * The **`openWindow()`** method of the Clients interface creates a new top level browsing context and loads a given URL. If the calling script doesn't have permission to show popups, openWindow() will throw an InvalidAccessError.
2157
2157
  *
2158
2158
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Clients/openWindow)
2159
2159
  */
@@ -2166,7 +2166,7 @@ declare var Clients: {
2166
2166
  };
2167
2167
 
2168
2168
  /**
2169
- * A `CloseEvent` is sent to clients using WebSockets when the connection is closed.
2169
+ * A **`CloseEvent`** is sent to clients using WebSockets when the connection is closed. This is delivered to the listener indicated by the WebSocket object's onclose attribute.
2170
2170
  *
2171
2171
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent)
2172
2172
  */
@@ -2184,7 +2184,7 @@ interface CloseEvent extends Event {
2184
2184
  */
2185
2185
  readonly reason: string;
2186
2186
  /**
2187
- * The **`wasClean`** read-only property of the CloseEvent interface returns `true` if the connection closed cleanly.
2187
+ * The **`wasClean`** read-only property of the CloseEvent interface returns true if the connection closed cleanly.
2188
2188
  *
2189
2189
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent/wasClean)
2190
2190
  */
@@ -2219,28 +2219,28 @@ declare var CompressionStream: {
2219
2219
  */
2220
2220
  interface CookieStore extends EventTarget {
2221
2221
  /**
2222
- * The **`delete()`** method of the CookieStore interface deletes a cookie that matches the given `name` or `options` object.
2222
+ * The **`delete()`** method of the CookieStore interface deletes a cookie that matches the given name or options object. The method expires the cookie by changing its date to one in the past.
2223
2223
  *
2224
2224
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CookieStore/delete)
2225
2225
  */
2226
2226
  delete(name: string): Promise<void>;
2227
2227
  delete(options: CookieStoreDeleteOptions): Promise<void>;
2228
2228
  /**
2229
- * The **`get()`** method of the CookieStore interface returns a Promise that resolves to a single cookie matching the given `name` or `options` object.
2229
+ * The **`get()`** method of the CookieStore interface returns a Promise that resolves to a single cookie matching the given name or options object. The method will return the first cookie that matches.
2230
2230
  *
2231
2231
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CookieStore/get)
2232
2232
  */
2233
2233
  get(name: string): Promise<CookieListItem | null>;
2234
2234
  get(options?: CookieStoreGetOptions): Promise<CookieListItem | null>;
2235
2235
  /**
2236
- * The **`getAll()`** method of the CookieStore interface returns a Promise that resolves as an array of cookies that match the `name` or `options` passed to it.
2236
+ * The **`getAll()`** method of the CookieStore interface returns a Promise that resolves as an array of cookies that match the name or options passed to it. Passing no parameters will return all cookies for the current context.
2237
2237
  *
2238
2238
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CookieStore/getAll)
2239
2239
  */
2240
2240
  getAll(name: string): Promise<CookieList>;
2241
2241
  getAll(options?: CookieStoreGetOptions): Promise<CookieList>;
2242
2242
  /**
2243
- * The **`set()`** method of the CookieStore interface sets a cookie with the given `name` and `value` or `options` object.
2243
+ * The **`set()`** method of the CookieStore interface sets a cookie with the given name and value or options object.
2244
2244
  *
2245
2245
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CookieStore/set)
2246
2246
  */
@@ -2254,7 +2254,7 @@ declare var CookieStore: {
2254
2254
  };
2255
2255
 
2256
2256
  /**
2257
- * The **`CookieStoreManager`** interface of the Cookie Store API allows service workers to subscribe to cookie change events.
2257
+ * The **`CookieStoreManager`** interface of the Cookie Store API allows service workers to subscribe to cookie change events. Call subscribe() on a particular service worker registration to receive change events.
2258
2258
  * Available only in secure contexts.
2259
2259
  *
2260
2260
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CookieStoreManager)
@@ -2307,7 +2307,7 @@ declare var CountQueuingStrategy: {
2307
2307
  };
2308
2308
 
2309
2309
  /**
2310
- * The **`Crypto`** interface represents basic cryptography features available in the current context.
2310
+ * The **`Crypto`** interface represents basic cryptography features available in the current context. It allows access to a cryptographically strong random number generator and to cryptographic primitives.
2311
2311
  *
2312
2312
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto)
2313
2313
  */
@@ -2320,11 +2320,11 @@ interface Crypto {
2320
2320
  */
2321
2321
  readonly subtle: SubtleCrypto;
2322
2322
  /**
2323
- * The **`Crypto.getRandomValues()`** method lets you get cryptographically strong random values.
2323
+ * The **`Crypto.getRandomValues()`** method lets you get cryptographically strong random values. The array given as the parameter is filled with random numbers (random in its cryptographic meaning).
2324
2324
  *
2325
2325
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/getRandomValues)
2326
2326
  */
2327
- getRandomValues<T extends ArrayBufferView>(array: T): T;
2327
+ getRandomValues<T extends Exclude<BufferSource, ArrayBuffer>>(array: T): T;
2328
2328
  /**
2329
2329
  * The **`randomUUID()`** method of the Crypto interface is used to generate a v4 UUID using a cryptographically secure random number generator.
2330
2330
  * Available only in secure contexts.
@@ -2340,7 +2340,7 @@ declare var Crypto: {
2340
2340
  };
2341
2341
 
2342
2342
  /**
2343
- * The **`CryptoKey`** interface of the Web Crypto API represents a cryptographic key obtained from one of the SubtleCrypto methods SubtleCrypto.generateKey, SubtleCrypto.deriveKey, SubtleCrypto.importKey, or SubtleCrypto.unwrapKey.
2343
+ * The **`CryptoKey`** interface of the Web Crypto API represents a cryptographic key obtained from one of the SubtleCrypto methods generateKey(), deriveKey(), importKey(), or unwrapKey().
2344
2344
  * Available only in secure contexts.
2345
2345
  *
2346
2346
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey)
@@ -2353,13 +2353,13 @@ interface CryptoKey {
2353
2353
  */
2354
2354
  readonly algorithm: KeyAlgorithm;
2355
2355
  /**
2356
- * The read-only **`extractable`** property of the CryptoKey interface indicates whether or not the key may be extracted using `SubtleCrypto.exportKey()` or `SubtleCrypto.wrapKey()`.
2356
+ * The read-only **`extractable`** property of the CryptoKey interface indicates whether or not the key may be extracted using SubtleCrypto.exportKey() or SubtleCrypto.wrapKey().
2357
2357
  *
2358
2358
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/extractable)
2359
2359
  */
2360
2360
  readonly extractable: boolean;
2361
2361
  /**
2362
- * The read-only **`type`** property of the CryptoKey interface indicates which kind of key is represented by the object.
2362
+ * The read-only **`type`** property of the CryptoKey interface indicates which kind of key is represented by the object. It can have the following values:
2363
2363
  *
2364
2364
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/type)
2365
2365
  */
@@ -2390,7 +2390,7 @@ interface CustomEvent<T = any> extends Event {
2390
2390
  */
2391
2391
  readonly detail: T;
2392
2392
  /**
2393
- * The **`CustomEvent.initCustomEvent()`** method initializes a CustomEvent object.
2393
+ * The **`CustomEvent.initCustomEvent()`** method initializes a CustomEvent object. If the event has already been dispatched, this method does nothing.
2394
2394
  * @deprecated
2395
2395
  *
2396
2396
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent/initCustomEvent)
@@ -2404,13 +2404,13 @@ declare var CustomEvent: {
2404
2404
  };
2405
2405
 
2406
2406
  /**
2407
- * The **`DOMException`** interface represents an abnormal event (called an **exception**) that occurs as a result of calling a method or accessing a property of a web API.
2407
+ * The **`DOMException`** interface represents an abnormal event (called an exception) that occurs as a result of calling a method or accessing a property of a web API. This is how error conditions are described in web APIs.
2408
2408
  *
2409
2409
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException)
2410
2410
  */
2411
2411
  interface DOMException extends Error {
2412
2412
  /**
2413
- * The **`code`** read-only property of the DOMException interface returns one of the legacy error code constants, or `0` if none match.
2413
+ * The **`code`** read-only property of the DOMException interface returns one of the legacy error code constants, or 0 if none match.
2414
2414
  * @deprecated
2415
2415
  *
2416
2416
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/code)
@@ -2486,7 +2486,7 @@ declare var DOMException: {
2486
2486
  };
2487
2487
 
2488
2488
  /**
2489
- * The **`DOMMatrix`** interface represents 4×4 matrices, suitable for 2D and 3D operations including rotation and translation.
2489
+ * The **`DOMMatrix`** interface represents 4×4 matrices, suitable for 2D and 3D operations including rotation and translation. It is a mutable version of the DOMMatrixReadOnly interface. The interface is available inside web workers.
2490
2490
  *
2491
2491
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrix)
2492
2492
  */
@@ -2536,67 +2536,67 @@ interface DOMMatrix extends DOMMatrixReadOnly {
2536
2536
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrix#instance_properties) */
2537
2537
  m44: number;
2538
2538
  /**
2539
- * The **`invertSelf()`** method of the DOMMatrix interface inverts the original matrix.
2539
+ * The **`invertSelf()`** method of the DOMMatrix interface inverts the original matrix. If the matrix cannot be inverted, the new matrix's components are all set to NaN and its is2D property is set to false.
2540
2540
  *
2541
2541
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrix/invertSelf)
2542
2542
  */
2543
2543
  invertSelf(): DOMMatrix;
2544
2544
  /**
2545
- * The **`multiplySelf()`** method of the DOMMatrix interface multiplies a matrix by the `otherMatrix` parameter, computing the dot product of the original matrix and the specified matrix: `A⋅B`.
2545
+ * The **`multiplySelf()`** method of the DOMMatrix interface multiplies a matrix by the otherMatrix parameter, computing the dot product of the original matrix and the specified matrix: A⋅B. If no matrix is specified as the multiplier, the matrix is multiplied by a matrix in which every element is 0 except the bottom-right corner and the element immediately above and to its left: m33 and m34. These have the default value of 1.
2546
2546
  *
2547
2547
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrix/multiplySelf)
2548
2548
  */
2549
2549
  multiplySelf(other?: DOMMatrixInit): DOMMatrix;
2550
2550
  /**
2551
- * The **`preMultiplySelf()`** method of the DOMMatrix interface modifies the matrix by pre-multiplying it with the specified `DOMMatrix`.
2551
+ * The **`preMultiplySelf()`** method of the DOMMatrix interface modifies the matrix by pre-multiplying it with the specified DOMMatrix. This is equivalent to the dot product B⋅A, where matrix A is the source matrix and B is the matrix given as an input to the method. If no matrix is specified as the multiplier, the matrix is multiplied by a matrix in which every element is 0 except the bottom-right corner and the element immediately above and to its left: m33 and m34. These have the default value of 1.
2552
2552
  *
2553
2553
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrix/preMultiplySelf)
2554
2554
  */
2555
2555
  preMultiplySelf(other?: DOMMatrixInit): DOMMatrix;
2556
2556
  /**
2557
- * The `rotateAxisAngleSelf()` method of the DOMMatrix interface is a transformation method that rotates the source matrix by the given vector and angle, returning the altered matrix.
2557
+ * The **`rotateAxisAngleSelf()`** method of the DOMMatrix interface is a transformation method that rotates the source matrix by the given vector and angle, returning the altered matrix.
2558
2558
  *
2559
2559
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrix/rotateAxisAngleSelf)
2560
2560
  */
2561
2561
  rotateAxisAngleSelf(x?: number, y?: number, z?: number, angle?: number): DOMMatrix;
2562
2562
  /**
2563
- * The `rotateFromVectorSelf()` method of the DOMMatrix interface is a mutable transformation method that modifies a matrix by rotating the matrix by the angle between the specified vector and `(1, 0)`.
2563
+ * The **`rotateFromVectorSelf()`** method of the DOMMatrix interface is a mutable transformation method that modifies a matrix by rotating the matrix by the angle between the specified vector and (1, 0). The rotation angle is determined by the angle between the vector (1,0)T and (x,y)T in the clockwise direction, or (+/-)arctan(y/x). If x and y are both 0, the angle is specified as 0, and the matrix is not altered.
2564
2564
  *
2565
2565
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrix/rotateFromVectorSelf)
2566
2566
  */
2567
2567
  rotateFromVectorSelf(x?: number, y?: number): DOMMatrix;
2568
2568
  /**
2569
- * The `rotateSelf()` method of the DOMMatrix interface is a mutable transformation method that modifies a matrix.
2569
+ * The **`rotateSelf()`** method of the DOMMatrix interface is a mutable transformation method that modifies a matrix. It rotates the source matrix around each of its axes by the specified number of degrees and returns the rotated matrix.
2570
2570
  *
2571
2571
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrix/rotateSelf)
2572
2572
  */
2573
2573
  rotateSelf(rotX?: number, rotY?: number, rotZ?: number): DOMMatrix;
2574
2574
  /**
2575
- * The **`scale3dSelf()`** method of the DOMMatrix interface is a mutable transformation method that modifies a matrix by applying a specified scaling factor to all three axes, centered on the given origin, with a default origin of `(0, 0, 0)`, returning the 3D-scaled matrix.
2575
+ * The **`scale3dSelf()`** method of the DOMMatrix interface is a mutable transformation method that modifies a matrix by applying a specified scaling factor to all three axes, centered on the given origin, with a default origin of (0, 0, 0), returning the 3D-scaled matrix.
2576
2576
  *
2577
2577
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrix/scale3dSelf)
2578
2578
  */
2579
2579
  scale3dSelf(scale?: number, originX?: number, originY?: number, originZ?: number): DOMMatrix;
2580
2580
  /**
2581
- * The **`scaleSelf()`** method of the DOMMatrix interface is a mutable transformation method that modifies a matrix by applying a specified scaling factor, centered on the given origin, with a default origin of `(0, 0)`, returning the scaled matrix.
2581
+ * The **`scaleSelf()`** method of the DOMMatrix interface is a mutable transformation method that modifies a matrix by applying a specified scaling factor, centered on the given origin, with a default origin of (0, 0), returning the scaled matrix.
2582
2582
  *
2583
2583
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrix/scaleSelf)
2584
2584
  */
2585
2585
  scaleSelf(scaleX?: number, scaleY?: number, scaleZ?: number, originX?: number, originY?: number, originZ?: number): DOMMatrix;
2586
2586
  /**
2587
- * The `skewXSelf()` method of the DOMMatrix interface is a mutable transformation method that modifies a matrix.
2587
+ * The **`skewXSelf()`** method of the DOMMatrix interface is a mutable transformation method that modifies a matrix. It skews the source matrix by applying the specified skew transformation along the X-axis and returns the skewed matrix.
2588
2588
  *
2589
2589
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrix/skewXSelf)
2590
2590
  */
2591
2591
  skewXSelf(sx?: number): DOMMatrix;
2592
2592
  /**
2593
- * The `skewYSelf()` method of the DOMMatrix interface is a mutable transformation method that modifies a matrix.
2593
+ * The **`skewYSelf()`** method of the DOMMatrix interface is a mutable transformation method that modifies a matrix. It skews the source matrix by applying the specified skew transformation along the Y-axis and returns the skewed matrix.
2594
2594
  *
2595
2595
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrix/skewYSelf)
2596
2596
  */
2597
2597
  skewYSelf(sy?: number): DOMMatrix;
2598
2598
  /**
2599
- * The `translateSelf()` method of the DOMMatrix interface is a mutable transformation method that modifies a matrix.
2599
+ * The **`translateSelf()`** method of the DOMMatrix interface is a mutable transformation method that modifies a matrix. It applies the specified vectors and returns the updated matrix. The default vector is [0, 0, 0].
2600
2600
  *
2601
2601
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrix/translateSelf)
2602
2602
  */
@@ -2627,7 +2627,7 @@ declare var DOMMatrix: {
2627
2627
  };
2628
2628
 
2629
2629
  /**
2630
- * The **`DOMMatrixReadOnly`** interface represents a read-only 4×4 matrix, suitable for 2D and 3D operations.
2630
+ * The **`DOMMatrixReadOnly`** interface represents a read-only 4×4 matrix, suitable for 2D and 3D operations. The DOMMatrix interface — which is based upon DOMMatrixReadOnly—adds mutability, allowing you to alter the matrix after creating it.
2631
2631
  *
2632
2632
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly)
2633
2633
  */
@@ -2645,13 +2645,13 @@ interface DOMMatrixReadOnly {
2645
2645
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly#instance_properties) */
2646
2646
  readonly f: number;
2647
2647
  /**
2648
- * The readonly **`is2D`** property of the DOMMatrixReadOnly interface is a Boolean flag that is `true` when the matrix is 2D.
2648
+ * The readonly **`is2D`** property of the DOMMatrixReadOnly interface is a Boolean flag that is true when the matrix is 2D. The value is true if the matrix was initialized as a 2D matrix and only 2D transformation operations were applied. Otherwise, the matrix is defined in 3D, and is2D is false.
2649
2649
  *
2650
2650
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/is2D)
2651
2651
  */
2652
2652
  readonly is2D: boolean;
2653
2653
  /**
2654
- * The readonly **`isIdentity`** property of the DOMMatrixReadOnly interface is a Boolean whose value is `true` if the matrix is the identity matrix.
2654
+ * The readonly **`isIdentity`** property of the DOMMatrixReadOnly interface is a Boolean whose value is true if the matrix is the identity matrix.
2655
2655
  *
2656
2656
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/isIdentity)
2657
2657
  */
@@ -2689,43 +2689,43 @@ interface DOMMatrixReadOnly {
2689
2689
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly#instance_properties) */
2690
2690
  readonly m44: number;
2691
2691
  /**
2692
- * The **`flipX()`** method of the DOMMatrixReadOnly interface creates a new matrix being the result of the original matrix flipped about the x-axis.
2692
+ * The **`flipX()`** method of the DOMMatrixReadOnly interface creates a new matrix being the result of the original matrix flipped about the x-axis. This is equivalent to multiplying the matrix by DOMMatrix(-1, 0, 0, 1, 0, 0). The original matrix is not modified.
2693
2693
  *
2694
2694
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/flipX)
2695
2695
  */
2696
2696
  flipX(): DOMMatrix;
2697
2697
  /**
2698
- * The **`flipY()`** method of the DOMMatrixReadOnly interface creates a new matrix being the result of the original matrix flipped about the y-axis.
2698
+ * The **`flipY()`** method of the DOMMatrixReadOnly interface creates a new matrix being the result of the original matrix flipped about the y-axis. This is equivalent to multiplying the matrix by DOMMatrix(1, 0, 0, -1, 0, 0). The original matrix is not modified.
2699
2699
  *
2700
2700
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/flipY)
2701
2701
  */
2702
2702
  flipY(): DOMMatrix;
2703
2703
  /**
2704
- * The **`inverse()`** method of the DOMMatrixReadOnly interface creates a new matrix which is the inverse of the original matrix.
2704
+ * The **`inverse()`** method of the DOMMatrixReadOnly interface creates a new matrix which is the inverse of the original matrix. If the matrix cannot be inverted, the new matrix's components are all set to NaN and its is2D property is set to false. The original matrix is not changed.
2705
2705
  *
2706
2706
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/inverse)
2707
2707
  */
2708
2708
  inverse(): DOMMatrix;
2709
2709
  /**
2710
- * The **`multiply()`** method of the DOMMatrixReadOnly interface creates and returns a new matrix which is the dot product of the matrix and the `otherMatrix` parameter.
2710
+ * The **`multiply()`** method of the DOMMatrixReadOnly interface creates and returns a new matrix which is the dot product of the matrix and the otherMatrix parameter. If otherMatrix is omitted, the matrix is multiplied by a matrix in which every element is 0 except the bottom-right corner and the element immediately above and to its left: m33 and m34. These have the default value of 1. The original matrix is not modified.
2711
2711
  *
2712
2712
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/multiply)
2713
2713
  */
2714
2714
  multiply(other?: DOMMatrixInit): DOMMatrix;
2715
2715
  /**
2716
- * The `rotate()` method of the DOMMatrixReadOnly interface returns a new DOMMatrix created by rotating the source matrix around each of its axes by the specified number of degrees.
2716
+ * The **`rotate()`** method of the DOMMatrixReadOnly interface returns a new DOMMatrix created by rotating the source matrix around each of its axes by the specified number of degrees. The original matrix is not altered.
2717
2717
  *
2718
2718
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/rotate)
2719
2719
  */
2720
2720
  rotate(rotX?: number, rotY?: number, rotZ?: number): DOMMatrix;
2721
2721
  /**
2722
- * The `rotateAxisAngle()` method of the DOMMatrixReadOnly interface returns a new DOMMatrix created by rotating the source matrix by the given vector and angle.
2722
+ * The **`rotateAxisAngle()`** method of the DOMMatrixReadOnly interface returns a new DOMMatrix created by rotating the source matrix by the given vector and angle. The original matrix is not altered.
2723
2723
  *
2724
2724
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/rotateAxisAngle)
2725
2725
  */
2726
2726
  rotateAxisAngle(x?: number, y?: number, z?: number, angle?: number): DOMMatrix;
2727
2727
  /**
2728
- * The `rotateFromVector()` method of the DOMMatrixReadOnly interface is returns a new DOMMatrix created by rotating the source matrix by the angle between the specified vector and `(1, 0)`.
2728
+ * The **`rotateFromVector()`** method of the DOMMatrixReadOnly interface is returns a new DOMMatrix created by rotating the source matrix by the angle between the specified vector and (1, 0). The rotation angle is determined by the angle between the vector (1,0)T and (x,y)T in the clockwise direction, or (+/-)arctan(y/x). If x and y are both 0, the angle is specified as 0. The original matrix is not altered.
2729
2729
  *
2730
2730
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/rotateFromVector)
2731
2731
  */
@@ -2737,7 +2737,7 @@ interface DOMMatrixReadOnly {
2737
2737
  */
2738
2738
  scale(scaleX?: number, scaleY?: number, scaleZ?: number, originX?: number, originY?: number, originZ?: number): DOMMatrix;
2739
2739
  /**
2740
- * The **`scale3d()`** method of the DOMMatrixReadOnly interface creates a new matrix which is the result of a 3D scale transform being applied to the matrix.
2740
+ * The **`scale3d()`** method of the DOMMatrixReadOnly interface creates a new matrix which is the result of a 3D scale transform being applied to the matrix. It returns a new DOMMatrix created by scaling the source 3d matrix by the given scale factor centered on the origin point specified by the origin parameters, with a default origin of (0, 0, 0). The original matrix is not modified.
2741
2741
  *
2742
2742
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/scale3d)
2743
2743
  */
@@ -2745,43 +2745,43 @@ interface DOMMatrixReadOnly {
2745
2745
  /** @deprecated */
2746
2746
  scaleNonUniform(scaleX?: number, scaleY?: number): DOMMatrix;
2747
2747
  /**
2748
- * The `skewX()` method of the DOMMatrixReadOnly interface returns a new DOMMatrix created by applying the specified skew transformation to the source matrix along its x-axis.
2748
+ * The **`skewX()`** method of the DOMMatrixReadOnly interface returns a new DOMMatrix created by applying the specified skew transformation to the source matrix along its x-axis. The original matrix is not modified.
2749
2749
  *
2750
2750
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/skewX)
2751
2751
  */
2752
2752
  skewX(sx?: number): DOMMatrix;
2753
2753
  /**
2754
- * The `skewY()` method of the DOMMatrixReadOnly interface returns a new DOMMatrix created by applying the specified skew transformation to the source matrix along its y-axis.
2754
+ * The **`skewY()`** method of the DOMMatrixReadOnly interface returns a new DOMMatrix created by applying the specified skew transformation to the source matrix along its y-axis. The original matrix is not modified.
2755
2755
  *
2756
2756
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/skewY)
2757
2757
  */
2758
2758
  skewY(sy?: number): DOMMatrix;
2759
2759
  /**
2760
- * The **`toFloat32Array()`** method of the DOMMatrixReadOnly interface returns a new Float32Array containing all 16 elements (`m11`, `m12`, `m13`, `m14`, `m21`, `m22`, `m23`, `m24`, `m31`, `m32`, `m33`, `m34`, `m41`, `m42`, `m43`, `m44`) which comprise the matrix.
2760
+ * The **`toFloat32Array()`** method of the DOMMatrixReadOnly interface returns a new Float32Array containing all 16 elements (m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, m41, m42, m43, m44) which comprise the matrix. The elements are stored into the array as single-precision floating-point numbers in column-major (colexographical access, or "colex") order. (In other words, down the first column from top to bottom, then the second column, and so forth.)
2761
2761
  *
2762
2762
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/toFloat32Array)
2763
2763
  */
2764
2764
  toFloat32Array(): Float32Array<ArrayBuffer>;
2765
2765
  /**
2766
- * The **`toFloat64Array()`** method of the DOMMatrixReadOnly interface returns a new Float64Array containing all 16 elements (`m11`, `m12`, `m13`, `m14`, `m21`, `m22`, `m23`, `m24`, `m31`, `m32`, `m33`, `m34`, `m41`, `m42`, `m43`, `m44`) which comprise the matrix.
2766
+ * The **`toFloat64Array()`** method of the DOMMatrixReadOnly interface returns a new Float64Array containing all 16 elements (m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, m41, m42, m43, m44) which comprise the matrix. The elements are stored into the array as double-precision floating-point numbers in column-major (colexographical access, or "colex") order. (In other words, down the first column from top to bottom, then the second column, and so forth.)
2767
2767
  *
2768
2768
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/toFloat64Array)
2769
2769
  */
2770
2770
  toFloat64Array(): Float64Array<ArrayBuffer>;
2771
2771
  /**
2772
- * The **`toJSON()`** method of the DOMMatrixReadOnly interface creates and returns a JSON object.
2772
+ * The **`toJSON()`** method of the DOMMatrixReadOnly interface creates and returns a JSON object. The JSON object includes the 2D matrix elements a through f, the 16 elements of the 4X4 3D matrix, m[1-4][1-4], the boolean is2D property, and the boolean isIdentity property.
2773
2773
  *
2774
2774
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/toJSON)
2775
2775
  */
2776
2776
  toJSON(): any;
2777
2777
  /**
2778
- * The **`transformPoint`** method of the DOMMatrixReadOnly interface creates a new DOMPoint object, transforming a specified point by the matrix.
2778
+ * The **`transformPoint`** method of the DOMMatrixReadOnly interface creates a new DOMPoint object, transforming a specified point by the matrix. Neither the matrix nor the original point are altered.
2779
2779
  *
2780
2780
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/transformPoint)
2781
2781
  */
2782
2782
  transformPoint(point?: DOMPointInit): DOMPoint;
2783
2783
  /**
2784
- * The `translate()` method of the DOMMatrixReadOnly interface creates a new matrix being the result of the original matrix with a translation applied.
2784
+ * The **`translate()`** method of the DOMMatrixReadOnly interface creates a new matrix being the result of the original matrix with a translation applied.
2785
2785
  *
2786
2786
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/translate)
2787
2787
  */
@@ -2812,31 +2812,31 @@ declare var DOMMatrixReadOnly: {
2812
2812
  };
2813
2813
 
2814
2814
  /**
2815
- * A **`DOMPoint`** object represents a 2D or 3D point in a coordinate system; it includes values for the coordinates in up to three dimensions, as well as an optional perspective value.
2815
+ * A **`DOMPoint`** object represents a 2D or 3D point in a coordinate system; it includes values for the coordinates in up to three dimensions, as well as an optional perspective value. DOMPoint is based on DOMPointReadOnly but allows its properties' values to be changed.
2816
2816
  *
2817
2817
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMPoint)
2818
2818
  */
2819
2819
  interface DOMPoint extends DOMPointReadOnly {
2820
2820
  /**
2821
- * The **`DOMPoint`** interface's **`w`** property holds the point's perspective value, w, for a point in space.
2821
+ * The DOMPoint interface's **`w`** property holds the point's perspective value, w, for a point in space.
2822
2822
  *
2823
2823
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMPoint/w)
2824
2824
  */
2825
2825
  w: number;
2826
2826
  /**
2827
- * The **`DOMPoint`** interface's **`x`** property holds the horizontal coordinate, x, for a point in space.
2827
+ * The DOMPoint interface's **`x`** property holds the horizontal coordinate, x, for a point in space.
2828
2828
  *
2829
2829
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMPoint/x)
2830
2830
  */
2831
2831
  x: number;
2832
2832
  /**
2833
- * The **`DOMPoint`** interface's **`y`** property holds the vertical coordinate, _y_, for a point in space.
2833
+ * The DOMPoint interface's **`y`** property holds the vertical coordinate, y, for a point in space.
2834
2834
  *
2835
2835
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMPoint/y)
2836
2836
  */
2837
2837
  y: number;
2838
2838
  /**
2839
- * The **`DOMPoint`** interface's **`z`** property specifies the depth coordinate of a point in space.
2839
+ * The DOMPoint interface's **`z`** property specifies the depth coordinate of a point in space.
2840
2840
  *
2841
2841
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMPoint/z)
2842
2842
  */
@@ -2847,7 +2847,7 @@ declare var DOMPoint: {
2847
2847
  prototype: DOMPoint;
2848
2848
  new(x?: number, y?: number, z?: number, w?: number): DOMPoint;
2849
2849
  /**
2850
- * The **`fromPoint()`** static method of the DOMPoint interface creates and returns a new mutable `DOMPoint` object given a source point.
2850
+ * The **`fromPoint()`** static method of the DOMPoint interface creates and returns a new mutable DOMPoint object given a source point.
2851
2851
  *
2852
2852
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMPoint/fromPoint_static)
2853
2853
  */
@@ -2861,37 +2861,37 @@ declare var DOMPoint: {
2861
2861
  */
2862
2862
  interface DOMPointReadOnly {
2863
2863
  /**
2864
- * The **`DOMPointReadOnly`** interface's **`w`** property holds the point's perspective value, `w`, for a read-only point in space.
2864
+ * The DOMPointReadOnly interface's **`w`** property holds the point's perspective value, w, for a read-only point in space.
2865
2865
  *
2866
2866
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMPointReadOnly/w)
2867
2867
  */
2868
2868
  readonly w: number;
2869
2869
  /**
2870
- * The **`DOMPointReadOnly`** interface's **`x`** property holds the horizontal coordinate, x, for a read-only point in space.
2870
+ * The DOMPointReadOnly interface's **`x`** property holds the horizontal coordinate, x, for a read-only point in space. This property cannot be changed by JavaScript code in this read-only version of the DOMPoint object.
2871
2871
  *
2872
2872
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMPointReadOnly/x)
2873
2873
  */
2874
2874
  readonly x: number;
2875
2875
  /**
2876
- * The **`DOMPointReadOnly`** interface's **`y`** property holds the vertical coordinate, y, for a read-only point in space.
2876
+ * The DOMPointReadOnl**`y`** interface's y property holds the vertical coordinate, y, for a read-only point in space.
2877
2877
  *
2878
2878
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMPointReadOnly/y)
2879
2879
  */
2880
2880
  readonly y: number;
2881
2881
  /**
2882
- * The **`DOMPointReadOnly`** interface's **`z`** property holds the depth coordinate, z, for a read-only point in space.
2882
+ * The DOMPointReadOnly interface's **`z`** property holds the depth coordinate, z, for a read-only point in space.
2883
2883
  *
2884
2884
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMPointReadOnly/z)
2885
2885
  */
2886
2886
  readonly z: number;
2887
2887
  /**
2888
- * The **`matrixTransform()`** method of the DOMPointReadOnly interface applies a matrix transform specified as an object to the DOMPointReadOnly object, creating and returning a new `DOMPointReadOnly` object.
2888
+ * The **`matrixTransform()`** method of the DOMPointReadOnly interface applies a matrix transform specified as an object to the DOMPointReadOnly object, creating and returning a new DOMPointReadOnly object. Neither the matrix nor the point are altered.
2889
2889
  *
2890
2890
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMPointReadOnly/matrixTransform)
2891
2891
  */
2892
2892
  matrixTransform(matrix?: DOMMatrixInit): DOMPoint;
2893
2893
  /**
2894
- * The DOMPointReadOnly method `toJSON()` returns an object giving the JSON form of the point object.
2894
+ * The DOMPointReadOnly method **`toJSON()`** returns an object giving the JSON form of the point object.
2895
2895
  *
2896
2896
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMPointReadOnly/toJSON)
2897
2897
  */
@@ -2902,7 +2902,7 @@ declare var DOMPointReadOnly: {
2902
2902
  prototype: DOMPointReadOnly;
2903
2903
  new(x?: number, y?: number, z?: number, w?: number): DOMPointReadOnly;
2904
2904
  /**
2905
- * The static **DOMPointReadOnly** method `fromPoint()` creates and returns a new `DOMPointReadOnly` object given a source point.
2905
+ * The static DOMPointReadOnly method **`fromPoint()`** creates and returns a new DOMPointReadOnly object given a source point.
2906
2906
  *
2907
2907
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMPointReadOnly/fromPoint_static)
2908
2908
  */
@@ -2910,43 +2910,43 @@ declare var DOMPointReadOnly: {
2910
2910
  };
2911
2911
 
2912
2912
  /**
2913
- * A `DOMQuad` is a collection of four `DOMPoint`s defining the corners of an arbitrary quadrilateral.
2913
+ * A **`DOMQuad`** is a collection of four DOMPoints defining the corners of an arbitrary quadrilateral. Returning DOMQuads lets getBoxQuads() return accurate information even when arbitrary 2D or 3D transforms are present. It has a handy bounds attribute returning a DOMRectReadOnly for those cases where you just want an axis-aligned bounding rectangle.
2914
2914
  *
2915
2915
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMQuad)
2916
2916
  */
2917
2917
  interface DOMQuad {
2918
2918
  /**
2919
- * The **`DOMQuad`** interface's **`p1`** property holds the DOMPoint object that represents one of the four corners of the `DOMQuad`.
2919
+ * The DOMQuad interface's **`p1`** property holds the DOMPoint object that represents one of the four corners of the DOMQuad. When created from DOMQuad.fromRect(), it is the point (x, y).
2920
2920
  *
2921
2921
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMQuad/p1)
2922
2922
  */
2923
2923
  readonly p1: DOMPoint;
2924
2924
  /**
2925
- * The **`DOMQuad`** interface's **`p2`** property holds the DOMPoint object that represents one of the four corners of the `DOMQuad`.
2925
+ * The DOMQuad interface's **`p2`** property holds the DOMPoint object that represents one of the four corners of the DOMQuad. When created from DOMQuad.fromRect(), it is the point (x + width, y).
2926
2926
  *
2927
2927
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMQuad/p2)
2928
2928
  */
2929
2929
  readonly p2: DOMPoint;
2930
2930
  /**
2931
- * The **`DOMQuad`** interface's **`p3`** property holds the DOMPoint object that represents one of the four corners of the `DOMQuad`.
2931
+ * The DOMQuad interface's **`p3`** property holds the DOMPoint object that represents one of the four corners of the DOMQuad. When created from DOMQuad.fromRect(), it is the point (x + width, y + height).
2932
2932
  *
2933
2933
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMQuad/p3)
2934
2934
  */
2935
2935
  readonly p3: DOMPoint;
2936
2936
  /**
2937
- * The **`DOMQuad`** interface's **`p4`** property holds the DOMPoint object that represents one of the four corners of the `DOMQuad`.
2937
+ * The DOMQuad interface's **`p4`** property holds the DOMPoint object that represents one of the four corners of the DOMQuad. When created from DOMQuad.fromRect(), it is the point (x, y + height).
2938
2938
  *
2939
2939
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMQuad/p4)
2940
2940
  */
2941
2941
  readonly p4: DOMPoint;
2942
2942
  /**
2943
- * The DOMQuad method `getBounds()` returns a DOMRect object representing the smallest rectangle that fully contains the `DOMQuad` object.
2943
+ * The DOMQuad method **`getBounds()`** returns a DOMRect object representing the smallest rectangle that fully contains the DOMQuad object.
2944
2944
  *
2945
2945
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMQuad/getBounds)
2946
2946
  */
2947
2947
  getBounds(): DOMRect;
2948
2948
  /**
2949
- * The DOMQuad method `toJSON()` returns a JSON representation of the `DOMQuad` object.
2949
+ * The DOMQuad method **`toJSON()`** returns a JSON representation of the DOMQuad object.
2950
2950
  *
2951
2951
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMQuad/toJSON)
2952
2952
  */
@@ -2957,13 +2957,13 @@ declare var DOMQuad: {
2957
2957
  prototype: DOMQuad;
2958
2958
  new(p1?: DOMPointInit, p2?: DOMPointInit, p3?: DOMPointInit, p4?: DOMPointInit): DOMQuad;
2959
2959
  /**
2960
- * The **`fromQuad()`** static method of the DOMQuad interface returns a new `DOMQuad` object based on the provided set of coordinates in the shape of another `DOMQuad` object.
2960
+ * The **`fromQuad()`** static method of the DOMQuad interface returns a new DOMQuad object based on the provided set of coordinates in the shape of another DOMQuad object.
2961
2961
  *
2962
2962
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMQuad/fromQuad_static)
2963
2963
  */
2964
2964
  fromQuad(other?: DOMQuadInit): DOMQuad;
2965
2965
  /**
2966
- * The **`fromRect()`** static method of the DOMQuad interface returns a new `DOMQuad` object based on the provided set of coordinates in the shape of a DOMRect object.
2966
+ * The **`fromRect()`** static method of the DOMQuad interface returns a new DOMQuad object based on the provided set of coordinates in the shape of a DOMRect object.
2967
2967
  *
2968
2968
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMQuad/fromRect_static)
2969
2969
  */
@@ -2977,13 +2977,13 @@ declare var DOMQuad: {
2977
2977
  */
2978
2978
  interface DOMRect extends DOMRectReadOnly {
2979
2979
  /**
2980
- * The **`height`** property of the DOMRect interface represents the height of the rectangle.
2980
+ * The **`height`** property of the DOMRect interface represents the height of the rectangle. The value can be negative.
2981
2981
  *
2982
2982
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRect/height)
2983
2983
  */
2984
2984
  height: number;
2985
2985
  /**
2986
- * The **`width`** property of the DOMRect interface represents the width of the rectangle.
2986
+ * The **`width`** property of the DOMRect interface represents the width of the rectangle. The value can be negative.
2987
2987
  *
2988
2988
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRect/width)
2989
2989
  */
@@ -3006,7 +3006,7 @@ declare var DOMRect: {
3006
3006
  prototype: DOMRect;
3007
3007
  new(x?: number, y?: number, width?: number, height?: number): DOMRect;
3008
3008
  /**
3009
- * The **`fromRect()`** static method of the DOMRect object creates a new `DOMRect` object with a given location and dimensions.
3009
+ * The **`fromRect()`** static method of the DOMRect object creates a new DOMRect object with a given location and dimensions.
3010
3010
  *
3011
3011
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRect/fromRect_static)
3012
3012
  */
@@ -3020,55 +3020,55 @@ declare var DOMRect: {
3020
3020
  */
3021
3021
  interface DOMRectReadOnly {
3022
3022
  /**
3023
- * The **`bottom`** read-only property of the **`DOMRectReadOnly`** interface returns the bottom coordinate value of the `DOMRect`.
3023
+ * The **`bottom`** read-only property of the DOMRectReadOnly interface returns the bottom coordinate value of the DOMRect. (Has the same value as y + height, or y if height is negative.)
3024
3024
  *
3025
3025
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/bottom)
3026
3026
  */
3027
3027
  readonly bottom: number;
3028
3028
  /**
3029
- * The **`height`** read-only property of the **`DOMRectReadOnly`** interface represents the height of the `DOMRect`.
3029
+ * The **`height`** read-only property of the DOMRectReadOnly interface represents the height of the DOMRect.
3030
3030
  *
3031
3031
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/height)
3032
3032
  */
3033
3033
  readonly height: number;
3034
3034
  /**
3035
- * The **`left`** read-only property of the **`DOMRectReadOnly`** interface returns the left coordinate value of the `DOMRect`.
3035
+ * The **`left`** read-only property of the DOMRectReadOnly interface returns the left coordinate value of the DOMRect. (Has the same value as x, or x + width if width is negative.)
3036
3036
  *
3037
3037
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/left)
3038
3038
  */
3039
3039
  readonly left: number;
3040
3040
  /**
3041
- * The **`right`** read-only property of the **`DOMRectReadOnly`** interface returns the right coordinate value of the `DOMRect`.
3041
+ * The **`right`** read-only property of the DOMRectReadOnly interface returns the right coordinate value of the DOMRect. (Has the same value as x + width, or x if width is negative.)
3042
3042
  *
3043
3043
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/right)
3044
3044
  */
3045
3045
  readonly right: number;
3046
3046
  /**
3047
- * The **`top`** read-only property of the **`DOMRectReadOnly`** interface returns the top coordinate value of the `DOMRect`.
3047
+ * The **`top`** read-only property of the DOMRectReadOnly interface returns the top coordinate value of the DOMRect. (Has the same value as y, or y + height if height is negative.)
3048
3048
  *
3049
3049
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/top)
3050
3050
  */
3051
3051
  readonly top: number;
3052
3052
  /**
3053
- * The **`width`** read-only property of the **`DOMRectReadOnly`** interface represents the width of the `DOMRect`.
3053
+ * The **`width`** read-only property of the DOMRectReadOnly interface represents the width of the DOMRect.
3054
3054
  *
3055
3055
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/width)
3056
3056
  */
3057
3057
  readonly width: number;
3058
3058
  /**
3059
- * The **`x`** read-only property of the **`DOMRectReadOnly`** interface represents the x coordinate of the `DOMRect`'s origin.
3059
+ * The **`x`** read-only property of the DOMRectReadOnly interface represents the x coordinate of the DOMRect's origin.
3060
3060
  *
3061
3061
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/x)
3062
3062
  */
3063
3063
  readonly x: number;
3064
3064
  /**
3065
- * The **`y`** read-only property of the **`DOMRectReadOnly`** interface represents the y coordinate of the `DOMRect`'s origin.
3065
+ * The **`y`** read-only property of the DOMRectReadOnly interface represents the y coordinate of the DOMRect's origin.
3066
3066
  *
3067
3067
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/y)
3068
3068
  */
3069
3069
  readonly y: number;
3070
3070
  /**
3071
- * The DOMRectReadOnly method `toJSON()` returns a JSON representation of the `DOMRectReadOnly` object.
3071
+ * The DOMRectReadOnly method **`toJSON()`** returns a JSON representation of the DOMRectReadOnly object.
3072
3072
  *
3073
3073
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/toJSON)
3074
3074
  */
@@ -3079,7 +3079,7 @@ declare var DOMRectReadOnly: {
3079
3079
  prototype: DOMRectReadOnly;
3080
3080
  new(x?: number, y?: number, width?: number, height?: number): DOMRectReadOnly;
3081
3081
  /**
3082
- * The **`fromRect()`** static method of the DOMRectReadOnly object creates a new `DOMRectReadOnly` object with a given location and dimensions.
3082
+ * The **`fromRect()`** static method of the DOMRectReadOnly object creates a new DOMRectReadOnly object with a given location and dimensions.
3083
3083
  *
3084
3084
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/fromRect_static)
3085
3085
  */
@@ -3087,7 +3087,7 @@ declare var DOMRectReadOnly: {
3087
3087
  };
3088
3088
 
3089
3089
  /**
3090
- * The **`DOMStringList`** interface is a legacy type returned by some APIs and represents a non-modifiable list of strings (`DOMString`).
3090
+ * The **`DOMStringList`** interface is a legacy type returned by some APIs and represents a non-modifiable list of strings (DOMString).
3091
3091
  *
3092
3092
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMStringList)
3093
3093
  */
@@ -3105,7 +3105,7 @@ interface DOMStringList {
3105
3105
  */
3106
3106
  contains(string: string): boolean;
3107
3107
  /**
3108
- * The **`item()`** method returns a string from a `DOMStringList` by index.
3108
+ * The **`item()`** method returns a string from a DOMStringList by index.
3109
3109
  *
3110
3110
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMStringList/item)
3111
3111
  */
@@ -3164,7 +3164,7 @@ interface EXT_color_buffer_half_float {
3164
3164
  }
3165
3165
 
3166
3166
  /**
3167
- * The WebGL API's `EXT_float_blend` extension allows blending and draw buffers with 32-bit floating-point components.
3167
+ * The WebGL API's **`EXT_float_blend`** extension allows blending and draw buffers with 32-bit floating-point components.
3168
3168
  *
3169
3169
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EXT_float_blend)
3170
3170
  */
@@ -3200,7 +3200,7 @@ interface EXT_shader_texture_lod {
3200
3200
  }
3201
3201
 
3202
3202
  /**
3203
- * The `EXT_texture_compression_bptc` extension is part of the WebGL API and exposes 4 BPTC compressed texture formats.
3203
+ * The **`EXT_texture_compression_bptc`** extension is part of the WebGL API and exposes 4 BPTC compressed texture formats. These compression formats are called BC7 and BC6H in Microsoft's DirectX API.
3204
3204
  *
3205
3205
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EXT_texture_compression_bptc)
3206
3206
  */
@@ -3212,7 +3212,7 @@ interface EXT_texture_compression_bptc {
3212
3212
  }
3213
3213
 
3214
3214
  /**
3215
- * The `EXT_texture_compression_rgtc` extension is part of the WebGL API and exposes 4 RGTC compressed texture formats.
3215
+ * The **`EXT_texture_compression_rgtc`** extension is part of the WebGL API and exposes 4 RGTC compressed texture formats. RGTC is a block-based texture compression format suited for unsigned and signed red and red-green textures (Red-Green Texture Compression).
3216
3216
  *
3217
3217
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EXT_texture_compression_rgtc)
3218
3218
  */
@@ -3293,7 +3293,7 @@ declare var ErrorEvent: {
3293
3293
  };
3294
3294
 
3295
3295
  /**
3296
- * The **`Event`** interface represents an event which takes place on an `EventTarget`.
3296
+ * The **`Event`** interface represents an event which takes place on an EventTarget.
3297
3297
  *
3298
3298
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event)
3299
3299
  */
@@ -3305,7 +3305,7 @@ interface Event {
3305
3305
  */
3306
3306
  readonly bubbles: boolean;
3307
3307
  /**
3308
- * The **`cancelBubble`** property of the Event interface is deprecated.
3308
+ * The **`cancelBubble`** property of the Event interface is deprecated. Use Event.stopPropagation() instead. Setting its value to true before returning from an event handler prevents propagation of the event. In later implementations, setting this to false does nothing. See Browser compatibility for details.
3309
3309
  * @deprecated
3310
3310
  *
3311
3311
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelBubble)
@@ -3342,7 +3342,7 @@ interface Event {
3342
3342
  */
3343
3343
  readonly eventPhase: number;
3344
3344
  /**
3345
- * The **`isTrusted`** read-only property of the Event interface is a boolean value that is `true` when the event was generated by the user agent (including via user actions and programmatic methods such as HTMLElement.focus()), and `false` when the event was dispatched via EventTarget.dispatchEvent().
3345
+ * The **`isTrusted`** read-only property of the Event interface is a boolean value that is true when the event was generated by the user agent (including via user actions and programmatic methods such as HTMLElement.focus()), and false when the event was dispatched via EventTarget.dispatchEvent(). The only exception is the click event, which initializes the isTrusted property to false in user agents.
3346
3346
  *
3347
3347
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/isTrusted)
3348
3348
  */
@@ -3355,14 +3355,14 @@ interface Event {
3355
3355
  */
3356
3356
  returnValue: boolean;
3357
3357
  /**
3358
- * The deprecated **`Event.srcElement`** is an alias for the Event.target property.
3358
+ * The deprecated **`Event.srcElement`** is an alias for the Event.target property. Use Event.target instead.
3359
3359
  * @deprecated
3360
3360
  *
3361
3361
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/srcElement)
3362
3362
  */
3363
3363
  readonly srcElement: EventTarget | null;
3364
3364
  /**
3365
- * The read-only **`target`** property of the Event interface is a reference to the object onto which the event was dispatched.
3365
+ * The read-only **`target`** property of the Event interface is a reference to the object onto which the event was dispatched. It is different from Event.currentTarget when the event handler is called during the bubbling or capturing phase of the event.
3366
3366
  *
3367
3367
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/target)
3368
3368
  */
@@ -3374,13 +3374,13 @@ interface Event {
3374
3374
  */
3375
3375
  readonly timeStamp: DOMHighResTimeStamp;
3376
3376
  /**
3377
- * The **`type`** read-only property of the Event interface returns a string containing the event's type.
3377
+ * The **`type`** read-only property of the Event interface returns a string containing the event's type. It is set when the event is constructed and is the name commonly used to refer to the specific event, such as click, load, or error.
3378
3378
  *
3379
3379
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/type)
3380
3380
  */
3381
3381
  readonly type: string;
3382
3382
  /**
3383
- * The **`composedPath()`** method of the Event interface returns the event's path which is an array of the objects on which listeners will be invoked.
3383
+ * The **`composedPath()`** method of the Event interface returns the event's path which is an array of the objects on which listeners will be invoked. This does not include nodes in shadow trees if the shadow root was created with its ShadowRoot.mode closed.
3384
3384
  *
3385
3385
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composedPath)
3386
3386
  */
@@ -3405,7 +3405,7 @@ interface Event {
3405
3405
  */
3406
3406
  stopImmediatePropagation(): void;
3407
3407
  /**
3408
- * The **`stopPropagation()`** method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases.
3408
+ * The **`stopPropagation()`** method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases. It does not, however, prevent any default behaviors from occurring; for instance, clicks on links are still processed. If you want to stop those behaviors, see the preventDefault() method. It also does not prevent propagation to other event-handlers of the current element. If you want to stop those, see stopImmediatePropagation().
3409
3409
  *
3410
3410
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopPropagation)
3411
3411
  */
@@ -3464,13 +3464,13 @@ interface EventSource extends EventTarget {
3464
3464
  */
3465
3465
  readonly url: string;
3466
3466
  /**
3467
- * The **`withCredentials`** read-only property of the EventSource interface returns a boolean value indicating whether the `EventSource` object was instantiated with CORS credentials set.
3467
+ * The **`withCredentials`** read-only property of the EventSource interface returns a boolean value indicating whether the EventSource object was instantiated with CORS credentials set.
3468
3468
  *
3469
3469
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/withCredentials)
3470
3470
  */
3471
3471
  readonly withCredentials: boolean;
3472
3472
  /**
3473
- * The **`close()`** method of the EventSource interface closes the connection, if one is made, and sets the EventSource.readyState attribute to `2` (closed).
3473
+ * The **`close()`** method of the EventSource interface closes the connection, if one is made, and sets the EventSource.readyState attribute to 2 (closed).
3474
3474
  *
3475
3475
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/close)
3476
3476
  */
@@ -3495,7 +3495,7 @@ declare var EventSource: {
3495
3495
  };
3496
3496
 
3497
3497
  /**
3498
- * The **`EventTarget`** interface is implemented by objects that can receive events and may have listeners for them.
3498
+ * The **`EventTarget`** interface is implemented by objects that can receive events and may have listeners for them. In other words, any target of events implements the three methods associated with this interface.
3499
3499
  *
3500
3500
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget)
3501
3501
  */
@@ -3507,13 +3507,13 @@ interface EventTarget {
3507
3507
  */
3508
3508
  addEventListener(type: string, callback: EventListenerOrEventListenerObject | null, options?: AddEventListenerOptions | boolean): void;
3509
3509
  /**
3510
- * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.
3510
+ * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order. The normal event processing rules (including the capturing and optional bubbling phase) also apply to events dispatched manually with dispatchEvent().
3511
3511
  *
3512
3512
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)
3513
3513
  */
3514
3514
  dispatchEvent(event: Event): boolean;
3515
3515
  /**
3516
- * The **`removeEventListener()`** method of the EventTarget interface removes an event listener previously registered with EventTarget.addEventListener() from the target.
3516
+ * The **`removeEventListener()`** method of the EventTarget interface removes an event listener previously registered with EventTarget.addEventListener() from the target. The event listener to be removed is identified using a combination of the event type, the event listener function itself, and various optional options that may affect the matching process; see Matching event listeners for removal.
3517
3517
  *
3518
3518
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/removeEventListener)
3519
3519
  */
@@ -3526,19 +3526,19 @@ declare var EventTarget: {
3526
3526
  };
3527
3527
 
3528
3528
  /**
3529
- * The **`ExtendableCookieChangeEvent`** interface of the Cookie Store API is the event type passed to ServiceWorkerGlobalScope/cookiechange_event event fired at the ServiceWorkerGlobalScope when any cookie changes occur which match the service worker's cookie change subscription list.
3529
+ * The **`ExtendableCookieChangeEvent`** interface of the Cookie Store API is the event type passed to cookiechange event fired at the ServiceWorkerGlobalScope when any cookie changes occur which match the service worker's cookie change subscription list. A cookie change event consists of a cookie and a type (either "changed" or "deleted").
3530
3530
  *
3531
3531
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableCookieChangeEvent)
3532
3532
  */
3533
3533
  interface ExtendableCookieChangeEvent extends ExtendableEvent {
3534
3534
  /**
3535
- * The **`changed`** read-only property of the ExtendableCookieChangeEvent interface returns any cookies that have been changed by the given `ExtendableCookieChangeEvent` instance.
3535
+ * The **`changed`** read-only property of the ExtendableCookieChangeEvent interface returns any cookies that have been changed by the given ExtendableCookieChangeEvent instance.
3536
3536
  *
3537
3537
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableCookieChangeEvent/changed)
3538
3538
  */
3539
3539
  readonly changed: ReadonlyArray<CookieListItem>;
3540
3540
  /**
3541
- * The **`deleted`** read-only property of the ExtendableCookieChangeEvent interface returns any cookies that have been deleted by the given `ExtendableCookieChangeEvent` instance.
3541
+ * The **`deleted`** read-only property of the ExtendableCookieChangeEvent interface returns any cookies that have been deleted by the given ExtendableCookieChangeEvent instance.
3542
3542
  *
3543
3543
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableCookieChangeEvent/deleted)
3544
3544
  */
@@ -3551,13 +3551,13 @@ declare var ExtendableCookieChangeEvent: {
3551
3551
  };
3552
3552
 
3553
3553
  /**
3554
- * The **`ExtendableEvent`** interface extends the lifetime of the `install` and `activate` events dispatched on the global scope as part of the service worker lifecycle.
3554
+ * The **`ExtendableEvent`** interface extends the lifetime of the install and activate events dispatched on the global scope as part of the service worker lifecycle. This ensures that any functional events (like FetchEvent) are not dispatched until it upgrades database schemas and deletes the outdated cache entries.
3555
3555
  *
3556
3556
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableEvent)
3557
3557
  */
3558
3558
  interface ExtendableEvent extends Event {
3559
3559
  /**
3560
- * The **`ExtendableEvent.waitUntil()`** method tells the event dispatcher that work is ongoing.
3560
+ * The **`ExtendableEvent.waitUntil()`** method tells the event dispatcher that work is ongoing. It can also be used to detect whether that work was successful. In service workers, waitUntil() tells the browser that work is ongoing until the promise settles, and it shouldn't terminate the service worker if it wants that work to complete.
3561
3561
  *
3562
3562
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableEvent/waitUntil)
3563
3563
  */
@@ -3570,19 +3570,19 @@ declare var ExtendableEvent: {
3570
3570
  };
3571
3571
 
3572
3572
  /**
3573
- * The **`ExtendableMessageEvent`** interface of the Service Worker API represents the event object of a ServiceWorkerGlobalScope/message_event event fired on a service worker (when a message is received on the ServiceWorkerGlobalScope from another context) — extends the lifetime of such events.
3573
+ * The **`ExtendableMessageEvent`** interface of the Service Worker API represents the event object of a message event fired on a service worker (when a message is received on the ServiceWorkerGlobalScope from another context) — extends the lifetime of such events.
3574
3574
  *
3575
3575
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableMessageEvent)
3576
3576
  */
3577
3577
  interface ExtendableMessageEvent extends ExtendableEvent {
3578
3578
  /**
3579
- * The **`data`** read-only property of the ExtendableMessageEvent interface returns the event's data.
3579
+ * The **`data`** read-only property of the ExtendableMessageEvent interface returns the event's data. It can be any data type.
3580
3580
  *
3581
3581
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableMessageEvent/data)
3582
3582
  */
3583
3583
  readonly data: any;
3584
3584
  /**
3585
- * The **`lastEventID`** read-only property of the ExtendableMessageEvent interface represents, in server-sent events, the last event ID of the event source.
3585
+ * The lastEventID read-only property of the ExtendableMessageEvent interface represents, in server-sent events, the last event ID of the event source. This is an empty string.
3586
3586
  *
3587
3587
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableMessageEvent/lastEventId)
3588
3588
  */
@@ -3613,7 +3613,7 @@ declare var ExtendableMessageEvent: {
3613
3613
  };
3614
3614
 
3615
3615
  /**
3616
- * This is the event type for `fetch` events dispatched on the ServiceWorkerGlobalScope.
3616
+ * This is the event type for fetch events dispatched on the service worker global scope. It contains information about the fetch, including the request and how the receiver will treat the response. It provides the event.respondWith() method, which allows us to provide a response to this fetch.
3617
3617
  *
3618
3618
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent)
3619
3619
  */
@@ -3625,13 +3625,13 @@ interface FetchEvent extends ExtendableEvent {
3625
3625
  */
3626
3626
  readonly clientId: string;
3627
3627
  /**
3628
- * The **`handled`** property of the FetchEvent interface returns a promise indicating if the event has been handled by the fetch algorithm or not.
3628
+ * The **`handled`** property of the FetchEvent interface returns a promise indicating if the event has been handled by the fetch algorithm or not. This property allows executing code after the browser has consumed a response, and is usually used together with the waitUntil() method.
3629
3629
  *
3630
3630
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/handled)
3631
3631
  */
3632
3632
  readonly handled: Promise<void>;
3633
3633
  /**
3634
- * The **`preloadResponse`** read-only property of the FetchEvent interface returns a Promise that resolves to the navigation preload Response if navigation preload was triggered, or `undefined` otherwise.
3634
+ * The **`preloadResponse`** read-only property of the FetchEvent interface returns a Promise that resolves to the navigation preload Response if navigation preload was triggered, or undefined otherwise.
3635
3635
  *
3636
3636
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/preloadResponse)
3637
3637
  */
@@ -3643,7 +3643,7 @@ interface FetchEvent extends ExtendableEvent {
3643
3643
  */
3644
3644
  readonly request: Request;
3645
3645
  /**
3646
- * The **`resultingClientId`** read-only property of the FetchEvent interface is the Client.id of the Client that replaces the previous client during a page navigation.
3646
+ * The **`resultingClientId`** read-only property of the FetchEvent interface is the id of the client that replaces the previous client during a page navigation.
3647
3647
  *
3648
3648
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/resultingClientId)
3649
3649
  */
@@ -3668,19 +3668,19 @@ declare var FetchEvent: {
3668
3668
  */
3669
3669
  interface File extends Blob {
3670
3670
  /**
3671
- * The **`lastModified`** read-only property of the File interface provides the last modified date of the file as the number of milliseconds since the Unix epoch (January 1, 1970 at midnight).
3671
+ * The **`lastModified`** read-only property of the File interface provides the last modified date of the file as the number of milliseconds since the Unix epoch (January 1, 1970 at midnight). Files without a known last modified date return the current date.
3672
3672
  *
3673
3673
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/lastModified)
3674
3674
  */
3675
3675
  readonly lastModified: number;
3676
3676
  /**
3677
- * The **`name`** read-only property of the File interface returns the name of the file represented by a File object.
3677
+ * The **`name`** read-only property of the File interface returns the name of the file represented by a File object. For security reasons, the path is excluded from this property.
3678
3678
  *
3679
3679
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/name)
3680
3680
  */
3681
3681
  readonly name: string;
3682
3682
  /**
3683
- * The **`webkitRelativePath`** read-only property of the File interface contains a string which specifies the file's path relative to the directory selected by the user in an input element with its `webkitdirectory` attribute set.
3683
+ * The **`webkitRelativePath`** read-only property of the File interface contains a string which specifies the file's path relative to the directory selected by the user in an <input> element with its webkitdirectory attribute set.
3684
3684
  *
3685
3685
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/webkitRelativePath)
3686
3686
  */
@@ -3693,13 +3693,13 @@ declare var File: {
3693
3693
  };
3694
3694
 
3695
3695
  /**
3696
- * The **`FileList`** interface represents an object of this type returned by the `files` property of the HTML input element; this lets you access the list of files selected with the `<input type='file'>` element.
3696
+ * The **`FileList`** interface represents an object of this type returned by the files property of the HTML <input> element; this lets you access the list of files selected with the <input type="file"> element. It's also used for a list of files dropped into web content when using the drag and drop API; see the DataTransfer object for details on this usage.
3697
3697
  *
3698
3698
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileList)
3699
3699
  */
3700
3700
  interface FileList {
3701
3701
  /**
3702
- * The **`length`** read-only property of the FileList interface returns the number of files in the `FileList`.
3702
+ * The **`length`** read-only property of the FileList interface returns the number of files in the FileList.
3703
3703
  *
3704
3704
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileList/length)
3705
3705
  */
@@ -3752,44 +3752,44 @@ interface FileReader extends EventTarget {
3752
3752
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileReader/progress_event) */
3753
3753
  onprogress: ((this: FileReader, ev: ProgressEvent<FileReader>) => any) | null;
3754
3754
  /**
3755
- * The **`readyState`** read-only property of the FileReader interface provides the current state of the reading operation.
3755
+ * The **`readyState`** read-only property of the FileReader interface provides the current state of the reading operation. This will be one of the states: EMPTY, LOADING, or DONE.
3756
3756
  *
3757
3757
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileReader/readyState)
3758
3758
  */
3759
3759
  readonly readyState: typeof FileReader.EMPTY | typeof FileReader.LOADING | typeof FileReader.DONE;
3760
3760
  /**
3761
- * The **`result`** read-only property of the FileReader interface returns the file's contents.
3761
+ * The **`result`** read-only property of the FileReader interface returns the file's contents. This property is only valid after the read operation is complete, and the format of the data depends on which of the methods was used to initiate the read operation.
3762
3762
  *
3763
3763
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileReader/result)
3764
3764
  */
3765
3765
  readonly result: string | ArrayBuffer | null;
3766
3766
  /**
3767
- * The **`abort()`** method of the FileReader interface aborts the read operation.
3767
+ * The **`abort()`** method of the FileReader interface aborts the read operation. Upon return, the readyState will be DONE.
3768
3768
  *
3769
3769
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileReader/abort)
3770
3770
  */
3771
3771
  abort(): void;
3772
3772
  /**
3773
- * The **`readAsArrayBuffer()`** method of the FileReader interface is used to start reading the contents of a specified Blob or File.
3773
+ * The **`readAsArrayBuffer()`** method of the FileReader interface is used to start reading the contents of a specified Blob or File. When the read operation is finished, the readyState property becomes DONE, and the loadend event is triggered. At that time, the result property contains an ArrayBuffer representing the file's data.
3774
3774
  *
3775
3775
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileReader/readAsArrayBuffer)
3776
3776
  */
3777
3777
  readAsArrayBuffer(blob: Blob): void;
3778
3778
  /**
3779
- * The **`readAsBinaryString()`** method of the FileReader interface is used to start reading the contents of the specified Blob or File.
3779
+ * The **`readAsBinaryString()`** method of the FileReader interface is used to start reading the contents of the specified Blob or File. When the read operation is finished, the readyState property becomes DONE, and the loadend event is triggered. At that time, the result property contains the raw binary data from the file.
3780
3780
  * @deprecated
3781
3781
  *
3782
3782
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileReader/readAsBinaryString)
3783
3783
  */
3784
3784
  readAsBinaryString(blob: Blob): void;
3785
3785
  /**
3786
- * The **`readAsDataURL()`** method of the FileReader interface is used to read the contents of the specified Blob or File.
3786
+ * The **`readAsDataURL()`** method of the FileReader interface is used to read the contents of the specified Blob or File. When the read operation is finished, the readyState property becomes DONE, and the loadend event is triggered. At that time, the result attribute contains the data as a data: URL representing the file's data as a base64 encoded string.
3787
3787
  *
3788
3788
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileReader/readAsDataURL)
3789
3789
  */
3790
3790
  readAsDataURL(blob: Blob): void;
3791
3791
  /**
3792
- * The **`readAsText()`** method of the FileReader interface is used to read the contents of the specified Blob or File.
3792
+ * The **`readAsText()`** method of the FileReader interface is used to read the contents of the specified Blob or File. When the read operation is complete, the readyState property is changed to DONE, the loadend event is triggered, and the result property contains the contents of the file as a text string.
3793
3793
  *
3794
3794
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileReader/readAsText)
3795
3795
  */
@@ -3851,7 +3851,7 @@ declare var FileSystemDirectoryHandle: {
3851
3851
  };
3852
3852
 
3853
3853
  /**
3854
- * The **`FileSystemFileHandle`** interface of the File System API represents a handle to a file system entry.
3854
+ * The **`FileSystemFileHandle`** interface of the File System API represents a handle to a file system entry. The interface is accessed through the window.showOpenFilePicker() method.
3855
3855
  * Available only in secure contexts.
3856
3856
  *
3857
3857
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle)
@@ -3859,7 +3859,7 @@ declare var FileSystemDirectoryHandle: {
3859
3859
  interface FileSystemFileHandle extends FileSystemHandle {
3860
3860
  readonly kind: "file";
3861
3861
  /**
3862
- * The **`createWritable()`** method of the FileSystemFileHandle interface creates a FileSystemWritableFileStream that can be used to write to a file.
3862
+ * The **`createWritable()`** method of the FileSystemFileHandle interface creates a FileSystemWritableFileStream that can be used to write to a file. The method returns a Promise which resolves to this created stream.
3863
3863
  *
3864
3864
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle/createWritable)
3865
3865
  */
@@ -3878,14 +3878,14 @@ declare var FileSystemFileHandle: {
3878
3878
  };
3879
3879
 
3880
3880
  /**
3881
- * The **`FileSystemHandle`** interface of the File System API is an object which represents a file or directory entry.
3881
+ * The **`FileSystemHandle`** interface of the File System API is an object which represents a file or directory entry. Multiple handles can represent the same entry. For the most part you do not work with FileSystemHandle directly but rather its child interfaces FileSystemFileHandle and FileSystemDirectoryHandle.
3882
3882
  * Available only in secure contexts.
3883
3883
  *
3884
3884
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle)
3885
3885
  */
3886
3886
  interface FileSystemHandle {
3887
3887
  /**
3888
- * The **`kind`** read-only property of the FileSystemHandle interface returns the type of entry.
3888
+ * The **`kind`** read-only property of the FileSystemHandle interface returns the type of entry. This is 'file' if the associated entry is a file or 'directory'. It is used to distinguish files from directories when iterating over the contents of a directory.
3889
3889
  *
3890
3890
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/kind)
3891
3891
  */
@@ -3897,7 +3897,7 @@ interface FileSystemHandle {
3897
3897
  */
3898
3898
  readonly name: string;
3899
3899
  /**
3900
- * The **`isSameEntry()`** method of the FileSystemHandle interface compares two FileSystemHandle to see if the associated entries (either a file or directory) match.
3900
+ * The **`isSameEntry()`** method of the FileSystemHandle interface compares two handles to see if the associated entries (either a file or directory) match.
3901
3901
  *
3902
3902
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/isSameEntry)
3903
3903
  */
@@ -3910,7 +3910,7 @@ declare var FileSystemHandle: {
3910
3910
  };
3911
3911
 
3912
3912
  /**
3913
- * The **`FileSystemWritableFileStream`** interface of the File System API is a WritableStream object with additional convenience methods, which operates on a single file on disk.
3913
+ * The **`FileSystemWritableFileStream`** interface of the File System API is a WritableStream object with additional convenience methods, which operates on a single file on disk. The interface is accessed through the FileSystemFileHandle.createWritable() method.
3914
3914
  * Available only in secure contexts.
3915
3915
  *
3916
3916
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream)
@@ -3954,13 +3954,13 @@ interface FontFace {
3954
3954
  */
3955
3955
  ascentOverride: string;
3956
3956
  /**
3957
- * The **`descentOverride`** property of the FontFace interface returns and sets the value of the @font-face/descent-override descriptor.
3957
+ * The **`descentOverride`** property of the FontFace interface returns and sets the value of the descent-override descriptor. The possible values are normal, indicating that the metric used should be obtained from the font file, or a percentage.
3958
3958
  *
3959
3959
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FontFace/descentOverride)
3960
3960
  */
3961
3961
  descentOverride: string;
3962
3962
  /**
3963
- * The **`display`** property of the FontFace interface determines how a font face is displayed based on whether and when it is downloaded and ready to use.
3963
+ * The **`display`** property of the FontFace interface determines how a font face is displayed based on whether and when it is downloaded and ready to use. This property is equivalent to the CSS font-display descriptor.
3964
3964
  *
3965
3965
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FontFace/display)
3966
3966
  */
@@ -3978,19 +3978,19 @@ interface FontFace {
3978
3978
  */
3979
3979
  featureSettings: string;
3980
3980
  /**
3981
- * The **`lineGapOverride`** property of the FontFace interface returns and sets the value of the @font-face/line-gap-override descriptor.
3981
+ * The **`lineGapOverride`** property of the FontFace interface returns and sets the value of the line-gap-override descriptor. The possible values are normal, indicating that the metric used should be obtained from the font file, or a percentage.
3982
3982
  *
3983
3983
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FontFace/lineGapOverride)
3984
3984
  */
3985
3985
  lineGapOverride: string;
3986
3986
  /**
3987
- * The **`loaded`** read-only property of the FontFace interface returns a Promise that resolves with the current `FontFace` object when the font specified in the object's constructor is done loading or rejects with a `SyntaxError`.
3987
+ * The **`loaded`** read-only property of the FontFace interface returns a Promise that resolves with the current FontFace object when the font specified in the object's constructor is done loading or rejects with a SyntaxError.
3988
3988
  *
3989
3989
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FontFace/loaded)
3990
3990
  */
3991
3991
  readonly loaded: Promise<FontFace>;
3992
3992
  /**
3993
- * The **`status`** read-only property of the FontFace interface returns an enumerated value indicating the status of the font, one of `'unloaded'`, `'loading'`, `'loaded'`, or `'error'`.
3993
+ * The **`status`** read-only property of the FontFace interface returns an enumerated value indicating the status of the font, one of "unloaded", "loading", "loaded", or "error".
3994
3994
  *
3995
3995
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FontFace/status)
3996
3996
  */
@@ -4026,7 +4026,7 @@ interface FontFace {
4026
4026
  */
4027
4027
  weight: string;
4028
4028
  /**
4029
- * The **`load()`** method of the FontFace interface requests and loads a font whose `source` was specified as a URL.
4029
+ * The **`load()`** method of the FontFace interface requests and loads a font whose source was specified as a URL. It returns a Promise that resolves with the current FontFace object.
4030
4030
  *
4031
4031
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FontFace/load)
4032
4032
  */
@@ -4057,7 +4057,7 @@ interface FontFaceSet extends EventTarget {
4057
4057
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/FontFaceSet/loadingerror_event) */
4058
4058
  onloadingerror: ((this: FontFaceSet, ev: FontFaceSetLoadEvent) => any) | null;
4059
4059
  /**
4060
- * The `ready` read-only property of the FontFaceSet interface returns a Promise that resolves to the given FontFaceSet.
4060
+ * The **`ready`** read-only property of the FontFaceSet interface returns a Promise that resolves to the given FontFaceSet.
4061
4061
  *
4062
4062
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FontFaceSet/ready)
4063
4063
  */
@@ -4069,13 +4069,13 @@ interface FontFaceSet extends EventTarget {
4069
4069
  */
4070
4070
  readonly status: FontFaceSetLoadStatus;
4071
4071
  /**
4072
- * The `check()` method of the FontFaceSet returns `true` if you can render some text using the given font specification without attempting to use any fonts in this `FontFaceSet` that are not yet fully loaded.
4072
+ * The **`check()`** method of the FontFaceSet returns true if you can render some text using the given font specification without attempting to use any fonts in this FontFaceSet that are not yet fully loaded. This means you can use the font specification without causing a font swap.
4073
4073
  *
4074
4074
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FontFaceSet/check)
4075
4075
  */
4076
4076
  check(font: string, text?: string): boolean;
4077
4077
  /**
4078
- * The `load()` method of the FontFaceSet forces all the fonts given in parameters to be loaded.
4078
+ * The **`load()`** method of the FontFaceSet forces all the fonts given in parameters to be loaded.
4079
4079
  *
4080
4080
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FontFaceSet/load)
4081
4081
  */
@@ -4117,13 +4117,13 @@ interface FontFaceSource {
4117
4117
  }
4118
4118
 
4119
4119
  /**
4120
- * The **`FormData`** interface provides a way to construct a set of key/value pairs representing form fields and their values, which can be sent using the Window/fetch, XMLHttpRequest.send() or navigator.sendBeacon() methods.
4120
+ * The **`FormData`** interface provides a way to construct a set of key/value pairs representing form fields and their values, which can be sent using the fetch(), XMLHttpRequest.send() or navigator.sendBeacon() methods. It uses the same format a form would use if the encoding type were set to "multipart/form-data".
4121
4121
  *
4122
4122
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData)
4123
4123
  */
4124
4124
  interface FormData {
4125
4125
  /**
4126
- * The **`append()`** method of the FormData interface appends a new value onto an existing key inside a `FormData` object, or adds the key if it does not already exist.
4126
+ * The **`append()`** method of the FormData interface appends a new value onto an existing key inside a FormData object, or adds the key if it does not already exist.
4127
4127
  *
4128
4128
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append)
4129
4129
  */
@@ -4131,31 +4131,31 @@ interface FormData {
4131
4131
  append(name: string, value: string): void;
4132
4132
  append(name: string, blobValue: Blob, filename?: string): void;
4133
4133
  /**
4134
- * The **`delete()`** method of the FormData interface deletes a key and its value(s) from a `FormData` object.
4134
+ * The **`delete()`** method of the FormData interface deletes a key and its value(s) from a FormData object.
4135
4135
  *
4136
4136
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/delete)
4137
4137
  */
4138
4138
  delete(name: string): void;
4139
4139
  /**
4140
- * The **`get()`** method of the FormData interface returns the first value associated with a given key from within a `FormData` object.
4140
+ * The **`get()`** method of the FormData interface returns the first value associated with a given key from within a FormData object. If you expect multiple values and want all of them, use the getAll() method instead.
4141
4141
  *
4142
4142
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/get)
4143
4143
  */
4144
4144
  get(name: string): FormDataEntryValue | null;
4145
4145
  /**
4146
- * The **`getAll()`** method of the FormData interface returns all the values associated with a given key from within a `FormData` object.
4146
+ * The **`getAll()`** method of the FormData interface returns all the values associated with a given key from within a FormData object.
4147
4147
  *
4148
4148
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/getAll)
4149
4149
  */
4150
4150
  getAll(name: string): FormDataEntryValue[];
4151
4151
  /**
4152
- * The **`has()`** method of the FormData interface returns whether a `FormData` object contains a certain key.
4152
+ * The **`has()`** method of the FormData interface returns whether a FormData object contains a certain key.
4153
4153
  *
4154
4154
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/has)
4155
4155
  */
4156
4156
  has(name: string): boolean;
4157
4157
  /**
4158
- * The **`set()`** method of the FormData interface sets a new value for an existing key inside a `FormData` object, or adds the key/value if it does not already exist.
4158
+ * The **`set()`** method of the FormData interface sets a new value for an existing key inside a FormData object, or adds the key/value if it does not already exist.
4159
4159
  *
4160
4160
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set)
4161
4161
  */
@@ -4171,7 +4171,7 @@ declare var FormData: {
4171
4171
  };
4172
4172
 
4173
4173
  /**
4174
- * The **`GPUError`** interface of the WebGPU API is the base interface for errors surfaced by GPUDevice.popErrorScope and the GPUDevice.uncapturederror_event event.
4174
+ * The **`GPUError`** interface of the WebGPU API is the base interface for errors surfaced by GPUDevice.popErrorScope and the uncapturederror event.
4175
4175
  * Available only in secure contexts.
4176
4176
  *
4177
4177
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUError)
@@ -4191,7 +4191,7 @@ declare var GPUError: {
4191
4191
  };
4192
4192
 
4193
4193
  /**
4194
- * The **`GPUPipelineError`** interface of the WebGPU API describes a pipeline failure.
4194
+ * The **`GPUPipelineError`** interface of the WebGPU API describes a pipeline failure. This is the value received when a Promise returned by a GPUDevice.createComputePipelineAsync() or GPUDevice.createRenderPipelineAsync() call rejects.
4195
4195
  * Available only in secure contexts.
4196
4196
  *
4197
4197
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUPipelineError)
@@ -4218,43 +4218,43 @@ interface GenericTransformStream {
4218
4218
  }
4219
4219
 
4220
4220
  /**
4221
- * The **`Headers`** interface of the Fetch API allows you to perform various actions on HTTP request and response headers.
4221
+ * The **`Headers`** interface of the Fetch API allows you to perform various actions on HTTP request and response headers. These actions include retrieving, setting, adding to, and removing headers from the list of the request's headers.
4222
4222
  *
4223
4223
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers)
4224
4224
  */
4225
4225
  interface Headers {
4226
4226
  /**
4227
- * The **`append()`** method of the Headers interface appends a new value onto an existing header inside a `Headers` object, or adds the header if it does not already exist.
4227
+ * The **`append()`** method of the Headers interface appends a new value onto an existing header inside a Headers object, or adds the header if it does not already exist.
4228
4228
  *
4229
4229
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/append)
4230
4230
  */
4231
4231
  append(name: string, value: string): void;
4232
4232
  /**
4233
- * The **`delete()`** method of the Headers interface deletes a header from the current `Headers` object.
4233
+ * The **`delete()`** method of the Headers interface deletes a header from the current Headers object.
4234
4234
  *
4235
4235
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/delete)
4236
4236
  */
4237
4237
  delete(name: string): void;
4238
4238
  /**
4239
- * The **`get()`** method of the Headers interface returns a byte string of all the values of a header within a `Headers` object with a given name.
4239
+ * The **`get()`** method of the Headers interface returns a byte string of all the values of a header within a Headers object with a given name. If the requested header doesn't exist in the Headers object, it returns null.
4240
4240
  *
4241
4241
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/get)
4242
4242
  */
4243
4243
  get(name: string): string | null;
4244
4244
  /**
4245
- * The **`getSetCookie()`** method of the Headers interface returns an array containing the values of all Set-Cookie headers associated with a response.
4245
+ * The **`getSetCookie()`** method of the Headers interface returns an array containing the values of all Set-Cookie headers associated with a response. This allows Headers objects to handle having multiple Set-Cookie headers, which wasn't possible prior to its implementation.
4246
4246
  *
4247
4247
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/getSetCookie)
4248
4248
  */
4249
4249
  getSetCookie(): string[];
4250
4250
  /**
4251
- * The **`has()`** method of the Headers interface returns a boolean stating whether a `Headers` object contains a certain header.
4251
+ * The **`has()`** method of the Headers interface returns a boolean stating whether a Headers object contains a certain header.
4252
4252
  *
4253
4253
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/has)
4254
4254
  */
4255
4255
  has(name: string): boolean;
4256
4256
  /**
4257
- * The **`set()`** method of the Headers interface sets a new value for an existing header inside a `Headers` object, or adds the header if it does not already exist.
4257
+ * The **`set()`** method of the Headers interface sets a new value for an existing header inside a Headers object, or adds the header if it does not already exist.
4258
4258
  *
4259
4259
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/set)
4260
4260
  */
@@ -4274,19 +4274,19 @@ declare var Headers: {
4274
4274
  */
4275
4275
  interface IDBCursor {
4276
4276
  /**
4277
- * The **`direction`** read-only property of the IDBCursor interface is a string that returns the direction of traversal of the cursor (set using IDBObjectStore.openCursor for example).
4277
+ * The **`direction`** read-only property of the IDBCursor interface is a string that returns the direction of traversal of the cursor (set using IDBObjectStore.openCursor for example). See the Value section below for possible values.
4278
4278
  *
4279
4279
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBCursor/direction)
4280
4280
  */
4281
4281
  readonly direction: IDBCursorDirection;
4282
4282
  /**
4283
- * The **`key`** read-only property of the IDBCursor interface returns the key for the record at the cursor's position.
4283
+ * The **`key`** read-only property of the IDBCursor interface returns the key for the record at the cursor's position. If the cursor is outside its range, this is set to undefined. The cursor's key can be any data type.
4284
4284
  *
4285
4285
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBCursor/key)
4286
4286
  */
4287
4287
  readonly key: IDBValidKey;
4288
4288
  /**
4289
- * The **`primaryKey`** read-only property of the IDBCursor interface returns the cursor's current effective key.
4289
+ * The **`primaryKey`** read-only property of the IDBCursor interface returns the cursor's current effective key. If the cursor is currently being iterated or has iterated outside its range, this is set to undefined. The cursor's primary key can be any data type.
4290
4290
  *
4291
4291
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBCursor/primaryKey)
4292
4292
  */
@@ -4298,7 +4298,7 @@ interface IDBCursor {
4298
4298
  */
4299
4299
  readonly request: IDBRequest;
4300
4300
  /**
4301
- * The **`source`** read-only property of the IDBCursor interface returns the IDBObjectStore or IDBIndex that the cursor is iterating over.
4301
+ * The **`source`** read-only property of the IDBCursor interface returns the IDBObjectStore or IDBIndex that the cursor is iterating over. This function never returns null or throws an exception, even if the cursor is currently being iterated, has iterated past its end, or its transaction is not active.
4302
4302
  *
4303
4303
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBCursor/source)
4304
4304
  */
@@ -4310,7 +4310,7 @@ interface IDBCursor {
4310
4310
  */
4311
4311
  advance(count: number): void;
4312
4312
  /**
4313
- * The **`continue()`** method of the IDBCursor interface advances the cursor to the next position along its direction, to the item whose key matches the optional key parameter.
4313
+ * The **`continue()`** method of the IDBCursor interface advances the cursor to the next position along its direction, to the item whose key matches the optional key parameter. If no key is specified, the cursor advances to the immediate next position, based on its direction.
4314
4314
  *
4315
4315
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBCursor/continue)
4316
4316
  */
@@ -4322,13 +4322,13 @@ interface IDBCursor {
4322
4322
  */
4323
4323
  continuePrimaryKey(key: IDBValidKey, primaryKey: IDBValidKey): void;
4324
4324
  /**
4325
- * The **`delete()`** method of the IDBCursor interface returns an IDBRequest object, and, in a separate thread, deletes the record at the cursor's position, without changing the cursor's position.
4325
+ * The **`delete()`** method of the IDBCursor interface returns an IDBRequest object, and, in a separate thread, deletes the record at the cursor's position, without changing the cursor's position. Once the record is deleted, the cursor's value is set to null.
4326
4326
  *
4327
4327
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBCursor/delete)
4328
4328
  */
4329
4329
  delete(): IDBRequest<undefined>;
4330
4330
  /**
4331
- * The **`update()`** method of the IDBCursor interface returns an IDBRequest object, and, in a separate thread, updates the value at the current position of the cursor in the object store.
4331
+ * The **`update()`** method of the IDBCursor interface returns an IDBRequest object, and, in a separate thread, updates the value at the current position of the cursor in the object store. If the cursor points to a record that has just been deleted, a new record is created.
4332
4332
  *
4333
4333
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBCursor/update)
4334
4334
  */
@@ -4341,7 +4341,7 @@ declare var IDBCursor: {
4341
4341
  };
4342
4342
 
4343
4343
  /**
4344
- * The **`IDBCursorWithValue`** interface of the IndexedDB API represents a cursor for traversing or iterating over multiple records in a database.
4344
+ * The **`IDBCursorWithValue`** interface of the IndexedDB API represents a cursor for traversing or iterating over multiple records in a database. It is the same as the IDBCursor, except that it includes the value property.
4345
4345
  *
4346
4346
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBCursorWithValue)
4347
4347
  */
@@ -4367,13 +4367,13 @@ interface IDBDatabaseEventMap {
4367
4367
  }
4368
4368
 
4369
4369
  /**
4370
- * The **`IDBDatabase`** interface of the IndexedDB API provides a connection to a database; you can use an `IDBDatabase` object to open a transaction on your database then create, manipulate, and delete objects (data) in that database.
4370
+ * The **`IDBDatabase`** interface of the IndexedDB API provides a connection to a database; you can use an IDBDatabase object to open a transaction on your database then create, manipulate, and delete objects (data) in that database. The interface provides the only way to get and manage versions of the database.
4371
4371
  *
4372
4372
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBDatabase)
4373
4373
  */
4374
4374
  interface IDBDatabase extends EventTarget {
4375
4375
  /**
4376
- * The **`name`** read-only property of the `IDBDatabase` interface is a string that contains the name of the connected database.
4376
+ * The **`name`** read-only property of the IDBDatabase interface is a string that contains the name of the connected database.
4377
4377
  *
4378
4378
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBDatabase/name)
4379
4379
  */
@@ -4392,7 +4392,7 @@ interface IDBDatabase extends EventTarget {
4392
4392
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBDatabase/versionchange_event) */
4393
4393
  onversionchange: ((this: IDBDatabase, ev: IDBVersionChangeEvent) => any) | null;
4394
4394
  /**
4395
- * The **`version`** property of the IDBDatabase interface is a 64-bit integer that contains the version of the connected database.
4395
+ * The **`version`** property of the IDBDatabase interface is a 64-bit integer that contains the version of the connected database. When a database is first created, this attribute is an empty string.
4396
4396
  *
4397
4397
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBDatabase/version)
4398
4398
  */
@@ -4433,7 +4433,7 @@ declare var IDBDatabase: {
4433
4433
  };
4434
4434
 
4435
4435
  /**
4436
- * The **`IDBFactory`** interface of the IndexedDB API lets applications asynchronously access the indexed databases.
4436
+ * The **`IDBFactory`** interface of the IndexedDB API lets applications asynchronously access the indexed databases. The object that implements the interface is window.indexedDB. You open — that is, create and access — and delete a database with this object, and not directly with IDBFactory.
4437
4437
  *
4438
4438
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBFactory)
4439
4439
  */
@@ -4451,7 +4451,7 @@ interface IDBFactory {
4451
4451
  */
4452
4452
  databases(): Promise<IDBDatabaseInfo[]>;
4453
4453
  /**
4454
- * The **`deleteDatabase()`** method of the IDBFactory interface requests the deletion of a database.
4454
+ * The **`deleteDatabase()`** method of the IDBFactory interface requests the deletion of a database. The method returns an IDBOpenDBRequest object immediately, and performs the deletion operation asynchronously.
4455
4455
  *
4456
4456
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBFactory/deleteDatabase)
4457
4457
  */
@@ -4470,13 +4470,13 @@ declare var IDBFactory: {
4470
4470
  };
4471
4471
 
4472
4472
  /**
4473
- * `IDBIndex` interface of the IndexedDB API provides asynchronous access to an index in a database.
4473
+ * **`IDBIndex`** interface of the IndexedDB API provides asynchronous access to an index in a database. An index is a kind of object store for looking up records in another object store, called the referenced object store. You use this interface to retrieve data.
4474
4474
  *
4475
4475
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBIndex)
4476
4476
  */
4477
4477
  interface IDBIndex {
4478
4478
  /**
4479
- * The **`keyPath`** property of the IDBIndex interface returns the key path of the current index.
4479
+ * The **`keyPath`** property of the IDBIndex interface returns the key path of the current index. If null, this index is not auto-populated.
4480
4480
  *
4481
4481
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBIndex/keyPath)
4482
4482
  */
@@ -4512,7 +4512,7 @@ interface IDBIndex {
4512
4512
  */
4513
4513
  count(query?: IDBValidKey | IDBKeyRange): IDBRequest<number>;
4514
4514
  /**
4515
- * The **`get()`** method of the IDBIndex interface returns an IDBRequest object, and, in a separate thread, finds either the value in the referenced object store that corresponds to the given key or the first corresponding value, if `key` is set to an IDBKeyRange.
4515
+ * The **`get()`** method of the IDBIndex interface returns an IDBRequest object, and, in a separate thread, finds either the value in the referenced object store that corresponds to the given key or the first corresponding value, if key is set to an IDBKeyRange.
4516
4516
  *
4517
4517
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBIndex/get)
4518
4518
  */
@@ -4524,13 +4524,13 @@ interface IDBIndex {
4524
4524
  */
4525
4525
  getAll(queryOrOptions?: IDBValidKey | IDBKeyRange | null, count?: number): IDBRequest<any[]>;
4526
4526
  /**
4527
- * The **`getAllKeys()`** method of the IDBIndex interface asynchronously retrieves the primary keys of all objects inside the index, setting them as the `result` of the request object.
4527
+ * The **`getAllKeys()`** method of the IDBIndex interface asynchronously retrieves the primary keys of all objects inside the index, setting them as the result of the request object.
4528
4528
  *
4529
4529
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBIndex/getAllKeys)
4530
4530
  */
4531
4531
  getAllKeys(queryOrOptions?: IDBValidKey | IDBKeyRange | null, count?: number): IDBRequest<IDBValidKey[]>;
4532
4532
  /**
4533
- * The **`getKey()`** method of the IDBIndex interface returns an IDBRequest object, and, in a separate thread, finds either the primary key that corresponds to the given key in this index or the first corresponding primary key, if `key` is set to an IDBKeyRange.
4533
+ * The **`getKey()`** method of the IDBIndex interface returns an IDBRequest object, and, in a separate thread, finds either the primary key that corresponds to the given key in this index or the first corresponding primary key, if key is set to an IDBKeyRange.
4534
4534
  *
4535
4535
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBIndex/getKey)
4536
4536
  */
@@ -4555,7 +4555,7 @@ declare var IDBIndex: {
4555
4555
  };
4556
4556
 
4557
4557
  /**
4558
- * The **`IDBKeyRange`** interface of the IndexedDB API represents a continuous interval over some data type that is used for keys.
4558
+ * The **`IDBKeyRange`** interface of the IndexedDB API represents a continuous interval over some data type that is used for keys. Records can be retrieved from IDBObjectStore and IDBIndex objects using keys or a range of keys. You can limit the range using lower and upper bounds. For example, you can iterate over all values of a key in the value range A–Z.
4559
4559
  *
4560
4560
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBKeyRange)
4561
4561
  */
@@ -4585,7 +4585,7 @@ interface IDBKeyRange {
4585
4585
  */
4586
4586
  readonly upperOpen: boolean;
4587
4587
  /**
4588
- * The `includes()` method of the IDBKeyRange interface returns a boolean indicating whether a specified key is inside the key range.
4588
+ * The **`includes()`** method of the IDBKeyRange interface returns a boolean indicating whether a specified key is inside the key range.
4589
4589
  *
4590
4590
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBKeyRange/includes)
4591
4591
  */
@@ -4596,13 +4596,13 @@ declare var IDBKeyRange: {
4596
4596
  prototype: IDBKeyRange;
4597
4597
  new(): IDBKeyRange;
4598
4598
  /**
4599
- * The **`bound()`** static method of the IDBKeyRange interface creates a new key range with the specified upper and lower bounds.
4599
+ * The **`bound()`** static method of the IDBKeyRange interface creates a new key range with the specified upper and lower bounds. The bounds can be open (that is, the bounds exclude the endpoint values) or closed (that is, the bounds include the endpoint values). By default, the bounds are closed.
4600
4600
  *
4601
4601
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBKeyRange/bound_static)
4602
4602
  */
4603
4603
  bound(lower: any, upper: any, lowerOpen?: boolean, upperOpen?: boolean): IDBKeyRange;
4604
4604
  /**
4605
- * The **`lowerBound()`** static method of the IDBKeyRange interface creates a new key range with only a lower bound.
4605
+ * The **`lowerBound()`** static method of the IDBKeyRange interface creates a new key range with only a lower bound. By default, it includes the lower endpoint value and is closed.
4606
4606
  *
4607
4607
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBKeyRange/lowerBound_static)
4608
4608
  */
@@ -4614,7 +4614,7 @@ declare var IDBKeyRange: {
4614
4614
  */
4615
4615
  only(value: any): IDBKeyRange;
4616
4616
  /**
4617
- * The **`upperBound()`** static method of the IDBKeyRange interface creates a new upper-bound key range.
4617
+ * The **`upperBound()`** static method of the IDBKeyRange interface creates a new upper-bound key range. By default, it includes the upper endpoint value and is closed.
4618
4618
  *
4619
4619
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBKeyRange/upperBound_static)
4620
4620
  */
@@ -4622,7 +4622,7 @@ declare var IDBKeyRange: {
4622
4622
  };
4623
4623
 
4624
4624
  /**
4625
- * The **`IDBObjectStore`** interface of the IndexedDB API represents an object store in a database.
4625
+ * The **`IDBObjectStore`** interface of the IndexedDB API represents an object store in a database. Records within an object store are sorted according to their keys. This sorting enables fast insertion, look-up, and ordered retrieval.
4626
4626
  *
4627
4627
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBObjectStore)
4628
4628
  */
@@ -4658,25 +4658,25 @@ interface IDBObjectStore {
4658
4658
  */
4659
4659
  readonly transaction: IDBTransaction;
4660
4660
  /**
4661
- * The **`add()`** method of the IDBObjectStore interface returns an IDBRequest object, and, in a separate thread, creates a structured clone of the value, and stores the cloned value in the object store.
4661
+ * The **`add()`** method of the IDBObjectStore interface returns an IDBRequest object, and, in a separate thread, creates a structured clone of the value, and stores the cloned value in the object store. This is for adding new records to an object store.
4662
4662
  *
4663
4663
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBObjectStore/add)
4664
4664
  */
4665
4665
  add(value: any, key?: IDBValidKey): IDBRequest<IDBValidKey>;
4666
4666
  /**
4667
- * The **`clear()`** method of the IDBObjectStore interface creates and immediately returns an IDBRequest object, and clears this object store in a separate thread.
4667
+ * The **`clear()`** method of the IDBObjectStore interface creates and immediately returns an IDBRequest object, and clears this object store in a separate thread. This is for deleting all the current data out of an object store.
4668
4668
  *
4669
4669
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBObjectStore/clear)
4670
4670
  */
4671
4671
  clear(): IDBRequest<undefined>;
4672
4672
  /**
4673
- * The **`count()`** method of the IDBObjectStore interface returns an IDBRequest object, and, in a separate thread, returns the total number of records that match the provided key or IDBKeyRange.
4673
+ * The **`count()`** method of the IDBObjectStore interface returns an IDBRequest object, and, in a separate thread, returns the total number of records that match the provided key or IDBKeyRange. If no arguments are provided, it returns the total number of records in the store.
4674
4674
  *
4675
4675
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBObjectStore/count)
4676
4676
  */
4677
4677
  count(query?: IDBValidKey | IDBKeyRange): IDBRequest<number>;
4678
4678
  /**
4679
- * The **`createIndex()`** method of the IDBObjectStore interface creates and returns a new IDBIndex object in the connected database.
4679
+ * The **`createIndex()`** method of the IDBObjectStore interface creates and returns a new IDBIndex object in the connected database. It creates a new field/column defining a new data point for each database record to contain.
4680
4680
  *
4681
4681
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBObjectStore/createIndex)
4682
4682
  */
@@ -4694,7 +4694,7 @@ interface IDBObjectStore {
4694
4694
  */
4695
4695
  deleteIndex(name: string): void;
4696
4696
  /**
4697
- * The **`get()`** method of the IDBObjectStore interface returns an IDBRequest object, and, in a separate thread, returns the object selected by the specified key.
4697
+ * The **`get()`** method of the IDBObjectStore interface returns an IDBRequest object, and, in a separate thread, returns the object selected by the specified key. This is for retrieving specific records from an object store.
4698
4698
  *
4699
4699
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBObjectStore/get)
4700
4700
  */
@@ -4706,13 +4706,13 @@ interface IDBObjectStore {
4706
4706
  */
4707
4707
  getAll(queryOrOptions?: IDBValidKey | IDBKeyRange | null, count?: number): IDBRequest<any[]>;
4708
4708
  /**
4709
- * The `getAllKeys()` method of the IDBObjectStore interface returns an IDBRequest object retrieves record keys for all objects in the object store matching the specified parameter or all objects in the store if no parameters are given.
4709
+ * The **`getAllKeys()`** method of the IDBObjectStore interface returns an IDBRequest object retrieves record keys for all objects in the object store matching the specified parameter or all objects in the store if no parameters are given.
4710
4710
  *
4711
4711
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBObjectStore/getAllKeys)
4712
4712
  */
4713
4713
  getAllKeys(queryOrOptions?: IDBValidKey | IDBKeyRange | null, count?: number): IDBRequest<IDBValidKey[]>;
4714
4714
  /**
4715
- * The **`getKey()`** method of the IDBObjectStore interface returns an IDBRequest object, and, in a separate thread, returns the key selected by the specified query.
4715
+ * The **`getKey()`** method of the IDBObjectStore interface returns an IDBRequest object, and, in a separate thread, returns the key selected by the specified query. This is for retrieving specific records from an object store.
4716
4716
  *
4717
4717
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBObjectStore/getKey)
4718
4718
  */
@@ -4724,13 +4724,13 @@ interface IDBObjectStore {
4724
4724
  */
4725
4725
  index(name: string): IDBIndex;
4726
4726
  /**
4727
- * The **`openCursor()`** method of the IDBObjectStore interface returns an IDBRequest object, and, in a separate thread, returns a new IDBCursorWithValue object.
4727
+ * The **`openCursor()`** method of the IDBObjectStore interface returns an IDBRequest object, and, in a separate thread, returns a new IDBCursorWithValue object. Used for iterating through an object store with a cursor.
4728
4728
  *
4729
4729
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBObjectStore/openCursor)
4730
4730
  */
4731
4731
  openCursor(query?: IDBValidKey | IDBKeyRange | null, direction?: IDBCursorDirection): IDBRequest<IDBCursorWithValue | null>;
4732
4732
  /**
4733
- * The **`openKeyCursor()`** method of the IDBObjectStore interface returns an IDBRequest object whose result will be set to an IDBCursor that can be used to iterate through matching results.
4733
+ * The **`openKeyCursor()`** method of the IDBObjectStore interface returns an IDBRequest object whose result will be set to an IDBCursor that can be used to iterate through matching results. Used for iterating through the keys of an object store with a cursor.
4734
4734
  *
4735
4735
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBObjectStore/openKeyCursor)
4736
4736
  */
@@ -4780,7 +4780,7 @@ interface IDBRequestEventMap {
4780
4780
  }
4781
4781
 
4782
4782
  /**
4783
- * The **`IDBRequest`** interface of the IndexedDB API provides access to results of asynchronous requests to databases and database objects using event handler attributes.
4783
+ * The **`IDBRequest`** interface of the IndexedDB API provides access to results of asynchronous requests to databases and database objects using event handler attributes. Each reading and writing operation on a database is done using a request.
4784
4784
  *
4785
4785
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBRequest)
4786
4786
  */
@@ -4808,7 +4808,7 @@ interface IDBRequest<T = any> extends EventTarget {
4808
4808
  */
4809
4809
  readonly result: T;
4810
4810
  /**
4811
- * The **`source`** read-only property of the IDBRequest interface returns the source of the request, such as an Index or an object store.
4811
+ * The **`source`** read-only property of the IDBRequest interface returns the source of the request, such as an Index or an object store. If no source exists (such as when calling IDBFactory.open), it returns null.
4812
4812
  *
4813
4813
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBRequest/source)
4814
4814
  */
@@ -4837,7 +4837,7 @@ interface IDBTransactionEventMap {
4837
4837
  }
4838
4838
 
4839
4839
  /**
4840
- * The **`IDBTransaction`** interface of the IndexedDB API provides a static, asynchronous transaction on a database using event handler attributes.
4840
+ * The **`IDBTransaction`** interface of the IndexedDB API provides a static, asynchronous transaction on a database using event handler attributes. All reading and writing of data is done within transactions. You use IDBDatabase to start transactions, IDBTransaction to set the mode of the transaction (e.g., is it readonly or readwrite), and you access an IDBObjectStore to make a request. You can also use an IDBTransaction object to abort transactions.
4841
4841
  *
4842
4842
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBTransaction)
4843
4843
  */
@@ -4849,7 +4849,7 @@ interface IDBTransaction extends EventTarget {
4849
4849
  */
4850
4850
  readonly db: IDBDatabase;
4851
4851
  /**
4852
- * The **`durability`** read-only property of the IDBTransaction interface returns the durability hint the transaction was created with.
4852
+ * The **`durability`** read-only property of the IDBTransaction interface returns the durability hint the transaction was created with. This is a hint to the user agent of whether to prioritize performance or durability when committing the transaction.
4853
4853
  *
4854
4854
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBTransaction/durability)
4855
4855
  */
@@ -4861,7 +4861,7 @@ interface IDBTransaction extends EventTarget {
4861
4861
  */
4862
4862
  readonly error: DOMException | null;
4863
4863
  /**
4864
- * The **`mode`** read-only property of the IDBTransaction interface returns the current mode for accessing the data in the object stores in the scope of the transaction (i.e., is the mode to be read-only, or do you want to write to the object stores?) The default value is `readonly`.
4864
+ * The **`mode`** read-only property of the IDBTransaction interface returns the current mode for accessing the data in the object stores in the scope of the transaction (i.e., is the mode to be read-only, or do you want to write to the object stores?) The default value is readonly.
4865
4865
  *
4866
4866
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBTransaction/mode)
4867
4867
  */
@@ -4908,7 +4908,7 @@ declare var IDBTransaction: {
4908
4908
  };
4909
4909
 
4910
4910
  /**
4911
- * The **`IDBVersionChangeEvent`** interface of the IndexedDB API indicates that the version of the database has changed, as the result of an IDBOpenDBRequest.upgradeneeded_event event handler function.
4911
+ * The **`IDBVersionChangeEvent`** interface of the IndexedDB API indicates that the version of the database has changed, as the result of an onupgradeneeded event handler function.
4912
4912
  *
4913
4913
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/IDBVersionChangeEvent)
4914
4914
  */
@@ -4933,7 +4933,7 @@ declare var IDBVersionChangeEvent: {
4933
4933
  };
4934
4934
 
4935
4935
  /**
4936
- * The **`ImageBitmap`** interface represents a bitmap image which can be drawn to a canvas without undue latency.
4936
+ * The **`ImageBitmap`** interface represents a bitmap image which can be drawn to a <canvas> without undue latency. It can be created from a variety of source objects using the Window.createImageBitmap() or WorkerGlobalScope.createImageBitmap() factory method. ImageBitmap provides an asynchronous and resource efficient pathway to prepare textures for rendering in WebGL.
4937
4937
  *
4938
4938
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ImageBitmap)
4939
4939
  */
@@ -4951,7 +4951,7 @@ interface ImageBitmap {
4951
4951
  */
4952
4952
  readonly width: number;
4953
4953
  /**
4954
- * The **`ImageBitmap.close()`** method disposes of all graphical resources associated with an `ImageBitmap`.
4954
+ * The **`ImageBitmap.close()`** method disposes of all graphical resources associated with an ImageBitmap.
4955
4955
  *
4956
4956
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ImageBitmap/close)
4957
4957
  */
@@ -4964,13 +4964,13 @@ declare var ImageBitmap: {
4964
4964
  };
4965
4965
 
4966
4966
  /**
4967
- * The **`ImageBitmapRenderingContext`** interface is a canvas rendering context that provides the functionality to replace the canvas's contents with the given ImageBitmap.
4967
+ * The **`ImageBitmapRenderingContext`** interface is a canvas rendering context that provides the functionality to replace the canvas's contents with the given ImageBitmap. Its context id (the first argument to HTMLCanvasElement.getContext() or OffscreenCanvas.getContext()) is "bitmaprenderer".
4968
4968
  *
4969
4969
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ImageBitmapRenderingContext)
4970
4970
  */
4971
4971
  interface ImageBitmapRenderingContext {
4972
4972
  /**
4973
- * The **`ImageBitmapRenderingContext.transferFromImageBitmap()`** method displays the given ImageBitmap in the canvas associated with this rendering context.
4973
+ * The **`ImageBitmapRenderingContext.transferFromImageBitmap()`** method displays the given ImageBitmap in the canvas associated with this rendering context. The ownership of the ImageBitmap is transferred to the canvas as well.
4974
4974
  *
4975
4975
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ImageBitmapRenderingContext/transferFromImageBitmap)
4976
4976
  */
@@ -4983,7 +4983,7 @@ declare var ImageBitmapRenderingContext: {
4983
4983
  };
4984
4984
 
4985
4985
  /**
4986
- * The **`ImageData`** interface represents the underlying pixel data of an area of a canvas element.
4986
+ * The **`ImageData`** interface represents the underlying pixel data of an area of a <canvas> element.
4987
4987
  *
4988
4988
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ImageData)
4989
4989
  */
@@ -4995,7 +4995,7 @@ interface ImageData {
4995
4995
  */
4996
4996
  readonly colorSpace: PredefinedColorSpace;
4997
4997
  /**
4998
- * The readonly **`ImageData.data`** property returns a Uint8ClampedArray or Float16Array that contains the ImageData object's pixel data.
4998
+ * The readonly **`ImageData.data`** property returns a Uint8ClampedArray or Float16Array that contains the ImageData object's pixel data. Data is stored as a one-dimensional array in the RGBA order.
4999
4999
  *
5000
5000
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ImageData/data)
5001
5001
  */
@@ -5026,7 +5026,7 @@ interface ImportMeta {
5026
5026
  }
5027
5027
 
5028
5028
  /**
5029
- * The **`KHR_parallel_shader_compile`** extension is part of the WebGL API and enables a non-blocking poll operation, so that compile/link status availability (`COMPLETION_STATUS_KHR`) can be queried without potentially incurring stalls.
5029
+ * The **`KHR_parallel_shader_compile`** extension is part of the WebGL API and enables a non-blocking poll operation, so that compile/link status availability (COMPLETION_STATUS_KHR) can be queried without potentially incurring stalls. In other words you can check the status of your shaders compiling without blocking the runtime.
5030
5030
  *
5031
5031
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/KHR_parallel_shader_compile)
5032
5032
  */
@@ -5035,20 +5035,20 @@ interface KHR_parallel_shader_compile {
5035
5035
  }
5036
5036
 
5037
5037
  /**
5038
- * The **`Lock`** interface of the Web Locks API provides the name and mode of a lock.
5038
+ * The **`Lock`** interface of the Web Locks API provides the name and mode of a lock. This may be a newly requested lock that is received in the callback to LockManager.request(), or a record of an active or queued lock returned by LockManager.query().
5039
5039
  * Available only in secure contexts.
5040
5040
  *
5041
5041
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Lock)
5042
5042
  */
5043
5043
  interface Lock {
5044
5044
  /**
5045
- * The **`mode`** read-only property of the Lock interface returns the access mode passed to LockManager.request() when the lock was requested.
5045
+ * The **`mode`** read-only property of the Lock interface returns the access mode passed to LockManager.request() when the lock was requested. The mode is either "exclusive" (the default) or "shared".
5046
5046
  *
5047
5047
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Lock/mode)
5048
5048
  */
5049
5049
  readonly mode: LockMode;
5050
5050
  /**
5051
- * The **`name`** read-only property of the Lock interface returns the _name_ passed to LockManager.request selected when the lock was requested.
5051
+ * The **`name`** read-only property of the Lock interface returns the name passed to LockManager.request selected when the lock was requested.
5052
5052
  *
5053
5053
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Lock/name)
5054
5054
  */
@@ -5061,7 +5061,7 @@ declare var Lock: {
5061
5061
  };
5062
5062
 
5063
5063
  /**
5064
- * The **`LockManager`** interface of the Web Locks API provides methods for requesting a new Lock object and querying for an existing `Lock` object.
5064
+ * The **`LockManager`** interface of the Web Locks API provides methods for requesting a new Lock object and querying for an existing Lock object. To get an instance of LockManager, call navigator.locks.
5065
5065
  * Available only in secure contexts.
5066
5066
  *
5067
5067
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/LockManager)
@@ -5074,7 +5074,7 @@ interface LockManager {
5074
5074
  */
5075
5075
  query(): Promise<LockManagerSnapshot>;
5076
5076
  /**
5077
- * The **`request()`** method of the LockManager interface requests a Lock object with parameters specifying its name and characteristics.
5077
+ * The **`request()`** method of the LockManager interface requests a Lock object with parameters specifying its name and characteristics. The requested Lock is passed to a callback, while the function itself returns a Promise that resolves (or rejects) with the result of the callback after the lock is released, or rejects if the request is aborted.
5078
5078
  *
5079
5079
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/LockManager/request)
5080
5080
  */
@@ -5088,7 +5088,7 @@ declare var LockManager: {
5088
5088
  };
5089
5089
 
5090
5090
  /**
5091
- * The **`MediaCapabilities`** interface of the Media Capabilities API provides information about the decoding abilities of the device, system and browser.
5091
+ * The **`MediaCapabilities`** interface of the Media Capabilities API provides information about the decoding abilities of the device, system and browser. The API can be used to query the browser about the decoding abilities of the device based on codecs, profile, resolution, and bitrates. The information can be used to serve optimal media streams to the user and determine if playback should be smooth and power efficient.
5092
5092
  *
5093
5093
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MediaCapabilities)
5094
5094
  */
@@ -5100,7 +5100,7 @@ interface MediaCapabilities {
5100
5100
  */
5101
5101
  decodingInfo(configuration: MediaDecodingConfiguration): Promise<MediaCapabilitiesDecodingInfo>;
5102
5102
  /**
5103
- * The **`encodingInfo()`** method of the MediaCapabilities interface returns a promise that fulfills with the tested media configuration's capabilities for encoding media.
5103
+ * The **`encodingInfo()`** method of the MediaCapabilities interface returns a promise that fulfills with the tested media configuration's capabilities for encoding media. This contains the three boolean properties supported, smooth, and powerefficient, which describe how compatible the device is with the type of media.
5104
5104
  *
5105
5105
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MediaCapabilities/encodingInfo)
5106
5106
  */
@@ -5168,7 +5168,7 @@ interface MessageEvent<T = any> extends Event {
5168
5168
  */
5169
5169
  readonly ports: ReadonlyArray<MessagePort>;
5170
5170
  /**
5171
- * The **`source`** read-only property of the MessageEvent interface is a `MessageEventSource` (which can be a WindowProxy, MessagePort, or ServiceWorker object) representing the message emitter.
5171
+ * The **`source`** read-only property of the MessageEvent interface is a MessageEventSource (which can be a WindowProxy, MessagePort, or ServiceWorker object) representing the message emitter.
5172
5172
  *
5173
5173
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/source)
5174
5174
  */
@@ -5210,7 +5210,7 @@ interface MessagePortEventMap extends MessageEventTargetEventMap {
5210
5210
  */
5211
5211
  interface MessagePort extends EventTarget, MessageEventTarget<MessagePort> {
5212
5212
  /**
5213
- * The **`close()`** method of the MessagePort interface disconnects the port, so it is no longer active.
5213
+ * The **`close()`** method of the MessagePort interface disconnects the port, so it is no longer active. This stops the flow of messages to that port.
5214
5214
  *
5215
5215
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/close)
5216
5216
  */
@@ -5223,7 +5223,7 @@ interface MessagePort extends EventTarget, MessageEventTarget<MessagePort> {
5223
5223
  postMessage(message: any, transfer: Transferable[]): void;
5224
5224
  postMessage(message: any, options?: StructuredSerializeOptions): void;
5225
5225
  /**
5226
- * The **`start()`** method of the MessagePort interface starts the sending of messages queued on the port.
5226
+ * The **`start()`** method of the MessagePort interface starts the sending of messages queued on the port. This method is only needed when using EventTarget.addEventListener; it is implied when using onmessage.
5227
5227
  *
5228
5228
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/start)
5229
5229
  */
@@ -5247,13 +5247,13 @@ declare var MessagePort: {
5247
5247
  */
5248
5248
  interface NavigationPreloadManager {
5249
5249
  /**
5250
- * The **`disable()`** method of the NavigationPreloadManager interface halts the automatic preloading of service-worker-managed resources previously started using NavigationPreloadManager.enable() It returns a promise that resolves with `undefined`.
5250
+ * The **`disable()`** method of the NavigationPreloadManager interface halts the automatic preloading of service-worker-managed resources previously started using enable() It returns a promise that resolves with undefined.
5251
5251
  *
5252
5252
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/NavigationPreloadManager/disable)
5253
5253
  */
5254
5254
  disable(): Promise<void>;
5255
5255
  /**
5256
- * The **`enable()`** method of the NavigationPreloadManager interface is used to enable preloading of resources managed by the service worker.
5256
+ * The **`enable()`** method of the NavigationPreloadManager interface is used to enable preloading of resources managed by the service worker. It returns a promise that resolves with undefined.
5257
5257
  *
5258
5258
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/NavigationPreloadManager/enable)
5259
5259
  */
@@ -5265,7 +5265,7 @@ interface NavigationPreloadManager {
5265
5265
  */
5266
5266
  getState(): Promise<NavigationPreloadState>;
5267
5267
  /**
5268
- * The **`setHeaderValue()`** method of the NavigationPreloadManager interface sets the value of the Service-Worker-Navigation-Preload header that will be sent with requests resulting from a Window/fetch operation made during service worker navigation preloading.
5268
+ * The **`setHeaderValue()`** method of the NavigationPreloadManager interface sets the value of the Service-Worker-Navigation-Preload header that will be sent with requests resulting from a fetch() operation made during service worker navigation preloading. It returns an empty Promise that resolves with undefined.
5269
5269
  *
5270
5270
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/NavigationPreloadManager/setHeaderValue)
5271
5271
  */
@@ -5343,31 +5343,31 @@ interface NotificationEventMap {
5343
5343
  */
5344
5344
  interface Notification extends EventTarget {
5345
5345
  /**
5346
- * The **`body`** read-only property of the Notification interface indicates the body string of the notification, as specified in the `body` option of the Notification.Notification constructor.
5346
+ * The **`body`** read-only property of the Notification interface indicates the body string of the notification, as specified in the body option of the Notification() constructor.
5347
5347
  *
5348
5348
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Notification/body)
5349
5349
  */
5350
5350
  readonly body: string;
5351
5351
  /**
5352
- * The **`data`** read-only property of the Notification interface returns a structured clone of the notification's data, as specified in the `data` option of the Notification.Notification constructor.
5352
+ * The **`data`** read-only property of the Notification interface returns a structured clone of the notification's data, as specified in the data option of the Notification() constructor.
5353
5353
  *
5354
5354
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Notification/data)
5355
5355
  */
5356
5356
  readonly data: any;
5357
5357
  /**
5358
- * The **`dir`** read-only property of the Notification interface indicates the text direction of the notification, as specified in the `dir` option of the Notification.Notification constructor.
5358
+ * The **`dir`** read-only property of the Notification interface indicates the text direction of the notification, as specified in the dir option of the Notification() constructor.
5359
5359
  *
5360
5360
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Notification/dir)
5361
5361
  */
5362
5362
  readonly dir: NotificationDirection;
5363
5363
  /**
5364
- * The **`icon`** read-only property of the Notification interface contains the URL of an icon to be displayed as part of the notification, as specified in the `icon` option of the Notification.Notification constructor.
5364
+ * The **`icon`** read-only property of the Notification interface contains the URL of an icon to be displayed as part of the notification, as specified in the icon option of the Notification() constructor.
5365
5365
  *
5366
5366
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Notification/icon)
5367
5367
  */
5368
5368
  readonly icon: string;
5369
5369
  /**
5370
- * The **`lang`** read-only property of the Notification interface indicates the language used in the notification, as specified in the `lang` option of the Notification.Notification constructor.
5370
+ * The **`lang`** read-only property of the Notification interface indicates the language used in the notification, as specified in the lang option of the Notification() constructor.
5371
5371
  *
5372
5372
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Notification/lang)
5373
5373
  */
@@ -5387,19 +5387,19 @@ interface Notification extends EventTarget {
5387
5387
  */
5388
5388
  readonly requireInteraction: boolean;
5389
5389
  /**
5390
- * The **`silent`** read-only property of the Notification interface specifies whether the notification should be silent, i.e., no sounds or vibrations should be issued regardless of the device settings.
5390
+ * The **`silent`** read-only property of the Notification interface specifies whether the notification should be silent, i.e., no sounds or vibrations should be issued regardless of the device settings. This is controlled via the silent option of the Notification() constructor.
5391
5391
  *
5392
5392
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Notification/silent)
5393
5393
  */
5394
5394
  readonly silent: boolean | null;
5395
5395
  /**
5396
- * The **`tag`** read-only property of the Notification interface signifies an identifying tag for the notification, as specified in the `tag` option of the Notification.Notification constructor.
5396
+ * The **`tag`** read-only property of the Notification interface signifies an identifying tag for the notification, as specified in the tag option of the Notification() constructor.
5397
5397
  *
5398
5398
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Notification/tag)
5399
5399
  */
5400
5400
  readonly tag: string;
5401
5401
  /**
5402
- * The **`title`** read-only property of the Notification interface indicates the title of the notification, as specified in the `title` parameter of the Notification.Notification constructor.
5402
+ * The **`title`** read-only property of the Notification interface indicates the title of the notification, as specified in the title parameter of the Notification() constructor.
5403
5403
  *
5404
5404
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Notification/title)
5405
5405
  */
@@ -5434,13 +5434,13 @@ declare var Notification: {
5434
5434
  */
5435
5435
  interface NotificationEvent extends ExtendableEvent {
5436
5436
  /**
5437
- * The **`action`** read-only property of the NotificationEvent interface returns the string ID of the notification button the user clicked.
5437
+ * The **`action`** read-only property of the NotificationEvent interface returns the string ID of the notification button the user clicked. This value returns an empty string if the user clicked the notification somewhere other than an action button, or the notification does not have a button. The notification id is set during the creation of the Notification via the actions array attribute and can't be modified unless the notification is replaced.
5438
5438
  *
5439
5439
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/NotificationEvent/action)
5440
5440
  */
5441
5441
  readonly action: string;
5442
5442
  /**
5443
- * The **`notification`** read-only property of the NotificationEvent interface returns the instance of the Notification that was clicked to fire the event.
5443
+ * The **`notification`** read-only property of the NotificationEvent interface returns the instance of the Notification that was clicked to fire the event. The Notification provides read-only access to many properties that were set at the instantiation time of the Notification such as tag and data attributes that allow you to store information for deferred use in the notificationclick event.
5444
5444
  *
5445
5445
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/NotificationEvent/notification)
5446
5446
  */
@@ -5459,43 +5459,43 @@ declare var NotificationEvent: {
5459
5459
  */
5460
5460
  interface OES_draw_buffers_indexed {
5461
5461
  /**
5462
- * The `blendEquationSeparateiOES()` method of the OES_draw_buffers_indexed WebGL extension sets the RGB and alpha blend equations separately for a particular draw buffer.
5462
+ * The **`blendEquationSeparateiOES()`** method of the OES_draw_buffers_indexed WebGL extension sets the RGB and alpha blend equations separately for a particular draw buffer.
5463
5463
  *
5464
5464
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OES_draw_buffers_indexed/blendEquationSeparateiOES)
5465
5465
  */
5466
5466
  blendEquationSeparateiOES(buf: GLuint, modeRGB: GLenum, modeAlpha: GLenum): void;
5467
5467
  /**
5468
- * The `blendEquationiOES()` method of the `OES_draw_buffers_indexed` WebGL extension sets both the RGB blend and alpha blend equations for a particular draw buffer.
5468
+ * The **`blendEquationiOES()`** method of the OES_draw_buffers_indexed WebGL extension sets both the RGB blend and alpha blend equations for a particular draw buffer.
5469
5469
  *
5470
5470
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OES_draw_buffers_indexed/blendEquationiOES)
5471
5471
  */
5472
5472
  blendEquationiOES(buf: GLuint, mode: GLenum): void;
5473
5473
  /**
5474
- * The `blendFuncSeparateiOES()` method of the OES_draw_buffers_indexed WebGL extension defines which function is used when blending pixels for RGB and alpha components separately for a particular draw buffer.
5474
+ * The **`blendFuncSeparateiOES()`** method of the OES_draw_buffers_indexed WebGL extension defines which function is used when blending pixels for RGB and alpha components separately for a particular draw buffer.
5475
5475
  *
5476
5476
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OES_draw_buffers_indexed/blendFuncSeparateiOES)
5477
5477
  */
5478
5478
  blendFuncSeparateiOES(buf: GLuint, srcRGB: GLenum, dstRGB: GLenum, srcAlpha: GLenum, dstAlpha: GLenum): void;
5479
5479
  /**
5480
- * The `blendFunciOES()` method of the OES_draw_buffers_indexed WebGL extension defines which function is used when blending pixels for a particular draw buffer.
5480
+ * The **`blendFunciOES()`** method of the OES_draw_buffers_indexed WebGL extension defines which function is used when blending pixels for a particular draw buffer.
5481
5481
  *
5482
5482
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OES_draw_buffers_indexed/blendFunciOES)
5483
5483
  */
5484
5484
  blendFunciOES(buf: GLuint, src: GLenum, dst: GLenum): void;
5485
5485
  /**
5486
- * The `colorMaskiOES()` method of the OES_draw_buffers_indexed WebGL extension sets which color components to enable or to disable when drawing or rendering for a particular draw buffer.
5486
+ * The **`colorMaskiOES()`** method of the OES_draw_buffers_indexed WebGL extension sets which color components to enable or to disable when drawing or rendering for a particular draw buffer. It's the indexed version of WebGL 1's WebGLRenderingContext.colorMask() method.
5487
5487
  *
5488
5488
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OES_draw_buffers_indexed/colorMaskiOES)
5489
5489
  */
5490
5490
  colorMaskiOES(buf: GLuint, r: GLboolean, g: GLboolean, b: GLboolean, a: GLboolean): void;
5491
5491
  /**
5492
- * The `disableiOES()` method of the OES_draw_buffers_indexed WebGL extension enables blending for a particular draw buffer.
5492
+ * The **`disableiOES()`** method of the OES_draw_buffers_indexed WebGL extension enables blending for a particular draw buffer.
5493
5493
  *
5494
5494
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OES_draw_buffers_indexed/disableiOES)
5495
5495
  */
5496
5496
  disableiOES(target: GLenum, index: GLuint): void;
5497
5497
  /**
5498
- * The `enableiOES()` method of the OES_draw_buffers_indexed WebGL extension enables blending for a particular draw buffer.
5498
+ * The **`enableiOES()`** method of the OES_draw_buffers_indexed WebGL extension enables blending for a particular draw buffer.
5499
5499
  *
5500
5500
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OES_draw_buffers_indexed/enableiOES)
5501
5501
  */
@@ -5503,7 +5503,7 @@ interface OES_draw_buffers_indexed {
5503
5503
  }
5504
5504
 
5505
5505
  /**
5506
- * The **`OES_element_index_uint`** extension is part of the WebGL API and adds support for `gl.UNSIGNED_INT` types to WebGLRenderingContext.drawElements().
5506
+ * The **`OES_element_index_uint`** extension is part of the WebGL API and adds support for gl.UNSIGNED_INT types to WebGLRenderingContext.drawElements().
5507
5507
  *
5508
5508
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OES_element_index_uint)
5509
5509
  */
@@ -5511,7 +5511,7 @@ interface OES_element_index_uint {
5511
5511
  }
5512
5512
 
5513
5513
  /**
5514
- * The `OES_fbo_render_mipmap` extension is part of the WebGL API and makes it possible to attach any level of a texture to a framebuffer object.
5514
+ * The **`OES_fbo_render_mipmap`** extension is part of the WebGL API and makes it possible to attach any level of a texture to a framebuffer object.
5515
5515
  *
5516
5516
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OES_fbo_render_mipmap)
5517
5517
  */
@@ -5519,7 +5519,7 @@ interface OES_fbo_render_mipmap {
5519
5519
  }
5520
5520
 
5521
5521
  /**
5522
- * The **`OES_standard_derivatives`** extension is part of the WebGL API and adds the GLSL derivative functions `dFdx`, `dFdy`, and `fwidth`.
5522
+ * The **`OES_standard_derivatives`** extension is part of the WebGL API and adds the GLSL derivative functions dFdx, dFdy, and fwidth.
5523
5523
  *
5524
5524
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OES_standard_derivatives)
5525
5525
  */
@@ -5561,7 +5561,7 @@ interface OES_texture_half_float_linear {
5561
5561
  }
5562
5562
 
5563
5563
  /**
5564
- * The **OES_vertex_array_object** extension is part of the WebGL API and provides vertex array objects (VAOs) which encapsulate vertex array states.
5564
+ * The **`OES_vertex_array_object`** extension is part of the WebGL API and provides vertex array objects (VAOs) which encapsulate vertex array states. These objects keep pointers to vertex data and provide names for different sets of vertex data.
5565
5565
  *
5566
5566
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OES_vertex_array_object)
5567
5567
  */
@@ -5585,7 +5585,7 @@ interface OES_vertex_array_object {
5585
5585
  */
5586
5586
  deleteVertexArrayOES(arrayObject: WebGLVertexArrayObjectOES | null): void;
5587
5587
  /**
5588
- * The **`OES_vertex_array_object.isVertexArrayOES()`** method of the WebGL API returns `true` if the passed object is a WebGLVertexArrayObject object.
5588
+ * The **`OES_vertex_array_object.isVertexArrayOES()`** method of the WebGL API returns true if the passed object is a WebGLVertexArrayObject object.
5589
5589
  *
5590
5590
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OES_vertex_array_object/isVertexArrayOES)
5591
5591
  */
@@ -5594,7 +5594,7 @@ interface OES_vertex_array_object {
5594
5594
  }
5595
5595
 
5596
5596
  /**
5597
- * The `OVR_multiview2` extension is part of the WebGL API and adds support for rendering into multiple views simultaneously.
5597
+ * The **`OVR_multiview2`** extension is part of the WebGL API and adds support for rendering into multiple views simultaneously. This especially useful for virtual reality (VR) and WebXR.
5598
5598
  *
5599
5599
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OVR_multiview2)
5600
5600
  */
@@ -5617,7 +5617,7 @@ interface OffscreenCanvasEventMap {
5617
5617
  }
5618
5618
 
5619
5619
  /**
5620
- * When using the canvas element or the Canvas API, rendering, animation, and user interaction usually happen on the main execution thread of a web application.
5620
+ * When using the <canvas> element or the Canvas API, rendering, animation, and user interaction usually happen on the main execution thread of a web application. The computation relating to canvas animations and rendering can have a significant impact on application performance.
5621
5621
  *
5622
5622
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OffscreenCanvas)
5623
5623
  */
@@ -5645,7 +5645,7 @@ interface OffscreenCanvas extends EventTarget {
5645
5645
  */
5646
5646
  convertToBlob(options?: ImageEncodeOptions): Promise<Blob>;
5647
5647
  /**
5648
- * The **`OffscreenCanvas.getContext()`** method returns a drawing context for an offscreen canvas, or `null` if the context identifier is not supported, or the offscreen canvas has already been set to a different context mode.
5648
+ * The **`OffscreenCanvas.getContext()`** method returns a drawing context for an offscreen canvas, or null if the context identifier is not supported, or the offscreen canvas has already been set to a different context mode.
5649
5649
  *
5650
5650
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OffscreenCanvas/getContext)
5651
5651
  */
@@ -5655,7 +5655,7 @@ interface OffscreenCanvas extends EventTarget {
5655
5655
  getContext(contextId: "webgl2", options?: any): WebGL2RenderingContext | null;
5656
5656
  getContext(contextId: OffscreenRenderingContextId, options?: any): OffscreenRenderingContext | null;
5657
5657
  /**
5658
- * The **`OffscreenCanvas.transferToImageBitmap()`** method creates an ImageBitmap object from the most recently rendered image of the `OffscreenCanvas`.
5658
+ * The **`OffscreenCanvas.transferToImageBitmap()`** method creates an ImageBitmap object from the most recently rendered image of the OffscreenCanvas. The OffscreenCanvas allocates a new image for its subsequent rendering.
5659
5659
  *
5660
5660
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OffscreenCanvas/transferToImageBitmap)
5661
5661
  */
@@ -5672,7 +5672,7 @@ declare var OffscreenCanvas: {
5672
5672
  };
5673
5673
 
5674
5674
  /**
5675
- * The **`OffscreenCanvasRenderingContext2D`** interface is a CanvasRenderingContext2D rendering context for drawing to the bitmap of an `OffscreenCanvas` object.
5675
+ * The **`OffscreenCanvasRenderingContext2D`** interface is a CanvasRenderingContext2D rendering context for drawing to the bitmap of an OffscreenCanvas object. It is similar to the CanvasRenderingContext2D object, with the following differences:
5676
5676
  *
5677
5677
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/OffscreenCanvasRenderingContext2D)
5678
5678
  */
@@ -5687,13 +5687,13 @@ declare var OffscreenCanvasRenderingContext2D: {
5687
5687
  };
5688
5688
 
5689
5689
  /**
5690
- * The **`Path2D`** interface of the Canvas 2D API is used to declare a path that can then be used on a CanvasRenderingContext2D object.
5690
+ * The **`Path2D`** interface of the Canvas 2D API is used to declare a path that can then be used on a CanvasRenderingContext2D object. The path methods of the CanvasRenderingContext2D interface are also present on this interface, which gives you the convenience of being able to retain and replay your path whenever desired.
5691
5691
  *
5692
5692
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Path2D)
5693
5693
  */
5694
5694
  interface Path2D extends CanvasPath {
5695
5695
  /**
5696
- * The **`Path2D.addPath()`** method of the Canvas 2D API adds one Path2D object to another `Path2D` object.
5696
+ * The **`Path2D.addPath()`** method of the Canvas 2D API adds one Path2D object to another Path2D object.
5697
5697
  *
5698
5698
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Path2D/addPath)
5699
5699
  */
@@ -5736,7 +5736,7 @@ interface Performance extends EventTarget {
5736
5736
  */
5737
5737
  clearMeasures(measureName?: string): void;
5738
5738
  /**
5739
- * The **`clearResourceTimings()`** method removes all performance entries with an PerformanceEntry.entryType of `'resource'` from the browser's performance timeline and sets the size of the performance resource data buffer to zero.
5739
+ * The **`clearResourceTimings()`** method removes all performance entries with an entryType of "resource" from the browser's performance timeline and sets the size of the performance resource data buffer to zero.
5740
5740
  *
5741
5741
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/clearResourceTimings)
5742
5742
  */
@@ -5748,13 +5748,13 @@ interface Performance extends EventTarget {
5748
5748
  */
5749
5749
  getEntries(): PerformanceEntryList;
5750
5750
  /**
5751
- * The **`getEntriesByName()`** method returns an array of PerformanceEntry objects currently present in the performance timeline with the given _name_ and _type_.
5751
+ * The **`getEntriesByName()`** method returns an array of PerformanceEntry objects currently present in the performance timeline with the given name and type.
5752
5752
  *
5753
5753
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntriesByName)
5754
5754
  */
5755
5755
  getEntriesByName(name: string, type?: string): PerformanceEntryList;
5756
5756
  /**
5757
- * The **`getEntriesByType()`** method returns an array of PerformanceEntry objects currently present in the performance timeline for a given _type_.
5757
+ * The **`getEntriesByType()`** method returns an array of PerformanceEntry objects currently present in the performance timeline for a given type.
5758
5758
  *
5759
5759
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntriesByType)
5760
5760
  */
@@ -5772,19 +5772,19 @@ interface Performance extends EventTarget {
5772
5772
  */
5773
5773
  measure(measureName: string, startOrMeasureOptions?: string | PerformanceMeasureOptions, endMark?: string): PerformanceMeasure;
5774
5774
  /**
5775
- * The **`performance.now()`** method returns a high resolution timestamp in milliseconds.
5775
+ * The **`performance.now()`** method returns a high resolution timestamp in milliseconds. It represents the time elapsed since Performance.timeOrigin (the time when navigation has started in window contexts, or the time when the worker is run in Worker and ServiceWorker contexts).
5776
5776
  *
5777
5777
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/now)
5778
5778
  */
5779
5779
  now(): DOMHighResTimeStamp;
5780
5780
  /**
5781
- * The **`setResourceTimingBufferSize()`** method sets the desired size of the browser's resource timing buffer which stores the `'resource'` performance entries.
5781
+ * The **`setResourceTimingBufferSize()`** method sets the desired size of the browser's resource timing buffer which stores the "resource" performance entries.
5782
5782
  *
5783
5783
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/setResourceTimingBufferSize)
5784
5784
  */
5785
5785
  setResourceTimingBufferSize(maxSize: number): void;
5786
5786
  /**
5787
- * The **`toJSON()`** method of the Performance interface is a Serialization; it returns a JSON representation of the Performance object.
5787
+ * The **`toJSON()`** method of the Performance interface is a serializer; it returns a JSON representation of the Performance object.
5788
5788
  *
5789
5789
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/toJSON)
5790
5790
  */
@@ -5807,7 +5807,7 @@ declare var Performance: {
5807
5807
  */
5808
5808
  interface PerformanceEntry {
5809
5809
  /**
5810
- * The read-only **`duration`** property returns a DOMHighResTimeStamp that is the duration of the PerformanceEntry.
5810
+ * The read-only **`duration`** property returns a timestamp that is the duration of the performance entry. The meaning of this property depends on the value of this entry's entryType.
5811
5811
  *
5812
5812
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/duration)
5813
5813
  */
@@ -5819,19 +5819,19 @@ interface PerformanceEntry {
5819
5819
  */
5820
5820
  readonly entryType: string;
5821
5821
  /**
5822
- * The read-only **`name`** property of the PerformanceEntry interface is a string representing the name for a performance entry.
5822
+ * The read-only **`name`** property of the PerformanceEntry interface is a string representing the name for a performance entry. It acts as an identifier, but it does not have to be unique. The value depends on the subclass.
5823
5823
  *
5824
5824
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/name)
5825
5825
  */
5826
5826
  readonly name: string;
5827
5827
  /**
5828
- * The read-only **`startTime`** property returns the first DOMHighResTimeStamp recorded for this PerformanceEntry.
5828
+ * The read-only **`startTime`** property returns the first timestamp recorded for this PerformanceEntry. The meaning of this property depends on the value of this entry's entryType.
5829
5829
  *
5830
5830
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/startTime)
5831
5831
  */
5832
5832
  readonly startTime: DOMHighResTimeStamp;
5833
5833
  /**
5834
- * The **`toJSON()`** method is a Serialization; it returns a JSON representation of the PerformanceEntry object.
5834
+ * The **`toJSON()`** method is a serializer; it returns a JSON representation of the PerformanceEntry object.
5835
5835
  *
5836
5836
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/toJSON)
5837
5837
  */
@@ -5844,13 +5844,13 @@ declare var PerformanceEntry: {
5844
5844
  };
5845
5845
 
5846
5846
  /**
5847
- * **`PerformanceMark`** is an interface for PerformanceEntry objects with an PerformanceEntry.entryType of `'mark'`.
5847
+ * **`PerformanceMark`** is an interface for PerformanceEntry objects with an entryType of "mark".
5848
5848
  *
5849
5849
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMark)
5850
5850
  */
5851
5851
  interface PerformanceMark extends PerformanceEntry {
5852
5852
  /**
5853
- * The read-only **`detail`** property returns arbitrary metadata that was included in the mark upon construction (either when using Performance.mark or the PerformanceMark.PerformanceMark constructor).
5853
+ * The read-only **`detail`** property returns arbitrary metadata that was included in the mark upon construction (either when using performance.mark() or the PerformanceMark() constructor).
5854
5854
  *
5855
5855
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMark/detail)
5856
5856
  */
@@ -5863,13 +5863,13 @@ declare var PerformanceMark: {
5863
5863
  };
5864
5864
 
5865
5865
  /**
5866
- * **`PerformanceMeasure`** is an _abstract_ interface for PerformanceEntry objects with an PerformanceEntry.entryType of `'measure'`.
5866
+ * **`PerformanceMeasure`** is an abstract interface for PerformanceEntry objects with an entryType of "measure". Entries of this type are created by calling performance.measure() to add a named DOMHighResTimeStamp (the measure) between two marks to the browser's performance timeline.
5867
5867
  *
5868
5868
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMeasure)
5869
5869
  */
5870
5870
  interface PerformanceMeasure extends PerformanceEntry {
5871
5871
  /**
5872
- * The read-only **`detail`** property returns arbitrary metadata that was included in the mark upon construction (when using Performance.measure.
5872
+ * The read-only **`detail`** property returns arbitrary metadata that was included in the mark upon construction (when using performance.measure().
5873
5873
  *
5874
5874
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMeasure/detail)
5875
5875
  */
@@ -5882,19 +5882,19 @@ declare var PerformanceMeasure: {
5882
5882
  };
5883
5883
 
5884
5884
  /**
5885
- * The **`PerformanceObserver`** interface is used to observe performance measurement events and be notified of new PerformanceEntry as they are recorded in the browser's _performance timeline_.
5885
+ * The **`PerformanceObserver`** interface is used to observe performance measurement events and be notified of new performance entries as they are recorded in the browser's performance timeline.
5886
5886
  *
5887
5887
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver)
5888
5888
  */
5889
5889
  interface PerformanceObserver {
5890
5890
  /**
5891
- * The **`disconnect()`** method of the PerformanceObserver interface is used to stop the performance observer from receiving any PerformanceEntry events.
5891
+ * The **`disconnect()`** method of the PerformanceObserver interface is used to stop the performance observer from receiving any performance entry events.
5892
5892
  *
5893
5893
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/disconnect)
5894
5894
  */
5895
5895
  disconnect(): void;
5896
5896
  /**
5897
- * The **`observe()`** method of the **PerformanceObserver** interface is used to specify the set of performance entry types to observe.
5897
+ * The **`observe()`** method of the PerformanceObserver interface is used to specify the set of performance entry types to observe.
5898
5898
  *
5899
5899
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/observe)
5900
5900
  */
@@ -5911,7 +5911,7 @@ declare var PerformanceObserver: {
5911
5911
  prototype: PerformanceObserver;
5912
5912
  new(callback: PerformanceObserverCallback): PerformanceObserver;
5913
5913
  /**
5914
- * The static **`supportedEntryTypes`** read-only property of the PerformanceObserver interface returns an array of the PerformanceEntry.entryType values supported by the user agent.
5914
+ * The static **`supportedEntryTypes`** read-only property of the PerformanceObserver interface returns an array of the entryType values supported by the user agent.
5915
5915
  *
5916
5916
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/supportedEntryTypes_static)
5917
5917
  */
@@ -5919,25 +5919,25 @@ declare var PerformanceObserver: {
5919
5919
  };
5920
5920
 
5921
5921
  /**
5922
- * The **`PerformanceObserverEntryList`** interface is a list of PerformanceEntry that were explicitly observed via the PerformanceObserver.observe method.
5922
+ * The **`PerformanceObserverEntryList`** interface is a list of performance events that were explicitly observed via the observe() method.
5923
5923
  *
5924
5924
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList)
5925
5925
  */
5926
5926
  interface PerformanceObserverEntryList {
5927
5927
  /**
5928
- * The **`getEntries()`** method of the PerformanceObserverEntryList interface returns a list of explicitly observed PerformanceEntry objects.
5928
+ * The **`getEntries()`** method of the PerformanceObserverEntryList interface returns a list of explicitly observed performance entry objects. The list's members are determined by the set of entry types specified in the call to the observe() method. The list is available in the observer's callback function (as the first parameter in the callback).
5929
5929
  *
5930
5930
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntries)
5931
5931
  */
5932
5932
  getEntries(): PerformanceEntryList;
5933
5933
  /**
5934
- * The **`getEntriesByName()`** method of the PerformanceObserverEntryList interface returns a list of explicitly observed PerformanceEntry objects for a given PerformanceEntry.name and PerformanceEntry.entryType.
5934
+ * The **`getEntriesByName()`** method of the PerformanceObserverEntryList interface returns a list of explicitly observed PerformanceEntry objects for a given name and entryType. The list's members are determined by the set of entry types specified in the call to the observe() method. The list is available in the observer's callback function (as the first parameter in the callback).
5935
5935
  *
5936
5936
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntriesByName)
5937
5937
  */
5938
5938
  getEntriesByName(name: string, type?: string): PerformanceEntryList;
5939
5939
  /**
5940
- * The **`getEntriesByType()`** method of the PerformanceObserverEntryList returns a list of explicitly _observed_ PerformanceEntry objects for a given PerformanceEntry.entryType.
5940
+ * The **`getEntriesByType()`** method of the PerformanceObserverEntryList returns a list of explicitly observed performance entry objects for a given performance entry type. The list's members are determined by the set of entry types specified in the call to the observe() method. The list is available in the observer's callback function (as the first parameter in the callback).
5941
5941
  *
5942
5942
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntriesByType)
5943
5943
  */
@@ -5950,49 +5950,49 @@ declare var PerformanceObserverEntryList: {
5950
5950
  };
5951
5951
 
5952
5952
  /**
5953
- * The **`PerformanceResourceTiming`** interface enables retrieval and analysis of detailed network timing data regarding the loading of an application's resources.
5953
+ * The **`PerformanceResourceTiming`** interface enables retrieval and analysis of detailed network timing data regarding the loading of an application's resources. An application can use the timing metrics to determine, for example, the length of time it takes to fetch a specific resource, such as an XMLHttpRequest, <SVG>, image, or script.
5954
5954
  *
5955
5955
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming)
5956
5956
  */
5957
5957
  interface PerformanceResourceTiming extends PerformanceEntry {
5958
5958
  /**
5959
- * The **`connectEnd`** read-only property returns the DOMHighResTimeStamp immediately after the browser finishes establishing the connection to the server to retrieve the resource.
5959
+ * The **`connectEnd`** read-only property returns the timestamp immediately after the browser finishes establishing the connection to the server to retrieve the resource. The timestamp value includes the time interval to establish the transport connection, as well as other time intervals such as TLS handshake and SOCKS authentication.
5960
5960
  *
5961
5961
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/connectEnd)
5962
5962
  */
5963
5963
  readonly connectEnd: DOMHighResTimeStamp;
5964
5964
  /**
5965
- * The **`connectStart`** read-only property returns the DOMHighResTimeStamp immediately before the user agent starts establishing the connection to the server to retrieve the resource.
5965
+ * The **`connectStart`** read-only property returns the timestamp immediately before the user agent starts establishing the connection to the server to retrieve the resource.
5966
5966
  *
5967
5967
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/connectStart)
5968
5968
  */
5969
5969
  readonly connectStart: DOMHighResTimeStamp;
5970
5970
  /**
5971
- * The **`decodedBodySize`** read-only property returns the size (in octets) received from the fetch (HTTP or cache) of the message body after removing any applied content encoding (like gzip or Brotli).
5971
+ * The **`decodedBodySize`** read-only property returns the size (in octets) received from the fetch (HTTP or cache) of the message body after removing any applied content encoding (like gzip or Brotli). If the resource is retrieved from an application cache or local resources, it returns the size of the payload after removing any applied content encoding.
5972
5972
  *
5973
5973
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/decodedBodySize)
5974
5974
  */
5975
5975
  readonly decodedBodySize: number;
5976
5976
  /**
5977
- * The **`domainLookupEnd`** read-only property returns the DOMHighResTimeStamp immediately after the browser finishes the domain-name lookup for the resource.
5977
+ * The **`domainLookupEnd`** read-only property returns the timestamp immediately after the browser finishes the domain-name lookup for the resource.
5978
5978
  *
5979
5979
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/domainLookupEnd)
5980
5980
  */
5981
5981
  readonly domainLookupEnd: DOMHighResTimeStamp;
5982
5982
  /**
5983
- * The **`domainLookupStart`** read-only property returns the DOMHighResTimeStamp immediately before the browser starts the domain name lookup for the resource.
5983
+ * The **`domainLookupStart`** read-only property returns the timestamp immediately before the browser starts the domain name lookup for the resource.
5984
5984
  *
5985
5985
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/domainLookupStart)
5986
5986
  */
5987
5987
  readonly domainLookupStart: DOMHighResTimeStamp;
5988
5988
  /**
5989
- * The **`encodedBodySize`** read-only property represents the size (in octets) received from the fetch (HTTP or cache) of the payload body before removing any applied content encodings (like gzip or Brotli).
5989
+ * The **`encodedBodySize`** read-only property represents the size (in octets) received from the fetch (HTTP or cache) of the payload body before removing any applied content encodings (like gzip or Brotli). If the resource is retrieved from an application cache or a local resource, it must return the size of the payload body before removing any applied content encoding.
5990
5990
  *
5991
5991
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/encodedBodySize)
5992
5992
  */
5993
5993
  readonly encodedBodySize: number;
5994
5994
  /**
5995
- * The **`fetchStart`** read-only property represents a DOMHighResTimeStamp immediately before the browser starts to fetch the resource.
5995
+ * The **`fetchStart`** read-only property represents a timestamp immediately before the browser starts to fetch the resource.
5996
5996
  *
5997
5997
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/fetchStart)
5998
5998
  */
@@ -6010,31 +6010,31 @@ interface PerformanceResourceTiming extends PerformanceEntry {
6010
6010
  */
6011
6011
  readonly nextHopProtocol: string;
6012
6012
  /**
6013
- * The **`redirectEnd`** read-only property returns a DOMHighResTimeStamp immediately after receiving the last byte of the response of the last redirect.
6013
+ * The **`redirectEnd`** read-only property returns a timestamp immediately after receiving the last byte of the response of the last redirect.
6014
6014
  *
6015
6015
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/redirectEnd)
6016
6016
  */
6017
6017
  readonly redirectEnd: DOMHighResTimeStamp;
6018
6018
  /**
6019
- * The **`redirectStart`** read-only property returns a DOMHighResTimeStamp representing the start time of the fetch which that initiates the redirect.
6019
+ * The **`redirectStart`** read-only property returns a timestamp representing the start time of the fetch which that initiates the redirect.
6020
6020
  *
6021
6021
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/redirectStart)
6022
6022
  */
6023
6023
  readonly redirectStart: DOMHighResTimeStamp;
6024
6024
  /**
6025
- * The **`requestStart`** read-only property returns a DOMHighResTimeStamp of the time immediately before the browser starts requesting the resource from the server, cache, or local resource.
6025
+ * The **`requestStart`** read-only property returns a timestamp of the time immediately before the browser starts requesting the resource from the server, cache, or local resource. If the transport connection fails and the browser retires the request, the value returned will be the start of the retry request.
6026
6026
  *
6027
6027
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/requestStart)
6028
6028
  */
6029
6029
  readonly requestStart: DOMHighResTimeStamp;
6030
6030
  /**
6031
- * The **`responseEnd`** read-only property returns a DOMHighResTimeStamp immediately after the browser receives the last byte of the resource or immediately before the transport connection is closed, whichever comes first.
6031
+ * The **`responseEnd`** read-only property returns a timestamp immediately after the browser receives the last byte of the resource or immediately before the transport connection is closed, whichever comes first.
6032
6032
  *
6033
6033
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseEnd)
6034
6034
  */
6035
6035
  readonly responseEnd: DOMHighResTimeStamp;
6036
6036
  /**
6037
- * The **`responseStart`** read-only property returns a DOMHighResTimeStamp immediately after the browser receives the first byte of the response from the server, cache, or local resource.
6037
+ * The **`responseStart`** read-only property returns a timestamp immediately after the browser receives the first byte of the response from the server, cache, or local resource.
6038
6038
  *
6039
6039
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseStart)
6040
6040
  */
@@ -6046,7 +6046,7 @@ interface PerformanceResourceTiming extends PerformanceEntry {
6046
6046
  */
6047
6047
  readonly responseStatus: number;
6048
6048
  /**
6049
- * The **`secureConnectionStart`** read-only property returns a DOMHighResTimeStamp immediately before the browser starts the handshake process to secure the current connection.
6049
+ * The **`secureConnectionStart`** read-only property returns a timestamp immediately before the browser starts the handshake process to secure the current connection. If a secure connection is not used, the property returns zero.
6050
6050
  *
6051
6051
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/secureConnectionStart)
6052
6052
  */
@@ -6058,19 +6058,19 @@ interface PerformanceResourceTiming extends PerformanceEntry {
6058
6058
  */
6059
6059
  readonly serverTiming: ReadonlyArray<PerformanceServerTiming>;
6060
6060
  /**
6061
- * The **`transferSize`** read-only property represents the size (in octets) of the fetched resource.
6061
+ * The **`transferSize`** read-only property represents the size (in octets) of the fetched resource. The size includes the response header fields plus the response payload body (as defined by RFC7230).
6062
6062
  *
6063
6063
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/transferSize)
6064
6064
  */
6065
6065
  readonly transferSize: number;
6066
6066
  /**
6067
- * The **`workerStart`** read-only property of the PerformanceResourceTiming interface returns a DOMHighResTimeStamp immediately before dispatching the FetchEvent if a Service Worker thread is already running, or immediately before starting the Service Worker thread if it is not already running.
6067
+ * The **`workerStart`** read-only property of the PerformanceResourceTiming interface returns a DOMHighResTimeStamp immediately before dispatching the FetchEvent if a Service Worker thread is already running, or immediately before starting the Service Worker thread if it is not already running. If the resource is not intercepted by a Service Worker the property will always return 0.
6068
6068
  *
6069
6069
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/workerStart)
6070
6070
  */
6071
6071
  readonly workerStart: DOMHighResTimeStamp;
6072
6072
  /**
6073
- * The **`toJSON()`** method of the PerformanceResourceTiming interface is a Serialization; it returns a JSON representation of the PerformanceResourceTiming object.
6073
+ * The **`toJSON()`** method of the PerformanceResourceTiming interface is a serializer; it returns a JSON representation of the PerformanceResourceTiming object.
6074
6074
  *
6075
6075
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/toJSON)
6076
6076
  */
@@ -6095,7 +6095,7 @@ interface PerformanceServerTiming {
6095
6095
  */
6096
6096
  readonly description: string;
6097
6097
  /**
6098
- * The **`duration`** read-only property returns a double that contains the server-specified metric duration, or the value `0.0`.
6098
+ * The **`duration`** read-only property returns a double that contains the server-specified metric duration, or the value 0.0.
6099
6099
  *
6100
6100
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceServerTiming/duration)
6101
6101
  */
@@ -6107,7 +6107,7 @@ interface PerformanceServerTiming {
6107
6107
  */
6108
6108
  readonly name: string;
6109
6109
  /**
6110
- * The **`toJSON()`** method of the PerformanceServerTiming interface is a Serialization; it returns a JSON representation of the PerformanceServerTiming object.
6110
+ * The **`toJSON()`** method of the PerformanceServerTiming interface is a serializer; it returns a JSON representation of the PerformanceServerTiming object.
6111
6111
  *
6112
6112
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceServerTiming/toJSON)
6113
6113
  */
@@ -6138,7 +6138,7 @@ interface PermissionStatus extends EventTarget {
6138
6138
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/PermissionStatus/change_event) */
6139
6139
  onchange: ((this: PermissionStatus, ev: Event) => any) | null;
6140
6140
  /**
6141
- * The **`state`** read-only property of the PermissionStatus interface returns the state of a requested permission.
6141
+ * The **`state`** read-only property of the PermissionStatus interface returns the state of a requested permission. This property returns one of 'granted', 'denied', or 'prompt'.
6142
6142
  *
6143
6143
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PermissionStatus/state)
6144
6144
  */
@@ -6174,19 +6174,19 @@ declare var Permissions: {
6174
6174
  };
6175
6175
 
6176
6176
  /**
6177
- * The **`ProgressEvent`** interface represents events that measure the progress of an underlying process, like an HTTP request (e.g., an `XMLHttpRequest`, or the loading of the underlying resource of an img, audio, video, style or link).
6177
+ * The **`ProgressEvent`** interface represents events that measure the progress of an underlying process, like an HTTP request (e.g., an XMLHttpRequest, or the loading of the underlying resource of an <img>, <audio>, <video>, <style> or <link>).
6178
6178
  *
6179
6179
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ProgressEvent)
6180
6180
  */
6181
6181
  interface ProgressEvent<T extends EventTarget = EventTarget> extends Event {
6182
6182
  /**
6183
- * The **`ProgressEvent.lengthComputable`** read-only property is a boolean flag indicating if the resource concerned by the ProgressEvent has a length that can be calculated.
6183
+ * The **`ProgressEvent.lengthComputable`** read-only property is a boolean flag indicating if the resource concerned by the ProgressEvent has a length that can be calculated. If not, the ProgressEvent.total property has no significant value.
6184
6184
  *
6185
6185
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ProgressEvent/lengthComputable)
6186
6186
  */
6187
6187
  readonly lengthComputable: boolean;
6188
6188
  /**
6189
- * The **`ProgressEvent.loaded`** read-only property is a number indicating the size of the data already transmitted or processed.
6189
+ * The **`ProgressEvent.loaded`** read-only property is a number indicating the size of the data already transmitted or processed. The progress ratio can be calculated by dividing the value of this property by ProgressEvent.total.
6190
6190
  *
6191
6191
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ProgressEvent/loaded)
6192
6192
  */
@@ -6206,19 +6206,19 @@ declare var ProgressEvent: {
6206
6206
  };
6207
6207
 
6208
6208
  /**
6209
- * The **`PromiseRejectionEvent`** interface represents events which are sent to the global script context when JavaScript Promises are rejected.
6209
+ * The **`PromiseRejectionEvent`** interface represents events which are sent to the global script context when JavaScript Promises are rejected. These events are particularly useful for telemetry and debugging purposes.
6210
6210
  *
6211
6211
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent)
6212
6212
  */
6213
6213
  interface PromiseRejectionEvent extends Event {
6214
6214
  /**
6215
- * The PromiseRejectionEvent interface's **`promise`** read-only property indicates the JavaScript Promise which was rejected.
6215
+ * The PromiseRejectionEvent interface's **`promise`** read-only property indicates the JavaScript Promise which was rejected. You can examine the event's PromiseRejectionEvent.reason property to learn why the promise was rejected.
6216
6216
  *
6217
6217
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/promise)
6218
6218
  */
6219
6219
  readonly promise: Promise<any>;
6220
6220
  /**
6221
- * The PromiseRejectionEvent **`reason`** read-only property is any JavaScript value or Object which provides the reason passed into Promise.reject().
6221
+ * The PromiseRejectionEvent **`reason`** read-only property is any JavaScript value or Object which provides the reason passed into Promise.reject(). This in theory provides information about why the promise was rejected.
6222
6222
  *
6223
6223
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/reason)
6224
6224
  */
@@ -6231,14 +6231,14 @@ declare var PromiseRejectionEvent: {
6231
6231
  };
6232
6232
 
6233
6233
  /**
6234
- * The **`PushEvent`** interface of the Push API represents a push message that has been received.
6234
+ * The **`PushEvent`** interface of the Push API represents a push message that has been received. This event is sent to the global scope of a ServiceWorker. It contains the information sent from an application server to a PushSubscription.
6235
6235
  * Available only in secure contexts.
6236
6236
  *
6237
6237
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PushEvent)
6238
6238
  */
6239
6239
  interface PushEvent extends ExtendableEvent {
6240
6240
  /**
6241
- * The `data` read-only property of the **`PushEvent`** interface returns a reference to a PushMessageData object containing data sent to the PushSubscription.
6241
+ * The **`data`** read-only property of the PushEvent interface returns a reference to a PushMessageData object containing data sent to the PushSubscription.
6242
6242
  *
6243
6243
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PushEvent/data)
6244
6244
  */
@@ -6264,7 +6264,7 @@ interface PushManager {
6264
6264
  */
6265
6265
  getSubscription(): Promise<PushSubscription | null>;
6266
6266
  /**
6267
- * The **`permissionState()`** method of the PushManager interface returns a Promise that resolves to a string indicating the permission state of the push manager.
6267
+ * The **`permissionState()`** method of the PushManager interface returns a Promise that resolves to a string indicating the permission state of the push manager. Possible values are 'prompt', 'denied', or 'granted'.
6268
6268
  *
6269
6269
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PushManager/permissionState)
6270
6270
  */
@@ -6339,7 +6339,7 @@ declare var PushMessageData: {
6339
6339
  };
6340
6340
 
6341
6341
  /**
6342
- * The `PushSubscription` interface of the Push API provides a subscription's URL endpoint along with the public key and secrets that should be used for encrypting push messages to this subscription.
6342
+ * The **`PushSubscription`** interface of the Push API provides a subscription's URL endpoint along with the public key and secrets that should be used for encrypting push messages to this subscription. This information must be passed to the application server, using any desired application-specific method.
6343
6343
  * Available only in secure contexts.
6344
6344
  *
6345
6345
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PushSubscription)
@@ -6352,7 +6352,7 @@ interface PushSubscription {
6352
6352
  */
6353
6353
  readonly endpoint: string;
6354
6354
  /**
6355
- * The **`expirationTime`** read-only property of the PushSubscription interface returns a DOMHighResTimeStamp of the subscription expiration time associated with the push subscription, if there is one, or `null` otherwise.
6355
+ * The **`expirationTime`** read-only property of the PushSubscription interface returns a DOMHighResTimeStamp of the subscription expiration time associated with the push subscription, if there is one, or null otherwise.
6356
6356
  *
6357
6357
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PushSubscription/expirationTime)
6358
6358
  */
@@ -6364,19 +6364,19 @@ interface PushSubscription {
6364
6364
  */
6365
6365
  readonly options: PushSubscriptionOptions;
6366
6366
  /**
6367
- * The `getKey()` method of the PushSubscription interface returns an ArrayBuffer representing a client public key, which can then be sent to a server and used in encrypting push message data.
6367
+ * The **`getKey()`** method of the PushSubscription interface returns an ArrayBuffer representing a client public key, which can then be sent to a server and used in encrypting push message data.
6368
6368
  *
6369
6369
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PushSubscription/getKey)
6370
6370
  */
6371
6371
  getKey(name: PushEncryptionKeyName): ArrayBuffer | null;
6372
6372
  /**
6373
- * The `toJSON()` method of the PushSubscription interface is a standard serializer: it returns a JSON representation of the subscription properties, providing a useful shortcut.
6373
+ * The **`toJSON()`** method of the PushSubscription interface is a standard serializer: it returns a JSON representation of the subscription properties, providing a useful shortcut.
6374
6374
  *
6375
6375
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PushSubscription/toJSON)
6376
6376
  */
6377
6377
  toJSON(): PushSubscriptionJSON;
6378
6378
  /**
6379
- * The `unsubscribe()` method of the PushSubscription interface returns a Promise that resolves to a boolean value when the current subscription is successfully unsubscribed.
6379
+ * The **`unsubscribe()`** method of the PushSubscription interface returns a Promise that resolves to a boolean value when the current subscription is successfully unsubscribed.
6380
6380
  *
6381
6381
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PushSubscription/unsubscribe)
6382
6382
  */
@@ -6426,19 +6426,19 @@ declare var PushSubscriptionOptions: {
6426
6426
  };
6427
6427
 
6428
6428
  /**
6429
- * The **`ReadableByteStreamController`** interface of the Streams API represents a controller for a readable byte stream.
6429
+ * The **`ReadableByteStreamController`** interface of the Streams API represents a controller for a readable byte stream. It allows control of the state and internal queue of a ReadableStream with an underlying byte source, and enables efficient zero-copy transfer of data from the underlying source to a consumer when the stream's internal queue is empty.
6430
6430
  *
6431
6431
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController)
6432
6432
  */
6433
6433
  interface ReadableByteStreamController {
6434
6434
  /**
6435
- * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or `null` if there are no pending requests.
6435
+ * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or null if there are no pending requests.
6436
6436
  *
6437
6437
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/byobRequest)
6438
6438
  */
6439
6439
  readonly byobRequest: ReadableStreamBYOBRequest | null;
6440
6440
  /**
6441
- * The **`desiredSize`** read-only property of the ReadableByteStreamController interface returns the number of bytes required to fill the stream's internal queue to its 'desired size'.
6441
+ * The **`desiredSize`** read-only property of the ReadableByteStreamController interface returns the number of bytes required to fill the stream's internal queue to its "desired size".
6442
6442
  *
6443
6443
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/desiredSize)
6444
6444
  */
@@ -6469,7 +6469,7 @@ declare var ReadableByteStreamController: {
6469
6469
  };
6470
6470
 
6471
6471
  /**
6472
- * The `ReadableStream` interface of the Streams API represents a readable stream of byte data.
6472
+ * The **`ReadableStream`** interface of the Streams API represents a readable stream of byte data. The Fetch API offers a concrete instance of a ReadableStream through the body property of a Response object.
6473
6473
  *
6474
6474
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream)
6475
6475
  */
@@ -6487,7 +6487,7 @@ interface ReadableStream<R = any> {
6487
6487
  */
6488
6488
  cancel(reason?: any): Promise<void>;
6489
6489
  /**
6490
- * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it.
6490
+ * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it. While the stream is locked, no other reader can be acquired until this one is released.
6491
6491
  *
6492
6492
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader)
6493
6493
  */
@@ -6501,7 +6501,7 @@ interface ReadableStream<R = any> {
6501
6501
  */
6502
6502
  pipeThrough<T>(transform: ReadableWritablePair<T, R>, options?: StreamPipeOptions): ReadableStream<T>;
6503
6503
  /**
6504
- * The **`pipeTo()`** method of the ReadableStream interface pipes the current `ReadableStream` to a given WritableStream and returns a Promise that fulfills when the piping process completes successfully, or rejects if any errors were encountered.
6504
+ * The **`pipeTo()`** method of the ReadableStream interface pipes the current ReadableStream to a given WritableStream and returns a Promise that fulfills when the piping process completes successfully, or rejects if any errors were encountered.
6505
6505
  *
6506
6506
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeTo)
6507
6507
  */
@@ -6522,19 +6522,19 @@ declare var ReadableStream: {
6522
6522
  };
6523
6523
 
6524
6524
  /**
6525
- * The `ReadableStreamBYOBReader` interface of the Streams API defines a reader for a ReadableStream that supports zero-copy reading from an underlying byte source.
6525
+ * The **`ReadableStreamBYOBReader`** interface of the Streams API defines a reader for a ReadableStream that supports zero-copy reading from an underlying byte source. It is used for efficient copying from underlying sources where the data is delivered as an "anonymous" sequence of bytes, such as files.
6526
6526
  *
6527
6527
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader)
6528
6528
  */
6529
6529
  interface ReadableStreamBYOBReader extends ReadableStreamGenericReader {
6530
6530
  /**
6531
- * The **`read()`** method of the ReadableStreamBYOBReader interface is used to read data into a view on a user-supplied buffer from an associated readable byte stream.
6531
+ * The **`read()`** method of the ReadableStreamBYOBReader interface is used to read data into a view on a user-supplied buffer from an associated readable byte stream. A request for data will be satisfied from the stream's internal queues if there is any data present. If the stream queues are empty, the request may be supplied as a zero-copy transfer from the underlying byte source.
6532
6532
  *
6533
6533
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/read)
6534
6534
  */
6535
- read<T extends ArrayBufferView>(view: T, options?: ReadableStreamBYOBReaderReadOptions): Promise<ReadableStreamReadResult<T>>;
6535
+ read<T extends Exclude<BufferSource, ArrayBuffer>>(view: T, options?: ReadableStreamBYOBReaderReadOptions): Promise<ReadableStreamReadResult<T>>;
6536
6536
  /**
6537
- * The **`releaseLock()`** method of the ReadableStreamBYOBReader interface releases the reader's lock on the stream.
6537
+ * The **`releaseLock()`** method of the ReadableStreamBYOBReader interface releases the reader's lock on the stream. After the lock is released, the reader is no longer active.
6538
6538
  *
6539
6539
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/releaseLock)
6540
6540
  */
@@ -6547,7 +6547,7 @@ declare var ReadableStreamBYOBReader: {
6547
6547
  };
6548
6548
 
6549
6549
  /**
6550
- * The **`ReadableStreamBYOBRequest`** interface of the Streams API represents a 'pull request' for data from an underlying source that will made as a zero-copy transfer to a consumer (bypassing the stream's internal queues).
6550
+ * The **`ReadableStreamBYOBRequest`** interface of the Streams API represents a "pull request" for data from an underlying source that will made as a zero-copy transfer to a consumer (bypassing the stream's internal queues).
6551
6551
  *
6552
6552
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest)
6553
6553
  */
@@ -6578,7 +6578,7 @@ declare var ReadableStreamBYOBRequest: {
6578
6578
  };
6579
6579
 
6580
6580
  /**
6581
- * The **`ReadableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a ReadableStream's state and internal queue.
6581
+ * The **`ReadableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a ReadableStream's state and internal queue. Default controllers are for streams that are not byte streams.
6582
6582
  *
6583
6583
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController)
6584
6584
  */
@@ -6647,7 +6647,7 @@ interface ReadableStreamGenericReader {
6647
6647
  }
6648
6648
 
6649
6649
  /**
6650
- * The `ReportingObserver` interface of the Reporting API allows you to collect and access reports.
6650
+ * The **`ReportingObserver`** interface of the Reporting API allows you to collect and access reports.
6651
6651
  *
6652
6652
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReportingObserver)
6653
6653
  */
@@ -6684,19 +6684,19 @@ declare var ReportingObserver: {
6684
6684
  */
6685
6685
  interface Request extends Body {
6686
6686
  /**
6687
- * The **`cache`** read-only property of the Request interface contains the cache mode of the request.
6687
+ * The **`cache`** read-only property of the Request interface contains the cache mode of the request. It controls how the request will interact with the browser's HTTP cache.
6688
6688
  *
6689
6689
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/cache)
6690
6690
  */
6691
6691
  readonly cache: RequestCache;
6692
6692
  /**
6693
- * The **`credentials`** read-only property of the Request interface reflects the value given to the Request.Request() constructor in the `credentials` option.
6693
+ * The **`credentials`** read-only property of the Request interface reflects the value given to the Request() constructor in the credentials option. It determines whether or not the browser sends credentials with the request, as well as whether any Set-Cookie response headers are respected.
6694
6694
  *
6695
6695
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/credentials)
6696
6696
  */
6697
6697
  readonly credentials: RequestCredentials;
6698
6698
  /**
6699
- * The **`destination`** read-only property of the **Request** interface returns a string describing the type of content being requested.
6699
+ * The **`destination`** read-only property of the Request interface returns a string describing the type of content being requested.
6700
6700
  *
6701
6701
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/destination)
6702
6702
  */
@@ -6714,19 +6714,19 @@ interface Request extends Body {
6714
6714
  */
6715
6715
  readonly integrity: string;
6716
6716
  /**
6717
- * The **`keepalive`** read-only property of the Request interface contains the request's `keepalive` setting (`true` or `false`), which indicates whether the browser will keep the associated request alive if the page that initiated it is unloaded before the request is complete.
6717
+ * The **`keepalive`** read-only property of the Request interface contains the request's keepalive setting (true or false), which indicates whether the browser will keep the associated request alive if the page that initiated it is unloaded before the request is complete.
6718
6718
  *
6719
6719
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/keepalive)
6720
6720
  */
6721
6721
  readonly keepalive: boolean;
6722
6722
  /**
6723
- * The **`method`** read-only property of the Request interface contains the request's method (`GET`, `POST`, etc.)
6723
+ * The **`method`** read-only property of the Request interface contains the request's method (GET, POST, etc.)
6724
6724
  *
6725
6725
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/method)
6726
6726
  */
6727
6727
  readonly method: string;
6728
6728
  /**
6729
- * The **`mode`** read-only property of the Request interface contains the mode of the request (e.g., `cors`, `no-cors`, `same-origin`, or `navigate`.) This is used to determine if cross-origin requests lead to valid responses, and which properties of the response are readable.
6729
+ * The **`mode`** read-only property of the Request interface contains the mode of the request (e.g., cors, no-cors, same-origin, or navigate.) This is used to determine if cross-origin requests lead to valid responses, and which properties of the response are readable.
6730
6730
  *
6731
6731
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/mode)
6732
6732
  */
@@ -6738,7 +6738,7 @@ interface Request extends Body {
6738
6738
  */
6739
6739
  readonly redirect: RequestRedirect;
6740
6740
  /**
6741
- * The **`referrer`** read-only property of the Request interface is set by the user agent to be the referrer of the Request.
6741
+ * The **`referrer`** read-only property of the Request interface is set by the user agent to be the referrer of the Request. (e.g., client, no-referrer, or a URL.)
6742
6742
  *
6743
6743
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/referrer)
6744
6744
  */
@@ -6762,7 +6762,7 @@ interface Request extends Body {
6762
6762
  */
6763
6763
  readonly url: string;
6764
6764
  /**
6765
- * The **`clone()`** method of the Request interface creates a copy of the current `Request` object.
6765
+ * The **`clone()`** method of the Request interface creates a copy of the current Request object.
6766
6766
  *
6767
6767
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/clone)
6768
6768
  */
@@ -6811,13 +6811,13 @@ interface Response extends Body {
6811
6811
  */
6812
6812
  readonly statusText: string;
6813
6813
  /**
6814
- * The **`type`** read-only property of the Response interface contains the type of the response.
6814
+ * The **`type`** read-only property of the Response interface contains the type of the response. The type determines whether scripts are able to access the response body and headers.
6815
6815
  *
6816
6816
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/type)
6817
6817
  */
6818
6818
  readonly type: ResponseType;
6819
6819
  /**
6820
- * The **`url`** read-only property of the Response interface contains the URL of the response.
6820
+ * The **`url`** read-only property of the Response interface contains the URL of the response. The value of the url property will be the final URL obtained after any redirects.
6821
6821
  *
6822
6822
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/url)
6823
6823
  */
@@ -6834,19 +6834,19 @@ declare var Response: {
6834
6834
  prototype: Response;
6835
6835
  new(body?: BodyInit | null, init?: ResponseInit): Response;
6836
6836
  /**
6837
- * The **`error()`** static method of the Response interface returns a new `Response` object associated with a network error.
6837
+ * The **`error()`** static method of the Response interface returns a new Response object associated with a network error.
6838
6838
  *
6839
6839
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/error_static)
6840
6840
  */
6841
6841
  error(): Response;
6842
6842
  /**
6843
- * The **`json()`** static method of the Response interface returns a `Response` that contains the provided JSON data as body, and a Content-Type header which is set to `application/json`.
6843
+ * The **`json()`** method of the Response interface takes a Response stream and reads it to completion. It returns a promise which resolves with the result of parsing the body text as JSON.
6844
6844
  *
6845
6845
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/json_static)
6846
6846
  */
6847
6847
  json(data: any, init?: ResponseInit): Response;
6848
6848
  /**
6849
- * The **`redirect()`** static method of the Response interface returns a `Response` resulting in a redirect to the specified URL.
6849
+ * The **`redirect()`** static method of the Response interface returns a Response resulting in a redirect to the specified URL.
6850
6850
  *
6851
6851
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/redirect_static)
6852
6852
  */
@@ -6866,7 +6866,7 @@ interface Scheduler {
6866
6866
  */
6867
6867
  postTask(callback: SchedulerPostTaskCallback, options?: SchedulerPostTaskOptions): Promise<any>;
6868
6868
  /**
6869
- * The **`yield()`** method of the Scheduler interface is used for yielding to the main thread during a task and continuing execution later, with the continuation scheduled as a prioritized task (see the Prioritized Task Scheduling API for more information).
6869
+ * The **`yield()`** method of the Scheduler interface is used for yielding to the main thread during a task and continuing execution later, with the continuation scheduled as a prioritized task (see the Prioritized Task Scheduling API for more information). This allows long-running work to be broken up so the browser stays responsive.
6870
6870
  *
6871
6871
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Scheduler/yield)
6872
6872
  */
@@ -6879,7 +6879,7 @@ declare var Scheduler: {
6879
6879
  };
6880
6880
 
6881
6881
  /**
6882
- * The **`SecurityPolicyViolationEvent`** interface inherits from Event, and represents the event object of a `securitypolicyviolation` event sent on an Element/securitypolicyviolation_event, Document/securitypolicyviolation_event, or WorkerGlobalScope/securitypolicyviolation_event when its Content Security Policy (CSP) is violated.
6882
+ * The **`SecurityPolicyViolationEvent`** interface inherits from Event, and represents the event object of a securitypolicyviolation event sent on an Element, Document, or worker when its Content Security Policy (CSP) is violated.
6883
6883
  *
6884
6884
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SecurityPolicyViolationEvent)
6885
6885
  */
@@ -6927,7 +6927,7 @@ interface SecurityPolicyViolationEvent extends Event {
6927
6927
  */
6928
6928
  readonly originalPolicy: string;
6929
6929
  /**
6930
- * The **`referrer`** read-only property of the SecurityPolicyViolationEvent interface is a string representing the referrer for the resources whose Content Security Policy (CSP) was violated.
6930
+ * The **`referrer`** read-only property of the SecurityPolicyViolationEvent interface is a string representing the referrer for the resources whose Content Security Policy (CSP) was violated. This will be a URL or null.
6931
6931
  *
6932
6932
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SecurityPolicyViolationEvent/referrer)
6933
6933
  */
@@ -6968,7 +6968,7 @@ interface ServiceWorkerEventMap extends AbstractWorkerEventMap {
6968
6968
  }
6969
6969
 
6970
6970
  /**
6971
- * The **`ServiceWorker`** interface of the Service Worker API provides a reference to a service worker.
6971
+ * The **`ServiceWorker`** interface of the Service Worker API provides a reference to a service worker. Multiple browsing contexts (e.g., pages, workers, etc.) can be associated with the same service worker, each through a unique ServiceWorker object.
6972
6972
  * Available only in secure contexts.
6973
6973
  *
6974
6974
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorker)
@@ -6977,19 +6977,19 @@ interface ServiceWorker extends EventTarget, AbstractWorker {
6977
6977
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorker/statechange_event) */
6978
6978
  onstatechange: ((this: ServiceWorker, ev: Event) => any) | null;
6979
6979
  /**
6980
- * Returns the `ServiceWorker` serialized script URL defined as part of `ServiceWorkerRegistration`.
6980
+ * Returns the ServiceWorker serialized script URL defined as part of ServiceWorkerRegistration. Must be on the same origin as the document that registers the ServiceWorker.
6981
6981
  *
6982
6982
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorker/scriptURL)
6983
6983
  */
6984
6984
  readonly scriptURL: string;
6985
6985
  /**
6986
- * The **`state`** read-only property of the ServiceWorker interface returns a string representing the current state of the service worker.
6986
+ * The **`state`** read-only property of the ServiceWorker interface returns a string representing the current state of the service worker. It can be one of the following values: parsed, installing, installed, activating, activated, or redundant.
6987
6987
  *
6988
6988
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorker/state)
6989
6989
  */
6990
6990
  readonly state: ServiceWorkerState;
6991
6991
  /**
6992
- * The **`postMessage()`** method of the ServiceWorker interface sends a message to the worker.
6992
+ * The **`postMessage()`** method of the ServiceWorker interface sends a message to the worker. The first parameter is the data to send to the worker. The data may be any JavaScript object which can be handled by the structured clone algorithm.
6993
6993
  *
6994
6994
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorker/postMessage)
6995
6995
  */
@@ -7020,7 +7020,7 @@ interface ServiceWorkerContainerEventMap {
7020
7020
  */
7021
7021
  interface ServiceWorkerContainer extends EventTarget {
7022
7022
  /**
7023
- * The **`controller`** read-only property of the ServiceWorkerContainer interface represents the active ServiceWorker controlling the current page (associated with this `ServiceWorkerContainer`), or `null` if the page has no active or activating service worker.
7023
+ * The **`controller`** read-only property of the ServiceWorkerContainer interface represents the active service worker controlling the current page (associated with this ServiceWorkerContainer), or null if the page has no active or activating service worker.
7024
7024
  *
7025
7025
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerContainer/controller)
7026
7026
  */
@@ -7038,25 +7038,25 @@ interface ServiceWorkerContainer extends EventTarget {
7038
7038
  */
7039
7039
  readonly ready: Promise<ServiceWorkerRegistration>;
7040
7040
  /**
7041
- * The **`getRegistration()`** method of the ServiceWorkerContainer interface gets a ServiceWorkerRegistration object whose scope URL matches the provided client URL.
7041
+ * The **`getRegistration()`** method of the ServiceWorkerContainer interface gets a ServiceWorkerRegistration object whose scope URL matches the provided client URL. The method returns a Promise that resolves to a ServiceWorkerRegistration or undefined.
7042
7042
  *
7043
7043
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerContainer/getRegistration)
7044
7044
  */
7045
7045
  getRegistration(clientURL?: string | URL): Promise<ServiceWorkerRegistration | undefined>;
7046
7046
  /**
7047
- * The **`getRegistrations()`** method of the ServiceWorkerContainer interface gets all ServiceWorkerRegistrations associated with a `ServiceWorkerContainer`, in an array.
7047
+ * The **`getRegistrations()`** method of the ServiceWorkerContainer interface gets all ServiceWorkerRegistrations associated with a ServiceWorkerContainer, in an array. The method returns a Promise that resolves to an array of ServiceWorkerRegistration.
7048
7048
  *
7049
7049
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerContainer/getRegistrations)
7050
7050
  */
7051
7051
  getRegistrations(): Promise<ReadonlyArray<ServiceWorkerRegistration>>;
7052
7052
  /**
7053
- * The **`register()`** method of the ServiceWorkerContainer interface creates or updates a ServiceWorkerRegistration for the given scope.
7053
+ * The **`register()`** method of the ServiceWorkerContainer interface creates or updates a ServiceWorkerRegistration for the given scope. If successful, the registration associates the provided script URL to a scope, which is subsequently used for matching documents to a specific service worker.
7054
7054
  *
7055
7055
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerContainer/register)
7056
7056
  */
7057
7057
  register(scriptURL: string | URL, options?: RegistrationOptions): Promise<ServiceWorkerRegistration>;
7058
7058
  /**
7059
- * The **`startMessages()`** method of the ServiceWorkerContainer interface explicitly starts the flow of messages being dispatched from a service worker to pages under its control (e.g., sent via Client.postMessage()).
7059
+ * The **`startMessages()`** method of the ServiceWorkerContainer interface explicitly starts the flow of messages being dispatched from a service worker to pages under its control (e.g., sent via Client.postMessage()). This can be used to react to sent messages earlier, even before that page's content has finished loading.
7060
7060
  *
7061
7061
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerContainer/startMessages)
7062
7062
  */
@@ -7093,7 +7093,7 @@ interface ServiceWorkerGlobalScopeEventMap extends WorkerGlobalScopeEventMap {
7093
7093
  */
7094
7094
  interface ServiceWorkerGlobalScope extends WorkerGlobalScope {
7095
7095
  /**
7096
- * The **`clients`** read-only property of the ServiceWorkerGlobalScope interface returns the `Clients` object associated with the service worker.
7096
+ * The **`clients`** read-only property of the ServiceWorkerGlobalScope interface returns the Clients object associated with the service worker.
7097
7097
  *
7098
7098
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerGlobalScope/clients)
7099
7099
  */
@@ -7158,26 +7158,26 @@ interface ServiceWorkerRegistrationEventMap {
7158
7158
  }
7159
7159
 
7160
7160
  /**
7161
- * The **`ServiceWorkerRegistration`** interface of the Service Worker API represents the service worker registration.
7161
+ * The **`ServiceWorkerRegistration`** interface of the Service Worker API represents the service worker registration. You register a service worker to control one or more pages that share the same origin.
7162
7162
  * Available only in secure contexts.
7163
7163
  *
7164
7164
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerRegistration)
7165
7165
  */
7166
7166
  interface ServiceWorkerRegistration extends EventTarget, PushManagerAttribute {
7167
7167
  /**
7168
- * The **`active`** read-only property of the ServiceWorkerRegistration interface returns a service worker whose ServiceWorker.state is `activating` or `activated`.
7168
+ * The **`active`** read-only property of the ServiceWorkerRegistration interface returns a service worker whose ServiceWorker.state is activating or activated. This property is initially set to null.
7169
7169
  *
7170
7170
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerRegistration/active)
7171
7171
  */
7172
7172
  readonly active: ServiceWorker | null;
7173
7173
  /**
7174
- * The **`cookies`** read-only property of the ServiceWorkerRegistration interface returns a reference to the CookieStoreManager interface, which enables a web app to subscribe to and unsubscribe from cookie change events in a service worker.
7174
+ * The **`cookies`** read-only property of the ServiceWorkerRegistration interface returns a reference to the CookieStoreManager interface, which enables a web app to subscribe to and unsubscribe from cookie change events in a service worker. This is an entry point for the Cookie Store API.
7175
7175
  *
7176
7176
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerRegistration/cookies)
7177
7177
  */
7178
7178
  readonly cookies: CookieStoreManager;
7179
7179
  /**
7180
- * The **`installing`** read-only property of the ServiceWorkerRegistration interface returns a service worker whose ServiceWorker.state is `installing`.
7180
+ * The **`installing`** read-only property of the ServiceWorkerRegistration interface returns a service worker whose ServiceWorker.state is installing. This property is initially set to null.
7181
7181
  *
7182
7182
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerRegistration/installing)
7183
7183
  */
@@ -7191,25 +7191,25 @@ interface ServiceWorkerRegistration extends EventTarget, PushManagerAttribute {
7191
7191
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerRegistration/updatefound_event) */
7192
7192
  onupdatefound: ((this: ServiceWorkerRegistration, ev: Event) => any) | null;
7193
7193
  /**
7194
- * The **`scope`** read-only property of the ServiceWorkerRegistration interface returns a string representing a URL that defines a service worker's registration scope; that is, the range of URLs a service worker can control.
7194
+ * The **`scope`** read-only property of the ServiceWorkerRegistration interface returns a string representing a URL that defines a service worker's registration scope; that is, the range of URLs a service worker can control. This is set using the scope parameter specified in the call to ServiceWorkerContainer.register() which registered the service worker.
7195
7195
  *
7196
7196
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerRegistration/scope)
7197
7197
  */
7198
7198
  readonly scope: string;
7199
7199
  /**
7200
- * The **`updateViaCache`** read-only property of the ServiceWorkerRegistration interface returns the value of the setting used to determine the circumstances in which the browser will consult the HTTP cache when it tries to update the service worker or any scripts that are imported via WorkerGlobalScope.importScripts.
7200
+ * The **`updateViaCache`** read-only property of the ServiceWorkerRegistration interface returns the value of the setting used to determine the circumstances in which the browser will consult the HTTP cache when it tries to update the service worker or any scripts that are imported via importScripts().
7201
7201
  *
7202
7202
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerRegistration/updateViaCache)
7203
7203
  */
7204
7204
  readonly updateViaCache: ServiceWorkerUpdateViaCache;
7205
7205
  /**
7206
- * The **`waiting`** read-only property of the ServiceWorkerRegistration interface returns a service worker whose ServiceWorker.state is `installed`.
7206
+ * The **`waiting`** read-only property of the ServiceWorkerRegistration interface returns a service worker whose ServiceWorker.state is installed. This property is initially set to null.
7207
7207
  *
7208
7208
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerRegistration/waiting)
7209
7209
  */
7210
7210
  readonly waiting: ServiceWorker | null;
7211
7211
  /**
7212
- * The **`getNotifications()`** method of the ServiceWorkerRegistration interface returns a list of the notifications in the order that they were created from the current origin via the current service worker registration.
7212
+ * The **`getNotifications()`** method of the ServiceWorkerRegistration interface returns a list of the notifications in the order that they were created from the current origin via the current service worker registration. Origins can have many active but differently-scoped service worker registrations. Notifications created by one service worker on the same origin will not be available to other active service workers on that same origin.
7213
7213
  *
7214
7214
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerRegistration/getNotifications)
7215
7215
  */
@@ -7221,13 +7221,13 @@ interface ServiceWorkerRegistration extends EventTarget, PushManagerAttribute {
7221
7221
  */
7222
7222
  showNotification(title: string, options?: NotificationOptions): Promise<void>;
7223
7223
  /**
7224
- * The **`unregister()`** method of the ServiceWorkerRegistration interface unregisters the service worker registration and returns a Promise.
7224
+ * The **`unregister()`** method of the ServiceWorkerRegistration interface unregisters the service worker registration and returns a Promise. The promise will resolve to false if no registration was found, otherwise it resolves to true irrespective of whether unregistration happened or not (it may not unregister if someone else just called ServiceWorkerContainer.register() with the same scope.) The service worker will finish any ongoing operations before it is unregistered.
7225
7225
  *
7226
7226
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerRegistration/unregister)
7227
7227
  */
7228
7228
  unregister(): Promise<boolean>;
7229
7229
  /**
7230
- * The **`update()`** method of the ServiceWorkerRegistration interface attempts to update the service worker.
7230
+ * The **`update()`** method of the ServiceWorkerRegistration interface attempts to update the service worker. It fetches the worker's script URL, and if the new worker is not byte-by-byte identical to the current worker, it installs the new worker. The fetch of the worker bypasses any browser caches if the previous fetch occurred over 24 hours ago.
7231
7231
  *
7232
7232
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerRegistration/update)
7233
7233
  */
@@ -7244,14 +7244,14 @@ declare var ServiceWorkerRegistration: {
7244
7244
  };
7245
7245
 
7246
7246
  /**
7247
- * The **`StorageManager`** interface of the Storage API provides an interface for managing persistence permissions and estimating available storage.
7247
+ * The **`StorageManager`** interface of the Storage API provides an interface for managing persistence permissions and estimating available storage. You can get a reference to this interface using either navigator.storage or WorkerNavigator.storage.
7248
7248
  * Available only in secure contexts.
7249
7249
  *
7250
7250
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/StorageManager)
7251
7251
  */
7252
7252
  interface StorageManager {
7253
7253
  /**
7254
- * The **`estimate()`** method of the StorageManager interface asks the Storage Manager for how much storage the current origin takes up (`usage`), and how much space is available (`quota`).
7254
+ * The **`estimate()`** method of the StorageManager interface asks the Storage Manager for how much storage the current origin takes up (usage), and how much space is available (quota).
7255
7255
  *
7256
7256
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/StorageManager/estimate)
7257
7257
  */
@@ -7263,7 +7263,7 @@ interface StorageManager {
7263
7263
  */
7264
7264
  getDirectory(): Promise<FileSystemDirectoryHandle>;
7265
7265
  /**
7266
- * The **`persisted()`** method of the StorageManager interface returns a Promise that resolves to `true` if your site's storage bucket is persistent.
7266
+ * The **`persisted()`** method of the StorageManager interface returns a Promise that resolves to true if your site's storage bucket is persistent.
7267
7267
  *
7268
7268
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/StorageManager/persisted)
7269
7269
  */
@@ -7276,13 +7276,13 @@ declare var StorageManager: {
7276
7276
  };
7277
7277
 
7278
7278
  /**
7279
- * The **`StylePropertyMapReadOnly`** interface of the CSS Typed Object Model API provides a read-only representation of a CSS declaration block that is an alternative to CSSStyleDeclaration.
7279
+ * The **`StylePropertyMapReadOnly`** interface of the CSS Typed Object Model API provides a read-only representation of a CSS declaration block that is an alternative to CSSStyleDeclaration. Retrieve an instance of this interface using Element.computedStyleMap().
7280
7280
  *
7281
7281
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/StylePropertyMapReadOnly)
7282
7282
  */
7283
7283
  interface StylePropertyMapReadOnly {
7284
7284
  /**
7285
- * The **`size`** read-only property of the StylePropertyMapReadOnly interface returns an unsigned long integer containing the size of the `StylePropertyMapReadOnly` object.
7285
+ * The **`size`** read-only property of the StylePropertyMapReadOnly interface returns an unsigned long integer containing the size of the StylePropertyMapReadOnly object.
7286
7286
  *
7287
7287
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/StylePropertyMapReadOnly/size)
7288
7288
  */
@@ -7300,7 +7300,7 @@ interface StylePropertyMapReadOnly {
7300
7300
  */
7301
7301
  getAll(property: string): CSSStyleValue[];
7302
7302
  /**
7303
- * The **`has()`** method of the StylePropertyMapReadOnly interface indicates whether the specified property is in the `StylePropertyMapReadOnly` object.
7303
+ * The **`has()`** method of the StylePropertyMapReadOnly interface indicates whether the specified property is in the StylePropertyMapReadOnly object.
7304
7304
  *
7305
7305
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/StylePropertyMapReadOnly/has)
7306
7306
  */
@@ -7321,7 +7321,7 @@ declare var StylePropertyMapReadOnly: {
7321
7321
  */
7322
7322
  interface SubtleCrypto {
7323
7323
  /**
7324
- * The **`decrypt()`** method of the SubtleCrypto interface decrypts some encrypted data.
7324
+ * The **`decrypt()`** method of the SubtleCrypto interface decrypts some encrypted data. It takes as arguments a key to decrypt with, some optional extra parameters, and the data to decrypt (also known as "ciphertext"). It returns a Promise which will be fulfilled with the decrypted data (also known as "plaintext").
7325
7325
  *
7326
7326
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/decrypt)
7327
7327
  */
@@ -7339,7 +7339,7 @@ interface SubtleCrypto {
7339
7339
  */
7340
7340
  deriveKey(algorithm: AlgorithmIdentifier | EcdhKeyDeriveParams | HkdfParams | Pbkdf2Params, baseKey: CryptoKey, derivedKeyType: AlgorithmIdentifier | AesDerivedKeyParams | HmacImportParams | HkdfParams | Pbkdf2Params, extractable: boolean, keyUsages: KeyUsage[]): Promise<CryptoKey>;
7341
7341
  /**
7342
- * The **`digest()`** method of the SubtleCrypto interface generates a _digest_ of the given data, using the specified hash function.
7342
+ * The **`digest()`** method of the SubtleCrypto interface generates a digest of the given data, using the specified hash function. A digest is a short fixed-length value derived from some variable-length input. Cryptographic digests should exhibit collision-resistance, meaning that it's hard to come up with two different inputs that have the same digest value.
7343
7343
  *
7344
7344
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/digest)
7345
7345
  */
@@ -7381,7 +7381,7 @@ interface SubtleCrypto {
7381
7381
  */
7382
7382
  sign(algorithm: AlgorithmIdentifier | RsaPssParams | EcdsaParams, key: CryptoKey, data: BufferSource): Promise<ArrayBuffer>;
7383
7383
  /**
7384
- * The **`unwrapKey()`** method of the SubtleCrypto interface 'unwraps' a key.
7384
+ * The **`unwrapKey()`** method of the SubtleCrypto interface "unwraps" a key. This means that it takes as its input a key that has been exported and then encrypted (also called "wrapped"). It decrypts the key and then imports it, returning a CryptoKey object that can be used in the Web Crypto API.
7385
7385
  *
7386
7386
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/unwrapKey)
7387
7387
  */
@@ -7393,7 +7393,7 @@ interface SubtleCrypto {
7393
7393
  */
7394
7394
  verify(algorithm: AlgorithmIdentifier | RsaPssParams | EcdsaParams, key: CryptoKey, signature: BufferSource, data: BufferSource): Promise<boolean>;
7395
7395
  /**
7396
- * The **`wrapKey()`** method of the SubtleCrypto interface 'wraps' a key.
7396
+ * The **`wrapKey()`** method of the SubtleCrypto interface "wraps" a key. This means that it exports the key in an external, portable format, then encrypts the exported key. Wrapping a key helps protect it in untrusted environments, such as inside an otherwise unprotected data store or in transmission over an unprotected network.
7397
7397
  *
7398
7398
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/wrapKey)
7399
7399
  */
@@ -7406,13 +7406,13 @@ declare var SubtleCrypto: {
7406
7406
  };
7407
7407
 
7408
7408
  /**
7409
- * The **`TaskController`** interface of the Prioritized Task Scheduling API represents a controller object that can be used to both abort and change the priority of one or more prioritized tasks.
7409
+ * The **`TaskController`** interface of the Prioritized Task Scheduling API represents a controller object that can be used to both abort and change the priority of one or more prioritized tasks. If there is no need to change task priorities, then AbortController can be used instead.
7410
7410
  *
7411
7411
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TaskController)
7412
7412
  */
7413
7413
  interface TaskController extends AbortController {
7414
7414
  /**
7415
- * The **`setPriority()`** method of the TaskController interface can be called to set a new priority for this controller's `signal`.
7415
+ * The **`setPriority()`** method of the TaskController interface can be called to set a new priority for this controller's signal. If a prioritized task is configured to use the signal, this will also change the task priority.
7416
7416
  *
7417
7417
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TaskController/setPriority)
7418
7418
  */
@@ -7425,13 +7425,13 @@ declare var TaskController: {
7425
7425
  };
7426
7426
 
7427
7427
  /**
7428
- * The **`TaskPriorityChangeEvent`** is the interface for the `prioritychange` event.
7428
+ * The **`TaskPriorityChangeEvent`** is the interface for the prioritychange event.
7429
7429
  *
7430
7430
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TaskPriorityChangeEvent)
7431
7431
  */
7432
7432
  interface TaskPriorityChangeEvent extends Event {
7433
7433
  /**
7434
- * The **`previousPriority`** read-only property of the TaskPriorityChangeEvent interface returns the priority of the corresponding TaskSignal before it was changed and this `prioritychange` event was emitted.
7434
+ * The **`previousPriority`** read-only property of the TaskPriorityChangeEvent interface returns the priority of the corresponding TaskSignal before it was changed and this prioritychange event was emitted.
7435
7435
  *
7436
7436
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TaskPriorityChangeEvent/previousPriority)
7437
7437
  */
@@ -7471,7 +7471,7 @@ declare var TaskSignal: {
7471
7471
  prototype: TaskSignal;
7472
7472
  new(): TaskSignal;
7473
7473
  /**
7474
- * The **`TaskSignal.any()`** static method takes an iterable of AbortSignal objects and returns a TaskSignal.
7474
+ * The **`TaskSignal.any()`** static method takes an iterable of AbortSignal objects and returns a TaskSignal. The returned task signal is aborted when any of the abort signals is aborted.
7475
7475
  *
7476
7476
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TaskSignal/any_static)
7477
7477
  */
@@ -7479,7 +7479,7 @@ declare var TaskSignal: {
7479
7479
  };
7480
7480
 
7481
7481
  /**
7482
- * The **`TextDecoder`** interface represents a decoder for a specific text encoding, such as `UTF-8`, `ISO-8859-2`, or `GBK`.
7482
+ * The **`TextDecoder`** interface represents a decoder for a specific text encoding, such as UTF-8, ISO-8859-2, or GBK. A decoder takes an array of bytes as input and returns a JavaScript string.
7483
7483
  *
7484
7484
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoder)
7485
7485
  */
@@ -7519,7 +7519,7 @@ interface TextDecoderCommon {
7519
7519
  }
7520
7520
 
7521
7521
  /**
7522
- * The **`TextDecoderStream`** interface of the Encoding API converts a stream of text in a binary encoding, such as UTF-8 etc., to a stream of strings.
7522
+ * The **`TextDecoderStream`** interface of the Encoding API converts a stream of text in a binary encoding, such as UTF-8 etc., to a stream of strings. It is the streaming equivalent of TextDecoder.
7523
7523
  *
7524
7524
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoderStream)
7525
7525
  */
@@ -7534,19 +7534,19 @@ declare var TextDecoderStream: {
7534
7534
  };
7535
7535
 
7536
7536
  /**
7537
- * The **`TextEncoder`** interface enables you to character encoding a JavaScript string using UTF-8.
7537
+ * The **`TextEncoder`** interface enables you to encode a JavaScript string using UTF-8.
7538
7538
  *
7539
7539
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder)
7540
7540
  */
7541
7541
  interface TextEncoder extends TextEncoderCommon {
7542
7542
  /**
7543
- * The **`TextEncoder.encode()`** method takes a string as input, and returns a Global_Objects/Uint8Array containing the string character encoding using UTF-8.
7543
+ * The **`TextEncoder.encode()`** method takes a string as input, and returns a Uint8Array containing the string encoded using UTF-8.
7544
7544
  *
7545
7545
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encode)
7546
7546
  */
7547
7547
  encode(input?: string): Uint8Array<ArrayBuffer>;
7548
7548
  /**
7549
- * The **`TextEncoder.encodeInto()`** method takes a string to encode and a destination Uint8Array to put resulting UTF-8 encoded text into, and returns an object indicating the progress of the encoding.
7549
+ * The **`TextEncoder.encodeInto()`** method takes a string to encode and a destination Uint8Array to put resulting UTF-8 encoded text into, and returns an object indicating the progress of the encoding. This is potentially more performant than the encode() method — especially when the target buffer is a view into a Wasm heap.
7550
7550
  *
7551
7551
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encodeInto)
7552
7552
  */
@@ -7568,7 +7568,7 @@ interface TextEncoderCommon {
7568
7568
  }
7569
7569
 
7570
7570
  /**
7571
- * The **`TextEncoderStream`** interface of the Encoding API converts a stream of strings into bytes in the UTF-8 encoding.
7571
+ * The **`TextEncoderStream`** interface of the Encoding API converts a stream of strings into bytes in the UTF-8 encoding. It is the streaming equivalent of TextEncoder.
7572
7572
  *
7573
7573
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoderStream)
7574
7574
  */
@@ -7583,73 +7583,73 @@ declare var TextEncoderStream: {
7583
7583
  };
7584
7584
 
7585
7585
  /**
7586
- * The **`TextMetrics`** interface represents the dimensions of a piece of text in the canvas; a `TextMetrics` instance can be retrieved using the CanvasRenderingContext2D.measureText() method.
7586
+ * The **`TextMetrics`** interface represents the dimensions of a piece of text in the canvas; a TextMetrics instance can be retrieved using the CanvasRenderingContext2D.measureText() method.
7587
7587
  *
7588
7588
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextMetrics)
7589
7589
  */
7590
7590
  interface TextMetrics {
7591
7591
  /**
7592
- * The read-only **`actualBoundingBoxAscent`** property of the TextMetrics interface is a `double` giving the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline attribute to the top of the bounding rectangle used to render the text, in CSS pixels.
7592
+ * The read-only **`actualBoundingBoxAscent`** property of the TextMetrics interface is a double giving the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline attribute to the top of the bounding rectangle used to render the text, in CSS pixels.
7593
7593
  *
7594
7594
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextMetrics/actualBoundingBoxAscent)
7595
7595
  */
7596
7596
  readonly actualBoundingBoxAscent: number;
7597
7597
  /**
7598
- * The read-only `actualBoundingBoxDescent` property of the TextMetrics interface is a `double` giving the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline attribute to the bottom of the bounding rectangle used to render the text, in CSS pixels.
7598
+ * The read-only **`actualBoundingBoxDescent`** property of the TextMetrics interface is a double giving the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline attribute to the bottom of the bounding rectangle used to render the text, in CSS pixels.
7599
7599
  *
7600
7600
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextMetrics/actualBoundingBoxDescent)
7601
7601
  */
7602
7602
  readonly actualBoundingBoxDescent: number;
7603
7603
  /**
7604
- * The read-only `actualBoundingBoxLeft` property of the TextMetrics interface is a `double` giving the distance parallel to the baseline from the alignment point given by the CanvasRenderingContext2D.textAlign property to the left side of the bounding rectangle of the given text, in CSS pixels; positive numbers indicating a distance going left from the given alignment point.
7604
+ * The read-only **`actualBoundingBoxLeft`** property of the TextMetrics interface is a double giving the distance parallel to the baseline from the alignment point given by the CanvasRenderingContext2D.textAlign property to the left side of the bounding rectangle of the given text, in CSS pixels; positive numbers indicating a distance going left from the given alignment point.
7605
7605
  *
7606
7606
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextMetrics/actualBoundingBoxLeft)
7607
7607
  */
7608
7608
  readonly actualBoundingBoxLeft: number;
7609
7609
  /**
7610
- * The read-only `actualBoundingBoxRight` property of the TextMetrics interface is a `double` giving the distance parallel to the baseline from the alignment point given by the CanvasRenderingContext2D.textAlign property to the right side of the bounding rectangle of the given text, in CSS pixels.
7610
+ * The read-only **`actualBoundingBoxRight`** property of the TextMetrics interface is a double giving the distance parallel to the baseline from the alignment point given by the CanvasRenderingContext2D.textAlign property to the right side of the bounding rectangle of the given text, in CSS pixels.
7611
7611
  *
7612
7612
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextMetrics/actualBoundingBoxRight)
7613
7613
  */
7614
7614
  readonly actualBoundingBoxRight: number;
7615
7615
  /**
7616
- * The read-only `alphabeticBaseline` property of the TextMetrics interface is a `double` giving the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline property to the alphabetic baseline of the line box, in CSS pixels.
7616
+ * The read-only **`alphabeticBaseline`** property of the TextMetrics interface is a double giving the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline property to the alphabetic baseline of the line box, in CSS pixels.
7617
7617
  *
7618
7618
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextMetrics/alphabeticBaseline)
7619
7619
  */
7620
7620
  readonly alphabeticBaseline: number;
7621
7621
  /**
7622
- * The read-only `emHeightAscent` property of the TextMetrics interface returns the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline property to the top of the _em_ square in the line box, in CSS pixels.
7622
+ * The read-only **`emHeightAscent`** property of the TextMetrics interface returns the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline property to the top of the em square in the line box, in CSS pixels.
7623
7623
  *
7624
7624
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextMetrics/emHeightAscent)
7625
7625
  */
7626
7626
  readonly emHeightAscent: number;
7627
7627
  /**
7628
- * The read-only `emHeightDescent` property of the TextMetrics interface returns the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline property to the bottom of the _em_ square in the line box, in CSS pixels.
7628
+ * The read-only **`emHeightDescent`** property of the TextMetrics interface returns the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline property to the bottom of the em square in the line box, in CSS pixels.
7629
7629
  *
7630
7630
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextMetrics/emHeightDescent)
7631
7631
  */
7632
7632
  readonly emHeightDescent: number;
7633
7633
  /**
7634
- * The read-only `fontBoundingBoxAscent` property of the TextMetrics interface returns the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline attribute, to the top of the highest bounding rectangle of all the fonts used to render the text, in CSS pixels.
7634
+ * The read-only **`fontBoundingBoxAscent`** property of the TextMetrics interface returns the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline attribute, to the top of the highest bounding rectangle of all the fonts used to render the text, in CSS pixels.
7635
7635
  *
7636
7636
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextMetrics/fontBoundingBoxAscent)
7637
7637
  */
7638
7638
  readonly fontBoundingBoxAscent: number;
7639
7639
  /**
7640
- * The read-only `fontBoundingBoxDescent` property of the TextMetrics interface returns the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline attribute to the bottom of the bounding rectangle of all the fonts used to render the text, in CSS pixels.
7640
+ * The read-only **`fontBoundingBoxDescent`** property of the TextMetrics interface returns the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline attribute to the bottom of the bounding rectangle of all the fonts used to render the text, in CSS pixels.
7641
7641
  *
7642
7642
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextMetrics/fontBoundingBoxDescent)
7643
7643
  */
7644
7644
  readonly fontBoundingBoxDescent: number;
7645
7645
  /**
7646
- * The read-only `hangingBaseline` property of the TextMetrics interface is a `double` giving the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline property to the hanging baseline of the line box, in CSS pixels.
7646
+ * The read-only **`hangingBaseline`** property of the TextMetrics interface is a double giving the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline property to the hanging baseline of the line box, in CSS pixels.
7647
7647
  *
7648
7648
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextMetrics/hangingBaseline)
7649
7649
  */
7650
7650
  readonly hangingBaseline: number;
7651
7651
  /**
7652
- * The read-only `ideographicBaseline` property of the TextMetrics interface is a `double` giving the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline property to the ideographic baseline of the line box, in CSS pixels.
7652
+ * The read-only **`ideographicBaseline`** property of the TextMetrics interface is a double giving the distance from the horizontal line indicated by the CanvasRenderingContext2D.textBaseline property to the ideographic baseline of the line box, in CSS pixels.
7653
7653
  *
7654
7654
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextMetrics/ideographicBaseline)
7655
7655
  */
@@ -7668,19 +7668,19 @@ declare var TextMetrics: {
7668
7668
  };
7669
7669
 
7670
7670
  /**
7671
- * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain _transform stream_ concept.
7671
+ * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain transform stream concept.
7672
7672
  *
7673
7673
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream)
7674
7674
  */
7675
7675
  interface TransformStream<I = any, O = any> {
7676
7676
  /**
7677
- * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this `TransformStream`.
7677
+ * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this TransformStream.
7678
7678
  *
7679
7679
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/readable)
7680
7680
  */
7681
7681
  readonly readable: ReadableStream<O>;
7682
7682
  /**
7683
- * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this `TransformStream`.
7683
+ * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this TransformStream.
7684
7684
  *
7685
7685
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/writable)
7686
7686
  */
@@ -7711,7 +7711,7 @@ interface TransformStreamDefaultController<O = any> {
7711
7711
  */
7712
7712
  enqueue(chunk?: O): void;
7713
7713
  /**
7714
- * The **`error()`** method of the TransformStreamDefaultController interface errors both sides of the stream.
7714
+ * The **`error()`** method of the TransformStreamDefaultController interface errors both sides of the stream. Any further interactions with it will fail with the given error message, and any chunks in the queue will be discarded.
7715
7715
  *
7716
7716
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/error)
7717
7717
  */
@@ -7730,25 +7730,25 @@ declare var TransformStreamDefaultController: {
7730
7730
  };
7731
7731
 
7732
7732
  /**
7733
- * The **`URL`** interface is used to parse, construct, normalize, and encode URL.
7733
+ * The **`URL`** interface is used to parse, construct, normalize, and encode URLs. It works by providing properties which allow you to easily read and modify the components of a URL.
7734
7734
  *
7735
7735
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL)
7736
7736
  */
7737
7737
  interface URL {
7738
7738
  /**
7739
- * The **`hash`** property of the URL interface is a string containing a `'#'` followed by the fragment identifier of the URL.
7739
+ * The **`hash`** property of the URL interface is a string containing a "#" followed by the fragment identifier of the URL. If the URL does not have a fragment identifier, this property contains an empty string, "".
7740
7740
  *
7741
7741
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash)
7742
7742
  */
7743
7743
  hash: string;
7744
7744
  /**
7745
- * The **`host`** property of the URL interface is a string containing the host, which is the URL.hostname, and then, if the port of the URL is nonempty, a `':'`, followed by the URL.port of the URL.
7745
+ * The **`host`** property of the URL interface is a string containing the host, which is the hostname, and then, if the port of the URL is nonempty, a ":", followed by the port of the URL. If the URL does not have a hostname, this property contains an empty string, "".
7746
7746
  *
7747
7747
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host)
7748
7748
  */
7749
7749
  host: string;
7750
7750
  /**
7751
- * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL.
7751
+ * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL. If the URL does not have a hostname, this property contains an empty string, "". IPv4 and IPv6 addresses are normalized, such as stripping leading zeros, and domain names are converted to IDN.
7752
7752
  *
7753
7753
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname)
7754
7754
  */
@@ -7767,31 +7767,31 @@ interface URL {
7767
7767
  */
7768
7768
  readonly origin: string;
7769
7769
  /**
7770
- * The **`password`** property of the URL interface is a string containing the password component of the URL.
7770
+ * The **`password`** property of the URL interface is a string containing the password component of the URL. If the URL does not have a password, this property contains an empty string, "".
7771
7771
  *
7772
7772
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password)
7773
7773
  */
7774
7774
  password: string;
7775
7775
  /**
7776
- * The **`pathname`** property of the URL interface represents a location in a hierarchical structure.
7776
+ * The **`pathname`** property of the URL interface represents a location in a hierarchical structure. It is a string constructed from a list of path segments, each of which is prefixed by a / character.
7777
7777
  *
7778
7778
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname)
7779
7779
  */
7780
7780
  pathname: string;
7781
7781
  /**
7782
- * The **`port`** property of the URL interface is a string containing the port number of the URL.
7782
+ * The **`port`** property of the URL interface is a string containing the port number of the URL. If the port is the default for the protocol (80 for ws: and http:, 443 for wss: and https:, and 21 for ftp:), this property contains an empty string, "".
7783
7783
  *
7784
7784
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port)
7785
7785
  */
7786
7786
  port: string;
7787
7787
  /**
7788
- * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final `':'`.
7788
+ * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final ":".
7789
7789
  *
7790
7790
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol)
7791
7791
  */
7792
7792
  protocol: string;
7793
7793
  /**
7794
- * The **`search`** property of the URL interface is a search string, also called a _query string_, that is a string containing a `'?'` followed by the parameters of the URL.
7794
+ * The **`search`** property of the URL interface is a search string, also called a query string, that is a string containing a "?" followed by the parameters of the URL. If the URL does not have a search query, this property contains an empty string, "".
7795
7795
  *
7796
7796
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search)
7797
7797
  */
@@ -7803,7 +7803,7 @@ interface URL {
7803
7803
  */
7804
7804
  readonly searchParams: URLSearchParams;
7805
7805
  /**
7806
- * The **`username`** property of the URL interface is a string containing the username component of the URL.
7806
+ * The **`username`** property of the URL interface is a string containing the username component of the URL. If the URL does not have a username, this property contains an empty string, "".
7807
7807
  *
7808
7808
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username)
7809
7809
  */
@@ -7834,13 +7834,13 @@ declare var URL: {
7834
7834
  };
7835
7835
 
7836
7836
  /**
7837
- * The **`URLPattern`** interface of the URL Pattern API matches URLs or parts of URLs against a pattern.
7837
+ * The **`URLPattern`** interface of the URL Pattern API matches URLs or parts of URLs against a pattern. The pattern can contain capturing groups that extract parts of the matched URL.
7838
7838
  *
7839
7839
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern)
7840
7840
  */
7841
7841
  interface URLPattern {
7842
7842
  /**
7843
- * The **`hasRegExpGroups`** read-only property of the URLPattern interface is a boolean indicating whether or not any of the `URLPattern` components contain regular expression capturing groups.
7843
+ * The **`hasRegExpGroups`** read-only property of the URLPattern interface is a boolean indicating whether or not any of the URLPattern components contain regular expression capturing groups.
7844
7844
  *
7845
7845
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/hasRegExpGroups)
7846
7846
  */
@@ -7894,7 +7894,7 @@ interface URLPattern {
7894
7894
  */
7895
7895
  readonly username: string;
7896
7896
  /**
7897
- * The **`exec()`** method of the URLPattern interface takes a URL or object of URL parts, and returns either an object containing the results of matching the URL to the pattern, or `null` if the URL does not match the pattern.
7897
+ * The **`exec()`** method of the URLPattern interface takes a URL or object of URL parts, and returns either an object containing the results of matching the URL to the pattern, or null if the URL does not match the pattern.
7898
7898
  *
7899
7899
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/exec)
7900
7900
  */
@@ -7956,13 +7956,13 @@ interface URLSearchParams {
7956
7956
  */
7957
7957
  has(name: string, value?: string): boolean;
7958
7958
  /**
7959
- * The **`set()`** method of the URLSearchParams interface sets the value associated with a given search parameter to the given value.
7959
+ * The **`set()`** method of the URLSearchParams interface sets the value associated with a given search parameter to the given value. If there were several matching values, this method deletes the others. If the search parameter doesn't exist, this method creates it.
7960
7960
  *
7961
7961
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/set)
7962
7962
  */
7963
7963
  set(name: string, value: string): void;
7964
7964
  /**
7965
- * The **`URLSearchParams.sort()`** method sorts all key/value pairs contained in this object in place and returns `undefined`.
7965
+ * The **`URLSearchParams.sort()`** method sorts all key/value pairs contained in this object in place and returns undefined. Key/value pairs are sorted by the values of the UTF-16 code units of the keys. This method uses a stable sorting algorithm (i.e., the relative order between key/value pairs with equal keys will be preserved).
7966
7966
  *
7967
7967
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/sort)
7968
7968
  */
@@ -8174,19 +8174,19 @@ interface WEBGL_draw_buffers {
8174
8174
  }
8175
8175
 
8176
8176
  /**
8177
- * The **WEBGL_lose_context** extension is part of the WebGL API and exposes functions to simulate losing and restoring a WebGLRenderingContext.
8177
+ * The **`WEBGL_lose_context`** extension is part of the WebGL API and exposes functions to simulate losing and restoring a WebGLRenderingContext.
8178
8178
  *
8179
8179
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_lose_context)
8180
8180
  */
8181
8181
  interface WEBGL_lose_context {
8182
8182
  /**
8183
- * The **WEBGL_lose_context.loseContext()** method is part of the WebGL API and allows you to simulate losing the context of a WebGLRenderingContext context.
8183
+ * The **`WEBGL_lose_context.loseContext()`** method is part of the WebGL API and allows you to simulate losing the context of a WebGLRenderingContext context.
8184
8184
  *
8185
8185
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_lose_context/loseContext)
8186
8186
  */
8187
8187
  loseContext(): void;
8188
8188
  /**
8189
- * The **WEBGL_lose_context.restoreContext()** method is part of the WebGL API and allows you to simulate restoring the context of a WebGLRenderingContext object.
8189
+ * The **`WEBGL_lose_context.restoreContext()`** method is part of the WebGL API and allows you to simulate restoring the context of a WebGLRenderingContext object.
8190
8190
  *
8191
8191
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_lose_context/restoreContext)
8192
8192
  */
@@ -8194,31 +8194,31 @@ interface WEBGL_lose_context {
8194
8194
  }
8195
8195
 
8196
8196
  /**
8197
- * The **`WEBGL_multi_draw`** extension is part of the WebGL API and allows to render more than one primitive with a single function call.
8197
+ * The **`WEBGL_multi_draw`** extension is part of the WebGL API and allows to render more than one primitive with a single function call. This can improve a WebGL application's performance as it reduces binding costs in the renderer and speeds up GPU thread time with uniform data.
8198
8198
  *
8199
8199
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw)
8200
8200
  */
8201
8201
  interface WEBGL_multi_draw {
8202
8202
  /**
8203
- * The **`WEBGL_multi_draw.multiDrawArraysInstancedWEBGL()`** method of the WebGL API renders multiple primitives from array data.
8203
+ * The **`WEBGL_multi_draw.multiDrawArraysInstancedWEBGL()`** method of the WebGL API renders multiple primitives from array data. It is identical to multiple calls to the gl.drawArraysInstanced() method.
8204
8204
  *
8205
8205
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw/multiDrawArraysInstancedWEBGL)
8206
8206
  */
8207
8207
  multiDrawArraysInstancedWEBGL(mode: GLenum, firstsList: Int32Array<ArrayBufferLike> | GLint[], firstsOffset: number, countsList: Int32Array<ArrayBufferLike> | GLsizei[], countsOffset: number, instanceCountsList: Int32Array<ArrayBufferLike> | GLsizei[], instanceCountsOffset: number, drawcount: GLsizei): void;
8208
8208
  /**
8209
- * The **`WEBGL_multi_draw.multiDrawArraysWEBGL()`** method of the WebGL API renders multiple primitives from array data.
8209
+ * The **`WEBGL_multi_draw.multiDrawArraysWEBGL()`** method of the WebGL API renders multiple primitives from array data. It is identical to multiple calls to the gl.drawArrays() method.
8210
8210
  *
8211
8211
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw/multiDrawArraysWEBGL)
8212
8212
  */
8213
8213
  multiDrawArraysWEBGL(mode: GLenum, firstsList: Int32Array<ArrayBufferLike> | GLint[], firstsOffset: number, countsList: Int32Array<ArrayBufferLike> | GLsizei[], countsOffset: number, drawcount: GLsizei): void;
8214
8214
  /**
8215
- * The **`WEBGL_multi_draw.multiDrawElementsInstancedWEBGL()`** method of the WebGL API renders multiple primitives from array data.
8215
+ * The **`WEBGL_multi_draw.multiDrawElementsInstancedWEBGL()`** method of the WebGL API renders multiple primitives from array data. It is identical to multiple calls to the gl.drawElementsInstanced() method.
8216
8216
  *
8217
8217
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw/multiDrawElementsInstancedWEBGL)
8218
8218
  */
8219
8219
  multiDrawElementsInstancedWEBGL(mode: GLenum, countsList: Int32Array<ArrayBufferLike> | GLsizei[], countsOffset: number, type: GLenum, offsetsList: Int32Array<ArrayBufferLike> | GLsizei[], offsetsOffset: number, instanceCountsList: Int32Array<ArrayBufferLike> | GLsizei[], instanceCountsOffset: number, drawcount: GLsizei): void;
8220
8220
  /**
8221
- * The **`WEBGL_multi_draw.multiDrawElementsWEBGL()`** method of the WebGL API renders multiple primitives from array data.
8221
+ * The **`WEBGL_multi_draw.multiDrawElementsWEBGL()`** method of the WebGL API renders multiple primitives from array data. It is identical to multiple calls to the gl.drawElements() method.
8222
8222
  *
8223
8223
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WEBGL_multi_draw/multiDrawElementsWEBGL)
8224
8224
  */
@@ -8226,7 +8226,7 @@ interface WEBGL_multi_draw {
8226
8226
  }
8227
8227
 
8228
8228
  /**
8229
- * The **WebGL2RenderingContext** interface provides the OpenGL ES 3.0 rendering context for the drawing surface of an HTML canvas element.
8229
+ * The **`WebGL2RenderingContext`** interface provides the OpenGL ES 3.0 rendering context for the drawing surface of an HTML <canvas> element.
8230
8230
  *
8231
8231
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGL2RenderingContext)
8232
8232
  */
@@ -9300,25 +9300,25 @@ interface WebGL2RenderingContextOverloads {
9300
9300
  }
9301
9301
 
9302
9302
  /**
9303
- * The **WebGLActiveInfo** interface is part of the WebGL API and represents the information returned by calling the WebGLRenderingContext.getActiveAttrib() and WebGLRenderingContext.getActiveUniform() methods.
9303
+ * The **`WebGLActiveInfo`** interface is part of the WebGL API and represents the information returned by calling the WebGLRenderingContext.getActiveAttrib() and WebGLRenderingContext.getActiveUniform() methods.
9304
9304
  *
9305
9305
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLActiveInfo)
9306
9306
  */
9307
9307
  interface WebGLActiveInfo {
9308
9308
  /**
9309
- * The read-only **`WebGLActiveInfo.name`** property represents the name of the requested data returned by calling the WebGLRenderingContext.getActiveAttrib() or WebGLRenderingContext.getActiveUniform() methods.
9309
+ * The read-only **`WebGLActiveInfo.name`** property represents the name of the requested data returned by calling the getActiveAttrib() or getActiveUniform() methods.
9310
9310
  *
9311
9311
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLActiveInfo/name)
9312
9312
  */
9313
9313
  readonly name: string;
9314
9314
  /**
9315
- * The read-only **`WebGLActiveInfo.size`** property is a Number representing the size of the requested data returned by calling the WebGLRenderingContext.getActiveAttrib() or WebGLRenderingContext.getActiveUniform() methods.
9315
+ * The read-only **`WebGLActiveInfo.size`** property is a Number representing the size of the requested data returned by calling the getActiveAttrib() or getActiveUniform() methods.
9316
9316
  *
9317
9317
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLActiveInfo/size)
9318
9318
  */
9319
9319
  readonly size: GLint;
9320
9320
  /**
9321
- * The read-only **`WebGLActiveInfo.type`** property represents the type of the requested data returned by calling the WebGLRenderingContext.getActiveAttrib() or WebGLRenderingContext.getActiveUniform() methods.
9321
+ * The read-only **`WebGLActiveInfo.type`** property represents the type of the requested data returned by calling the getActiveAttrib() or getActiveUniform() methods.
9322
9322
  *
9323
9323
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLActiveInfo/type)
9324
9324
  */
@@ -9331,7 +9331,7 @@ declare var WebGLActiveInfo: {
9331
9331
  };
9332
9332
 
9333
9333
  /**
9334
- * The **WebGLBuffer** interface is part of the WebGL API and represents an opaque buffer object storing data such as vertices or colors.
9334
+ * The **`WebGLBuffer`** interface is part of the WebGL API and represents an opaque buffer object storing data such as vertices or colors.
9335
9335
  *
9336
9336
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLBuffer)
9337
9337
  */
@@ -9344,7 +9344,7 @@ declare var WebGLBuffer: {
9344
9344
  };
9345
9345
 
9346
9346
  /**
9347
- * The **WebGLContextEvent** interface is part of the WebGL API and is an interface for an event that is generated in response to a status change to the WebGL rendering context.
9347
+ * The **`WebGLContextEvent`** interface is part of the WebGL API and is an interface for an event that is generated in response to a status change to the WebGL rendering context.
9348
9348
  *
9349
9349
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLContextEvent)
9350
9350
  */
@@ -9363,7 +9363,7 @@ declare var WebGLContextEvent: {
9363
9363
  };
9364
9364
 
9365
9365
  /**
9366
- * The **WebGLFramebuffer** interface is part of the WebGL API and represents a collection of buffers that serve as a rendering destination.
9366
+ * The **`WebGLFramebuffer`** interface is part of the WebGL API and represents a collection of buffers that serve as a rendering destination.
9367
9367
  *
9368
9368
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLFramebuffer)
9369
9369
  */
@@ -9389,7 +9389,7 @@ declare var WebGLProgram: {
9389
9389
  };
9390
9390
 
9391
9391
  /**
9392
- * The **`WebGLQuery`** interface is part of the WebGL 2 API and provides ways to asynchronously query for information.
9392
+ * The **`WebGLQuery`** interface is part of the WebGL 2 API and provides ways to asynchronously query for information. By default, occlusion queries and primitive queries are available.
9393
9393
  *
9394
9394
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLQuery)
9395
9395
  */
@@ -9402,7 +9402,7 @@ declare var WebGLQuery: {
9402
9402
  };
9403
9403
 
9404
9404
  /**
9405
- * The **WebGLRenderbuffer** interface is part of the WebGL API and represents a buffer that can contain an image, or that can be a source or target of a rendering operation.
9405
+ * The **`WebGLRenderbuffer`** interface is part of the WebGL API and represents a buffer that can contain an image, or that can be a source or target of a rendering operation.
9406
9406
  *
9407
9407
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderbuffer)
9408
9408
  */
@@ -9415,7 +9415,7 @@ declare var WebGLRenderbuffer: {
9415
9415
  };
9416
9416
 
9417
9417
  /**
9418
- * The **`WebGLRenderingContext`** interface provides an interface to the OpenGL ES 2.0 graphics rendering context for the drawing surface of an HTML canvas element.
9418
+ * The **`WebGLRenderingContext`** interface provides an interface to the OpenGL ES 2.0 graphics rendering context for the drawing surface of an HTML <canvas> element.
9419
9419
  *
9420
9420
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLRenderingContext)
9421
9421
  */
@@ -10358,7 +10358,7 @@ declare var WebGLSampler: {
10358
10358
  };
10359
10359
 
10360
10360
  /**
10361
- * The **WebGLShader** is part of the WebGL API and can either be a vertex or a fragment shader.
10361
+ * The **`WebGLShader`** is part of the WebGL API and can either be a vertex or a fragment shader. A WebGLProgram requires both types of shaders.
10362
10362
  *
10363
10363
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLShader)
10364
10364
  */
@@ -10371,7 +10371,7 @@ declare var WebGLShader: {
10371
10371
  };
10372
10372
 
10373
10373
  /**
10374
- * The **WebGLShaderPrecisionFormat** interface is part of the WebGL API and represents the information returned by calling the WebGLRenderingContext.getShaderPrecisionFormat() method.
10374
+ * The **`WebGLShaderPrecisionFormat`** interface is part of the WebGL API and represents the information returned by calling the WebGLRenderingContext.getShaderPrecisionFormat() method.
10375
10375
  *
10376
10376
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLShaderPrecisionFormat)
10377
10377
  */
@@ -10415,7 +10415,7 @@ declare var WebGLSync: {
10415
10415
  };
10416
10416
 
10417
10417
  /**
10418
- * The **WebGLTexture** interface is part of the WebGL API and represents an opaque texture object providing storage and state for texturing operations.
10418
+ * The **`WebGLTexture`** interface is part of the WebGL API and represents an opaque texture object providing storage and state for texturing operations.
10419
10419
  *
10420
10420
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLTexture)
10421
10421
  */
@@ -10428,7 +10428,7 @@ declare var WebGLTexture: {
10428
10428
  };
10429
10429
 
10430
10430
  /**
10431
- * The **`WebGLTransformFeedback`** interface is part of the WebGL 2 API and enables transform feedback, which is the process of capturing primitives generated by vertex processing.
10431
+ * The **`WebGLTransformFeedback`** interface is part of the WebGL 2 API and enables transform feedback, which is the process of capturing primitives generated by vertex processing. It allows to preserve the post-transform rendering state of an object and resubmit this data multiple times.
10432
10432
  *
10433
10433
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLTransformFeedback)
10434
10434
  */
@@ -10441,7 +10441,7 @@ declare var WebGLTransformFeedback: {
10441
10441
  };
10442
10442
 
10443
10443
  /**
10444
- * The **WebGLUniformLocation** interface is part of the WebGL API and represents the location of a uniform variable in a shader program.
10444
+ * The **`WebGLUniformLocation`** interface is part of the WebGL API and represents the location of a uniform variable in a shader program.
10445
10445
  *
10446
10446
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebGLUniformLocation)
10447
10447
  */
@@ -10478,7 +10478,7 @@ interface WebSocketEventMap {
10478
10478
  }
10479
10479
 
10480
10480
  /**
10481
- * The `WebSocket` object provides the API for creating and managing a WebSocket connection to a server, as well as for sending and receiving data on the connection.
10481
+ * The **`WebSocket`** object provides the API for creating and managing a WebSocket connection to a server, as well as for sending and receiving data on the connection.
10482
10482
  *
10483
10483
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket)
10484
10484
  */
@@ -10490,13 +10490,13 @@ interface WebSocket extends EventTarget {
10490
10490
  */
10491
10491
  binaryType: BinaryType;
10492
10492
  /**
10493
- * The **`WebSocket.bufferedAmount`** read-only property returns the number of bytes of data that have been queued using calls to `send()` but not yet transmitted to the network.
10493
+ * The **`WebSocket.bufferedAmount`** read-only property returns the number of bytes of data that have been queued using calls to send() but not yet transmitted to the network. This value resets to zero once all queued data has been sent. This value does not reset to zero when the connection is closed; if you keep calling send(), this will continue to climb.
10494
10494
  *
10495
10495
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/bufferedAmount)
10496
10496
  */
10497
10497
  readonly bufferedAmount: number;
10498
10498
  /**
10499
- * The **`WebSocket.extensions`** read-only property returns the extensions selected by the server.
10499
+ * The **`WebSocket.extensions`** read-only property returns the extensions selected by the server. This is currently only the empty string or a list of extensions as negotiated by the connection.
10500
10500
  *
10501
10501
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/extensions)
10502
10502
  */
@@ -10510,7 +10510,7 @@ interface WebSocket extends EventTarget {
10510
10510
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/open_event) */
10511
10511
  onopen: ((this: WebSocket, ev: Event) => any) | null;
10512
10512
  /**
10513
- * The **`WebSocket.protocol`** read-only property returns the name of the sub-protocol the server selected; this will be one of the strings specified in the `protocols` parameter when creating the WebSocket object, or the empty string if no connection is established.
10513
+ * The **`WebSocket.protocol`** read-only property returns the name of the sub-protocol the server selected; this will be one of the strings specified in the protocols parameter when creating the WebSocket object, or the empty string if no connection is established.
10514
10514
  *
10515
10515
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/protocol)
10516
10516
  */
@@ -10528,17 +10528,17 @@ interface WebSocket extends EventTarget {
10528
10528
  */
10529
10529
  readonly url: string;
10530
10530
  /**
10531
- * The **`WebSocket.close()`** method closes the WebSocket connection or connection attempt, if any.
10531
+ * The **`WebSocket.close()`** method closes the WebSocket connection or connection attempt, if any. If the connection is already CLOSED, this method does nothing.
10532
10532
  *
10533
10533
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/close)
10534
10534
  */
10535
10535
  close(code?: number, reason?: string): void;
10536
10536
  /**
10537
- * The **`WebSocket.send()`** method enqueues the specified data to be transmitted to the server over the WebSocket connection, increasing the value of `bufferedAmount` by the number of bytes needed to contain the data.
10537
+ * The **`WebSocket.send()`** method enqueues the specified data to be transmitted to the server over the WebSocket connection, increasing the value of bufferedAmount by the number of bytes needed to contain the data. If the data can't be sent (for example, because it needs to be buffered but the buffer is full), the socket is closed automatically. The browser will throw an exception if you call send() when the connection is in the CONNECTING state. If you call send() when the connection is in the CLOSING or CLOSED states, the browser will silently discard the data.
10538
10538
  *
10539
10539
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/send)
10540
10540
  */
10541
- send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void;
10541
+ send(data: BufferSource | Blob | string): void;
10542
10542
  readonly CONNECTING: 0;
10543
10543
  readonly OPEN: 1;
10544
10544
  readonly CLOSING: 2;
@@ -10578,13 +10578,13 @@ interface WebTransport {
10578
10578
  */
10579
10579
  readonly datagrams: WebTransportDatagramDuplexStream;
10580
10580
  /**
10581
- * The **`incomingBidirectionalStreams`** read-only property of the WebTransport interface represents one or more bidirectional streams opened by the server.
10581
+ * The **`incomingBidirectionalStreams`** read-only property of the WebTransport interface represents one or more bidirectional streams opened by the server. Returns a ReadableStream of WebTransportBidirectionalStream objects. Each one can be used to reliably read data from the server and write data back to it.
10582
10582
  *
10583
10583
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebTransport/incomingBidirectionalStreams)
10584
10584
  */
10585
10585
  readonly incomingBidirectionalStreams: ReadableStream;
10586
10586
  /**
10587
- * The **`incomingUnidirectionalStreams`** read-only property of the WebTransport interface represents one or more unidirectional streams opened by the server.
10587
+ * The **`incomingUnidirectionalStreams`** read-only property of the WebTransport interface represents one or more unidirectional streams opened by the server. Returns a ReadableStream of WebTransportReceiveStream objects. Each one can be used to reliably read data from the server.
10588
10588
  *
10589
10589
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebTransport/incomingUnidirectionalStreams)
10590
10590
  */
@@ -10621,7 +10621,7 @@ declare var WebTransport: {
10621
10621
  };
10622
10622
 
10623
10623
  /**
10624
- * The **`WebTransportBidirectionalStream`** interface of the WebTransport API represents a bidirectional stream created by a server or a client that can be used for reliable transport.
10624
+ * The **`WebTransportBidirectionalStream`** interface of the WebTransport API represents a bidirectional stream created by a server or a client that can be used for reliable transport. Provides access to a WebTransportReceiveStream for reading incoming data, and a WebTransportSendStream for writing outgoing data.
10625
10625
  * Available only in secure contexts.
10626
10626
  *
10627
10627
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebTransportBidirectionalStream)
@@ -10647,14 +10647,14 @@ declare var WebTransportBidirectionalStream: {
10647
10647
  };
10648
10648
 
10649
10649
  /**
10650
- * The **`WebTransportDatagramDuplexStream`** interface of the WebTransport API represents a duplex stream that can be used for unreliable transport of datagrams between client and server.
10650
+ * The **`WebTransportDatagramDuplexStream`** interface of the WebTransport API represents a duplex stream that can be used for unreliable transport of datagrams between client and server. Provides access to a ReadableStream for reading incoming datagrams, a WritableStream for writing outgoing datagrams, and various settings and statistics related to the stream.
10651
10651
  * Available only in secure contexts.
10652
10652
  *
10653
10653
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebTransportDatagramDuplexStream)
10654
10654
  */
10655
10655
  interface WebTransportDatagramDuplexStream {
10656
10656
  /**
10657
- * The **`incomingHighWaterMark`** property of the WebTransportDatagramDuplexStream interface gets or sets the high water mark for incoming chunks of data — this is the maximum size, in chunks, that the incoming ReadableStream's internal queue can reach before it is considered full.
10657
+ * The **`incomingHighWaterMark`** property of the WebTransportDatagramDuplexStream interface gets or sets the high water mark for incoming chunks of data — this is the maximum size, in chunks, that the incoming ReadableStream's internal queue can reach before it is considered full. See Internal queues and queuing strategies for more information.
10658
10658
  *
10659
10659
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebTransportDatagramDuplexStream/incomingHighWaterMark)
10660
10660
  */
@@ -10666,13 +10666,13 @@ interface WebTransportDatagramDuplexStream {
10666
10666
  */
10667
10667
  incomingMaxAge: number | null;
10668
10668
  /**
10669
- * The **`maxDatagramSize`** read-only property of the WebTransportDatagramDuplexStream interface returns the maximum allowable size of outgoing datagrams, in bytes, that can be written to WebTransportDatagramDuplexStream.writable.
10669
+ * The **`maxDatagramSize`** read-only property of the WebTransportDatagramDuplexStream interface returns the maximum allowable size of outgoing datagrams, in bytes, that can be written to writable.
10670
10670
  *
10671
10671
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebTransportDatagramDuplexStream/maxDatagramSize)
10672
10672
  */
10673
10673
  readonly maxDatagramSize: number;
10674
10674
  /**
10675
- * The **`outgoingHighWaterMark`** property of the WebTransportDatagramDuplexStream interface gets or sets the high water mark for outgoing chunks of data — this is the maximum size, in chunks, that the outgoing WritableStream's internal queue can reach before it is considered full.
10675
+ * The **`outgoingHighWaterMark`** property of the WebTransportDatagramDuplexStream interface gets or sets the high water mark for outgoing chunks of data — this is the maximum size, in chunks, that the outgoing WritableStream's internal queue can reach before it is considered full. See Internal queues and queuing strategies for more information.
10676
10676
  *
10677
10677
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebTransportDatagramDuplexStream/outgoingHighWaterMark)
10678
10678
  */
@@ -10712,7 +10712,7 @@ interface WebTransportError extends DOMException {
10712
10712
  */
10713
10713
  readonly source: WebTransportErrorSource;
10714
10714
  /**
10715
- * The **`streamErrorCode`** read-only property of the WebTransportError interface returns a number in the range 0-255 indicating the application protocol error code for this error, or `null` if one is not available.
10715
+ * The **`streamErrorCode`** read-only property of the WebTransportError interface returns a number in the range 0-255 indicating the application protocol error code for this error, or null if one is not available.
10716
10716
  *
10717
10717
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebTransportError/streamErrorCode)
10718
10718
  */
@@ -10725,7 +10725,7 @@ declare var WebTransportError: {
10725
10725
  };
10726
10726
 
10727
10727
  /**
10728
- * The `WindowClient` interface of the ServiceWorker API represents the scope of a service worker client that is a document in a browsing context, controlled by an active worker.
10728
+ * The **`WindowClient`** interface of the ServiceWorker API represents the scope of a service worker client that is a document in a browsing context, controlled by an active worker. The service worker client independently selects and uses a service worker for its own loading and sub-resources.
10729
10729
  *
10730
10730
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WindowClient)
10731
10731
  */
@@ -10737,7 +10737,7 @@ interface WindowClient extends Client {
10737
10737
  */
10738
10738
  readonly focused: boolean;
10739
10739
  /**
10740
- * The **`visibilityState`** read-only property of the WindowClient interface indicates the visibility of the current client.
10740
+ * The **`visibilityState`** read-only property of the WindowClient interface indicates the visibility of the current client. This value can be one of "hidden", "visible", or "prerender".
10741
10741
  *
10742
10742
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WindowClient/visibilityState)
10743
10743
  */
@@ -10817,19 +10817,19 @@ interface WorkerGlobalScopeEventMap {
10817
10817
  }
10818
10818
 
10819
10819
  /**
10820
- * The **`WorkerGlobalScope`** interface of the Web Workers API is an interface representing the scope of any worker.
10820
+ * The **`WorkerGlobalScope`** interface of the Web Workers API is an interface representing the scope of any worker. Workers have no browsing context; this scope contains the information usually conveyed by Window objects — in this case event handlers, the console or the associated WorkerNavigator object. Each WorkerGlobalScope has its own event loop.
10821
10821
  *
10822
10822
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerGlobalScope)
10823
10823
  */
10824
10824
  interface WorkerGlobalScope extends EventTarget, FontFaceSource, WindowOrWorkerGlobalScope {
10825
10825
  /**
10826
- * The **`location`** read-only property of the WorkerGlobalScope interface returns the WorkerLocation associated with the worker.
10826
+ * The **`location`** read-only property of the WorkerGlobalScope interface returns the WorkerLocation associated with the worker. It is a specific location object, mostly a subset of the Location for browsing scopes, but adapted to workers.
10827
10827
  *
10828
10828
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerGlobalScope/location)
10829
10829
  */
10830
10830
  readonly location: WorkerLocation;
10831
10831
  /**
10832
- * The **`navigator`** read-only property of the WorkerGlobalScope interface returns the WorkerNavigator associated with the worker.
10832
+ * The **`navigator`** read-only property of the WorkerGlobalScope interface returns the WorkerNavigator associated with the worker. It is a specific navigator object, mostly a subset of the Navigator for browsing scopes, but adapted to workers.
10833
10833
  *
10834
10834
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerGlobalScope/navigator)
10835
10835
  */
@@ -10847,7 +10847,7 @@ interface WorkerGlobalScope extends EventTarget, FontFaceSource, WindowOrWorkerG
10847
10847
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerGlobalScope/unhandledrejection_event) */
10848
10848
  onunhandledrejection: ((this: WorkerGlobalScope, ev: PromiseRejectionEvent) => any) | null;
10849
10849
  /**
10850
- * The **`self`** read-only property of the WorkerGlobalScope interface returns a reference to the `WorkerGlobalScope` itself.
10850
+ * The **`self`** read-only property of the WorkerGlobalScope interface returns a reference to the WorkerGlobalScope itself. Most of the time it is a specific scope like DedicatedWorkerGlobalScope, SharedWorkerGlobalScope, or ServiceWorkerGlobalScope.
10851
10851
  *
10852
10852
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerGlobalScope/self)
10853
10853
  */
@@ -10870,25 +10870,25 @@ declare var WorkerGlobalScope: {
10870
10870
  };
10871
10871
 
10872
10872
  /**
10873
- * The **`WorkerLocation`** interface defines the absolute location of the script executed by the Worker.
10873
+ * The **`WorkerLocation`** interface defines the absolute location of the script executed by the Worker. Such an object is initialized for each worker and is available via the WorkerGlobalScope.location property obtained by calling self.location.
10874
10874
  *
10875
10875
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerLocation)
10876
10876
  */
10877
10877
  interface WorkerLocation {
10878
10878
  /**
10879
- * The **`hash`** property of a WorkerLocation object returns the URL.hash part of the worker's location.
10879
+ * The **`hash`** property of a WorkerLocation object returns the hash part of the worker's location.
10880
10880
  *
10881
10881
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerLocation/hash)
10882
10882
  */
10883
10883
  readonly hash: string;
10884
10884
  /**
10885
- * The **`host`** property of a WorkerLocation object returns the URL.host part of the worker's location.
10885
+ * The **`host`** property of a WorkerLocation object returns the host part of the worker's location.
10886
10886
  *
10887
10887
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerLocation/host)
10888
10888
  */
10889
10889
  readonly host: string;
10890
10890
  /**
10891
- * The **`hostname`** property of a WorkerLocation object returns the URL.hostname part of the worker's location.
10891
+ * The **`hostname`** property of a WorkerLocation object returns the hostname part of the worker's location.
10892
10892
  *
10893
10893
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerLocation/hostname)
10894
10894
  */
@@ -10901,31 +10901,31 @@ interface WorkerLocation {
10901
10901
  readonly href: string;
10902
10902
  toString(): string;
10903
10903
  /**
10904
- * The **`origin`** property of a WorkerLocation object returns the worker's URL.origin.
10904
+ * The **`origin`** property of a WorkerLocation object returns the worker's origin.
10905
10905
  *
10906
10906
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerLocation/origin)
10907
10907
  */
10908
10908
  readonly origin: string;
10909
10909
  /**
10910
- * The **`pathname`** property of a WorkerLocation object returns the URL.pathname part of the worker's location.
10910
+ * The **`pathname`** property of a WorkerLocation object returns the pathname part of the worker's location.
10911
10911
  *
10912
10912
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerLocation/pathname)
10913
10913
  */
10914
10914
  readonly pathname: string;
10915
10915
  /**
10916
- * The **`port`** property of a WorkerLocation object returns the URL.port part of the worker's location.
10916
+ * The **`port`** property of a WorkerLocation object returns the port part of the worker's location.
10917
10917
  *
10918
10918
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerLocation/port)
10919
10919
  */
10920
10920
  readonly port: string;
10921
10921
  /**
10922
- * The **`protocol`** property of a WorkerLocation object returns the URL.protocol part of the worker's location.
10922
+ * The **`protocol`** property of a WorkerLocation object returns the protocol part of the worker's location.
10923
10923
  *
10924
10924
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerLocation/protocol)
10925
10925
  */
10926
10926
  readonly protocol: string;
10927
10927
  /**
10928
- * The **`search`** property of a WorkerLocation object returns the URL.search part of the worker's location.
10928
+ * The **`search`** property of a WorkerLocation object returns the search part of the worker's location.
10929
10929
  *
10930
10930
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerLocation/search)
10931
10931
  */
@@ -10938,7 +10938,7 @@ declare var WorkerLocation: {
10938
10938
  };
10939
10939
 
10940
10940
  /**
10941
- * The **`WorkerNavigator`** interface represents a subset of the Navigator interface allowed to be accessed from a Worker.
10941
+ * The **`WorkerNavigator`** interface represents a subset of the Navigator interface allowed to be accessed from a Worker. Such an object is initialized for each worker and is available via the self.navigator property.
10942
10942
  *
10943
10943
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerNavigator)
10944
10944
  */
@@ -10970,13 +10970,13 @@ declare var WorkerNavigator: {
10970
10970
  };
10971
10971
 
10972
10972
  /**
10973
- * The **`WritableStream`** interface of the Streams API provides a standard abstraction for writing streaming data to a destination, known as a sink.
10973
+ * The **`WritableStream`** interface of the Streams API provides a standard abstraction for writing streaming data to a destination, known as a sink. This object comes with built-in backpressure and queuing.
10974
10974
  *
10975
10975
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream)
10976
10976
  */
10977
10977
  interface WritableStream<W = any> {
10978
10978
  /**
10979
- * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the `WritableStream` is locked to a writer.
10979
+ * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the WritableStream is locked to a writer.
10980
10980
  *
10981
10981
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/locked)
10982
10982
  */
@@ -10988,13 +10988,13 @@ interface WritableStream<W = any> {
10988
10988
  */
10989
10989
  abort(reason?: any): Promise<void>;
10990
10990
  /**
10991
- * The **`close()`** method of the WritableStream interface closes the associated stream.
10991
+ * The **`close()`** method of the WritableStream interface closes the associated stream. All chunks written before this method is called are sent before the returned promise is fulfilled.
10992
10992
  *
10993
10993
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/close)
10994
10994
  */
10995
10995
  close(): Promise<void>;
10996
10996
  /**
10997
- * The **`getWriter()`** method of the WritableStream interface returns a new instance of WritableStreamDefaultWriter and locks the stream to that instance.
10997
+ * The **`getWriter()`** method of the WritableStream interface returns a new instance of WritableStreamDefaultWriter and locks the stream to that instance. While the stream is locked, no other writer can be acquired until this one is released.
10998
10998
  *
10999
10999
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/getWriter)
11000
11000
  */
@@ -11007,7 +11007,7 @@ declare var WritableStream: {
11007
11007
  };
11008
11008
 
11009
11009
  /**
11010
- * The **`WritableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a WritableStream's state.
11010
+ * The **`WritableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a WritableStream's state. When constructing a WritableStream, the underlying sink is given a corresponding WritableStreamDefaultController instance to manipulate.
11011
11011
  *
11012
11012
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController)
11013
11013
  */
@@ -11032,7 +11032,7 @@ declare var WritableStreamDefaultController: {
11032
11032
  };
11033
11033
 
11034
11034
  /**
11035
- * The **`WritableStreamDefaultWriter`** interface of the Streams API is the object returned by WritableStream.getWriter() and once created locks the writer to the `WritableStream` ensuring that no other streams can write to the underlying sink.
11035
+ * The **`WritableStreamDefaultWriter`** interface of the Streams API is the object returned by WritableStream.getWriter() and once created locks the writer to the WritableStream ensuring that no other streams can write to the underlying sink.
11036
11036
  *
11037
11037
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter)
11038
11038
  */
@@ -11068,7 +11068,7 @@ interface WritableStreamDefaultWriter<W = any> {
11068
11068
  */
11069
11069
  close(): Promise<void>;
11070
11070
  /**
11071
- * The **`releaseLock()`** method of the WritableStreamDefaultWriter interface releases the writer's lock on the corresponding stream.
11071
+ * The **`releaseLock()`** method of the WritableStreamDefaultWriter interface releases the writer's lock on the corresponding stream. After the lock is released, the writer is no longer active. If the associated stream is errored when the lock is released, the writer will appear errored in the same way from now on; otherwise, the writer will appear closed.
11072
11072
  *
11073
11073
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/releaseLock)
11074
11074
  */
@@ -11103,19 +11103,19 @@ declare namespace WebAssembly {
11103
11103
  */
11104
11104
  interface Exception {
11105
11105
  /**
11106
- * The read-only **`stack`** property of an object instance of type `WebAssembly.Exception` _may_ contain a stack trace.
11106
+ * The read-only **`stack`** property of an object instance of type WebAssembly.Exception may contain a stack trace.
11107
11107
  *
11108
11108
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/stack)
11109
11109
  */
11110
11110
  readonly stack: string | undefined;
11111
11111
  /**
11112
- * The **`getArg()`** prototype method of the `Exception` object can be used to get the value of a specified item in the exception's data arguments.
11112
+ * The **`getArg()`** prototype method of the Exception object can be used to get the value of a specified item in the exception's data arguments.
11113
11113
  *
11114
11114
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/getArg)
11115
11115
  */
11116
11116
  getArg(index: number): any;
11117
11117
  /**
11118
- * The **`is()`** prototype method of the `Exception` object can be used to test if the `Exception` matches a given tag.
11118
+ * The **`is()`** prototype method of the Exception object can be used to test if the Exception matches a given tag.
11119
11119
  *
11120
11120
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/is)
11121
11121
  */
@@ -11128,7 +11128,7 @@ declare namespace WebAssembly {
11128
11128
  };
11129
11129
 
11130
11130
  /**
11131
- * A **`WebAssembly.Global`** object represents a global variable instance, accessible from both JavaScript and importable/exportable across one or more `WebAssembly.Module` instances.
11131
+ * A **`WebAssembly.Global`** object represents a global variable instance, accessible from both JavaScript and importable/exportable across one or more WebAssembly.Module instances. This allows dynamic linking of multiple modules.
11132
11132
  *
11133
11133
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Global)
11134
11134
  */
@@ -11143,13 +11143,13 @@ declare namespace WebAssembly {
11143
11143
  };
11144
11144
 
11145
11145
  /**
11146
- * A **`WebAssembly.Instance`** object is a stateful, executable instance of a `WebAssembly.Module`.
11146
+ * A **`WebAssembly.Instance`** object is a stateful, executable instance of a WebAssembly.Module. Instance objects contain all the Exported WebAssembly functions that allow calling into WebAssembly code from JavaScript.
11147
11147
  *
11148
11148
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Instance)
11149
11149
  */
11150
11150
  interface Instance {
11151
11151
  /**
11152
- * The **`exports`** read-only property of the `WebAssembly.Instance` object prototype returns an object containing as its members all the functions exported from the WebAssembly module instance, to allow them to be accessed and used by JavaScript.
11152
+ * The **`exports`** read-only property of the WebAssembly.Instance object prototype returns an object containing as its members all the functions exported from the WebAssembly module instance, to allow them to be accessed and used by JavaScript.
11153
11153
  *
11154
11154
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Instance/exports)
11155
11155
  */
@@ -11171,19 +11171,19 @@ declare namespace WebAssembly {
11171
11171
  };
11172
11172
 
11173
11173
  /**
11174
- * The **`WebAssembly.Memory`** object is a resizable ArrayBuffer or SharedArrayBuffer that holds raw bytes of memory accessed by a `WebAssembly.Instance`.
11174
+ * The **`WebAssembly.Memory`** object is a resizable ArrayBuffer or SharedArrayBuffer that holds raw bytes of memory accessed by a WebAssembly.Instance.
11175
11175
  *
11176
11176
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory)
11177
11177
  */
11178
11178
  interface Memory {
11179
11179
  /**
11180
- * The read-only **`buffer`** prototype property of the `WebAssembly.Memory` object returns the buffer contained in the memory.
11180
+ * The read-only **`buffer`** prototype property of the WebAssembly.Memory object returns the buffer contained in the memory. Depending on whether or not the memory was constructed with shared: true, the buffer is either an ArrayBuffer or a SharedArrayBuffer.
11181
11181
  *
11182
11182
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory/buffer)
11183
11183
  */
11184
11184
  readonly buffer: ArrayBuffer;
11185
11185
  /**
11186
- * The **`grow()`** prototype method of the `WebAssembly.Memory` object increases the size of the memory instance by a specified number of WebAssembly pages.
11186
+ * The **`grow()`** prototype method of the WebAssembly.Memory object increases the size of the memory instance by a specified number of WebAssembly pages.
11187
11187
  *
11188
11188
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory/grow)
11189
11189
  */
@@ -11207,19 +11207,19 @@ declare namespace WebAssembly {
11207
11207
  prototype: Module;
11208
11208
  new(bytes: BufferSource, options?: WebAssemblyCompileOptions): Module;
11209
11209
  /**
11210
- * The **`WebAssembly.Module.customSections()`** static method returns a copy of the contents of all custom sections in the given module with the given string name.
11210
+ * The WebAssembly.**`Module.customSections()`** static method returns a copy of the contents of all custom sections in the given module with the given string name.
11211
11211
  *
11212
11212
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/customSections_static)
11213
11213
  */
11214
11214
  customSections(moduleObject: Module, sectionName: string): ArrayBuffer[];
11215
11215
  /**
11216
- * The **`WebAssembly.Module.exports()`** static method returns an array containing descriptions of all the declared exports of the given `Module`.
11216
+ * The WebAssembly.**`Module.exports()`** static method returns an array containing descriptions of all the declared exports of the given Module.
11217
11217
  *
11218
11218
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/exports_static)
11219
11219
  */
11220
11220
  exports(moduleObject: Module): ModuleExportDescriptor[];
11221
11221
  /**
11222
- * The **`WebAssembly.Module.imports()`** static method returns an array containing descriptions of all the declared imports of the given `Module`.
11222
+ * The WebAssembly.**`Module.imports()`** static method returns an array containing descriptions of all the declared imports of the given Module.
11223
11223
  *
11224
11224
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/imports_static)
11225
11225
  */
@@ -11236,31 +11236,31 @@ declare namespace WebAssembly {
11236
11236
  };
11237
11237
 
11238
11238
  /**
11239
- * The **`WebAssembly.Table`** object is a JavaScript wrapper object — an array-like structure representing a WebAssembly table, which stores homogeneous references.
11239
+ * The **`WebAssembly.Table`** object is a JavaScript wrapper object — an array-like structure representing a WebAssembly table, which stores homogeneous references. A table created by JavaScript or in WebAssembly code will be accessible and mutable from both JavaScript and WebAssembly.
11240
11240
  *
11241
11241
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table)
11242
11242
  */
11243
11243
  interface Table {
11244
11244
  /**
11245
- * The read-only **`length`** prototype property of the `WebAssembly.Table` object returns the length of the table, i.e., the number of elements in the table.
11245
+ * The read-only **`length`** prototype property of the WebAssembly.Table object returns the length of the table, i.e., the number of elements in the table.
11246
11246
  *
11247
11247
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/length)
11248
11248
  */
11249
11249
  readonly length: AddressValue;
11250
11250
  /**
11251
- * The **`get()`** prototype method of the `WebAssembly.Table()` object retrieves the element stored at a given index.
11251
+ * The **`get()`** prototype method of the WebAssembly.Table() object retrieves the element stored at a given index.
11252
11252
  *
11253
11253
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/get)
11254
11254
  */
11255
11255
  get(index: AddressValue): any;
11256
11256
  /**
11257
- * The **`grow()`** prototype method of the `WebAssembly.Table` object increases the size of the `Table` instance by a specified number of elements, filled with the provided value.
11257
+ * The **`grow()`** prototype method of the WebAssembly.Table object increases the size of the Table instance by a specified number of elements, filled with the provided value.
11258
11258
  *
11259
11259
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/grow)
11260
11260
  */
11261
11261
  grow(delta: AddressValue, value?: any): AddressValue;
11262
11262
  /**
11263
- * The **`set()`** prototype method of the `WebAssembly.Table` object mutates a reference stored at a given index to a different value.
11263
+ * The **`set()`** prototype method of the WebAssembly.Table object mutates a reference stored at a given index to a different value.
11264
11264
  *
11265
11265
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/set)
11266
11266
  */
@@ -11273,7 +11273,7 @@ declare namespace WebAssembly {
11273
11273
  };
11274
11274
 
11275
11275
  /**
11276
- * The **`WebAssembly.Tag`** object defines a _type_ of a WebAssembly exception that can be thrown to/from WebAssembly code.
11276
+ * The **`WebAssembly.Tag`** object defines a type of a WebAssembly exception that can be thrown to/from WebAssembly code.
11277
11277
  *
11278
11278
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Tag)
11279
11279
  */
@@ -11375,7 +11375,7 @@ declare namespace WebAssembly {
11375
11375
  */
11376
11376
  interface Console {
11377
11377
  /**
11378
- * The **`console.assert()`** static method writes an error message to the console if the assertion is false.
11378
+ * The **`console.assert()`** static method writes an error message to the console if the assertion is false. If the assertion is true, nothing happens.
11379
11379
  *
11380
11380
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/assert_static)
11381
11381
  */
@@ -11387,61 +11387,61 @@ interface Console {
11387
11387
  */
11388
11388
  clear(): void;
11389
11389
  /**
11390
- * The **`console.count()`** static method logs the number of times that this particular call to `count()` has been called.
11390
+ * The **`console.count()`** static method logs the number of times that this particular call to count() has been called.
11391
11391
  *
11392
11392
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/count_static)
11393
11393
  */
11394
11394
  count(label?: string): void;
11395
11395
  /**
11396
- * The **`console.countReset()`** static method resets counter used with console/count_static.
11396
+ * The **`console.countReset()`** static method resets counter used with console.count().
11397
11397
  *
11398
11398
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/countReset_static)
11399
11399
  */
11400
11400
  countReset(label?: string): void;
11401
11401
  /**
11402
- * The **`console.debug()`** static method outputs a message to the console at the 'debug' log level.
11402
+ * The **`console.debug()`** static method outputs a message to the console at the "debug" log level. The message is only displayed to the user if the console is configured to display debug output. In most cases, the log level is configured within the console UI. This log level might correspond to the Debug or Verbose log level.
11403
11403
  *
11404
11404
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/debug_static)
11405
11405
  */
11406
11406
  debug(...data: any[]): void;
11407
11407
  /**
11408
- * The **`console.dir()`** static method displays a list of the properties of the specified JavaScript object.
11408
+ * The **`console.dir()`** static method displays a list of the properties of the specified JavaScript object. In browser consoles, the output is presented as a hierarchical listing with disclosure triangles that let you see the contents of child objects.
11409
11409
  *
11410
11410
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dir_static)
11411
11411
  */
11412
11412
  dir(item?: any, options?: any): void;
11413
11413
  /**
11414
- * The **`console.dirxml()`** static method displays an interactive tree of the descendant elements of the specified XML/HTML element.
11414
+ * The **`console.dirxml()`** static method displays an interactive tree of the descendant elements of the specified XML/HTML element. If it is not possible to display as an element the JavaScript Object view is shown instead. The output is presented as a hierarchical listing of expandable nodes that let you see the contents of child nodes.
11415
11415
  *
11416
11416
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dirxml_static)
11417
11417
  */
11418
11418
  dirxml(...data: any[]): void;
11419
11419
  /**
11420
- * The **`console.error()`** static method outputs a message to the console at the 'error' log level.
11420
+ * The **`console.error()`** static method outputs a message to the console at the "error" log level. The message is only displayed to the user if the console is configured to display error output. In most cases, the log level is configured within the console UI. The message may be formatted as an error, with red colors and call stack information.
11421
11421
  *
11422
11422
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/error_static)
11423
11423
  */
11424
11424
  error(...data: any[]): void;
11425
11425
  /**
11426
- * The **`console.group()`** static method creates a new inline group in the Web console log, causing any subsequent console messages to be indented by an additional level, until console/groupEnd_static is called.
11426
+ * The **`console.group()`** static method creates a new inline group in the Web console log, causing any subsequent console messages to be indented by an additional level, until console.groupEnd() is called.
11427
11427
  *
11428
11428
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/group_static)
11429
11429
  */
11430
11430
  group(...data: any[]): void;
11431
11431
  /**
11432
- * The **`console.groupCollapsed()`** static method creates a new inline group in the console.
11432
+ * The **`console.groupCollapsed()`** static method creates a new inline group in the console. Unlike console.group(), however, the new group is created collapsed. The user will need to use the disclosure button next to it to expand it, revealing the entries created in the group.
11433
11433
  *
11434
11434
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupCollapsed_static)
11435
11435
  */
11436
11436
  groupCollapsed(...data: any[]): void;
11437
11437
  /**
11438
- * The **`console.groupEnd()`** static method exits the current inline group in the console.
11438
+ * The **`console.groupEnd()`** static method exits the current inline group in the console. See Using groups in the console in the console documentation for details and examples.
11439
11439
  *
11440
11440
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupEnd_static)
11441
11441
  */
11442
11442
  groupEnd(): void;
11443
11443
  /**
11444
- * The **`console.info()`** static method outputs a message to the console at the 'info' log level.
11444
+ * The **`console.info()`** static method outputs a message to the console at the "info" log level. The message is only displayed to the user if the console is configured to display info output. In most cases, the log level is configured within the console UI. The message may receive special formatting, such as a small "i" icon next to it.
11445
11445
  *
11446
11446
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/info_static)
11447
11447
  */
@@ -11459,19 +11459,19 @@ interface Console {
11459
11459
  */
11460
11460
  table(tabularData?: any, properties?: string[]): void;
11461
11461
  /**
11462
- * The **`console.time()`** static method starts a timer you can use to track how long an operation takes.
11462
+ * The **`console.time()`** static method starts a timer you can use to track how long an operation takes. You give each timer a unique name, and may have up to 10,000 timers running on a given page. When you call console.timeEnd() with the same name, the browser will output the time, in milliseconds, that elapsed since the timer was started.
11463
11463
  *
11464
11464
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/time_static)
11465
11465
  */
11466
11466
  time(label?: string): void;
11467
11467
  /**
11468
- * The **`console.timeEnd()`** static method stops a timer that was previously started by calling console/time_static.
11468
+ * The **`console.timeEnd()`** static method stops a timer that was previously started by calling console.time().
11469
11469
  *
11470
11470
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeEnd_static)
11471
11471
  */
11472
11472
  timeEnd(label?: string): void;
11473
11473
  /**
11474
- * The **`console.timeLog()`** static method logs the current value of a timer that was previously started by calling console/time_static.
11474
+ * The **`console.timeLog()`** static method logs the current value of a timer that was previously started by calling console.time().
11475
11475
  *
11476
11476
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeLog_static)
11477
11477
  */
@@ -11484,7 +11484,7 @@ interface Console {
11484
11484
  */
11485
11485
  trace(...data: any[]): void;
11486
11486
  /**
11487
- * The **`console.warn()`** static method outputs a warning message to the console at the 'warning' log level.
11487
+ * The **`console.warn()`** static method outputs a warning message to the console at the "warning" log level. The message is only displayed to the user if the console is configured to display warning output. In most cases, the log level is configured within the console UI. The message may receive special formatting, such as yellow colors and a warning icon.
11488
11488
  *
11489
11489
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/warn_static)
11490
11490
  */
@@ -11562,7 +11562,7 @@ interface VoidFunction {
11562
11562
  }
11563
11563
 
11564
11564
  /**
11565
- * The **`clients`** read-only property of the ServiceWorkerGlobalScope interface returns the `Clients` object associated with the service worker.
11565
+ * The **`clients`** read-only property of the ServiceWorkerGlobalScope interface returns the Clients object associated with the service worker.
11566
11566
  *
11567
11567
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerGlobalScope/clients)
11568
11568
  */
@@ -11612,19 +11612,19 @@ declare var serviceWorker: ServiceWorker;
11612
11612
  */
11613
11613
  declare function skipWaiting(): Promise<void>;
11614
11614
  /**
11615
- * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.
11615
+ * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order. The normal event processing rules (including the capturing and optional bubbling phase) also apply to events dispatched manually with dispatchEvent().
11616
11616
  *
11617
11617
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)
11618
11618
  */
11619
11619
  declare function dispatchEvent(event: Event): boolean;
11620
11620
  /**
11621
- * The **`location`** read-only property of the WorkerGlobalScope interface returns the WorkerLocation associated with the worker.
11621
+ * The **`location`** read-only property of the WorkerGlobalScope interface returns the WorkerLocation associated with the worker. It is a specific location object, mostly a subset of the Location for browsing scopes, but adapted to workers.
11622
11622
  *
11623
11623
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerGlobalScope/location)
11624
11624
  */
11625
11625
  declare var location: WorkerLocation;
11626
11626
  /**
11627
- * The **`navigator`** read-only property of the WorkerGlobalScope interface returns the WorkerNavigator associated with the worker.
11627
+ * The **`navigator`** read-only property of the WorkerGlobalScope interface returns the WorkerNavigator associated with the worker. It is a specific navigator object, mostly a subset of the Navigator for browsing scopes, but adapted to workers.
11628
11628
  *
11629
11629
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerGlobalScope/navigator)
11630
11630
  */
@@ -11642,7 +11642,7 @@ declare var onrejectionhandled: ((this: ServiceWorkerGlobalScope, ev: PromiseRej
11642
11642
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerGlobalScope/unhandledrejection_event) */
11643
11643
  declare var onunhandledrejection: ((this: ServiceWorkerGlobalScope, ev: PromiseRejectionEvent) => any) | null;
11644
11644
  /**
11645
- * The **`self`** read-only property of the WorkerGlobalScope interface returns a reference to the `WorkerGlobalScope` itself.
11645
+ * The **`self`** read-only property of the WorkerGlobalScope interface returns a reference to the WorkerGlobalScope itself. Most of the time it is a specific scope like DedicatedWorkerGlobalScope, SharedWorkerGlobalScope, or ServiceWorkerGlobalScope.
11646
11646
  *
11647
11647
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkerGlobalScope/self)
11648
11648
  */
@@ -11654,7 +11654,7 @@ declare var self: WorkerGlobalScope & typeof globalThis;
11654
11654
  */
11655
11655
  declare function importScripts(...urls: (string | URL)[]): void;
11656
11656
  /**
11657
- * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.
11657
+ * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order. The normal event processing rules (including the capturing and optional bubbling phase) also apply to events dispatched manually with dispatchEvent().
11658
11658
  *
11659
11659
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)
11660
11660
  */