@@ -751,10 +751,9 @@ <h2>
751751 geographic position</ span > . What constitutes a significant
752752 change of geographic position is left to the
753753 implementation. User agents MAY impose a rate limit on how
754- frequently position changes are reported.
755- < ins cite ="#a4 "> User agents MUST consider
756- invoking [=set emulated position data=] as a significant
757- change.</ ins >
754+ frequently position changes are reported. < ins cite =
755+ "#a4 "> User agents MUST consider invoking [=set emulated
756+ position data=] as a significant change.</ ins >
758757 </ li >
759758 < li > If |document| is not [=Document/fully active=] or
760759 [=Document/visibility state=] is not "visible", go back to
@@ -827,36 +826,38 @@ <h2>
827826 < li > If |permission| is "granted":
828827 < ol >
829828 < li >
830- < ins cite ="#a4 "> Check if an emulated position should be used by running
831- the following steps:
832- < ol >
833- < li > Let |emulatedPositionData| be [=get emulated position data=]
834- passing [=this=].
835- </ li >
836- < li > If |emulatedPositionData| is not null:
837- < ol >
838- < li > If |emulatedPositionData| is a {{GeolocationPositionError}}:
839- < ol >
840- < li > [=Call back with error=] passing |errorCallback| and
841- |emulatedPositionData|.{{GeolocationPositionError/code}}.
842- </ li >
843- < li > Terminate this algorithm.</ li >
844- </ ol >
845- </ li >
846- < li > Let |position| be [=a new `GeolocationPosition`=]
847- passing |emulatedPositionData|, |acquisitionTime| and
848- |options|.{{PositionOptions/enableHighAccuracy}}.
849- </ li >
850- < li > [=Queue a task=] on the [=geolocation task source=] with
851- a step that [=invokes=] |successCallback| with
852- « |position| » and "`report`".
853- </ li >
854- < li > Terminate this algorithm.
855- </ li >
856- </ ol >
857- </ li >
858- </ ol >
859- </ ins >
829+ < ins cite ="#a4 "> Check if an emulated position should be
830+ used by running the following steps:
831+ < ol >
832+ < li > Let |emulatedPositionData| be [=get emulated position
833+ data=] passing [=this=].
834+ </ li >
835+ < li > If |emulatedPositionData| is not null:
836+ < ol >
837+ < li > If |emulatedPositionData| is a
838+ {{GeolocationPositionError}}:
839+ < ol >
840+ < li > [=Call back with error=] passing
841+ |errorCallback| and
842+ |emulatedPositionData|.{{GeolocationPositionError/code}}.
843+ </ li >
844+ < li > Terminate this algorithm.
845+ </ li >
846+ </ ol >
847+ </ li >
848+ < li > Let |position| be [=a new `GeolocationPosition`=]
849+ passing |emulatedPositionData|, |acquisitionTime| and
850+ |options|.{{PositionOptions/enableHighAccuracy}}.
851+ </ li >
852+ < li > [=Queue a task=] on the [=geolocation task
853+ source=] with a step that [=invokes=]
854+ |successCallback| with « |position| » and "`report`".
855+ </ li >
856+ < li > Terminate this algorithm.
857+ </ li >
858+ </ ol >
859+ </ li >
860+ </ ol > </ ins >
860861 </ li >
861862 < li > Let |position| be null.
862863 </ li >
884885 < ol >
885886 < li > [=Queue a task=] on the [=geolocation task
886887 source=] with a step that [=invokes=]
887- |successCallback| with « |cachedPosition| » and "`report`".
888+ |successCallback| with « |cachedPosition| » and
889+ "`report`".
888890 </ li >
889891 < li > Terminate this algorithm.
890892 </ li >
@@ -1507,65 +1509,65 @@ <h2>
15071509 feature/default allowlist=] is [=default allowlist/'self'=].
15081510 </ p >
15091511 </ section >
1510- < section data-cite ="html ">
1511- < h2 >
1512- Emulation
1513- </ h2 >
1514- < aside class ="addition " id ="a4 ">
1515- < span class ="marker "> Candidate Addition:</ span > Introduce emulated
1516- position data to enable user-agent automation.
1517- </ aside > < ins cite ="#a4 ">
1518- < p >
1519- For the purposes of user-agent automation and application testing, this
1520- document defines geolocation emulations.
1521- </ p >
1522- < p >
1523- Each [=top-level traversable=] has an associated
1524- < dfn > emulated position data</ dfn > , which is data representing
1525- {{GeolocationCoordinates}}, {{ GeolocationPositionError}} or null,
1526- initially null.
1527- </ p >
1528- < p >
1529- To < dfn class =" export " > set emulated position data </ dfn > , given
1530- [=navigable=] |navigable| and an |emulatedPositionData|:
1531- </ p >
1532- < ol class =" algorithm " >
1533- < li > Assert |emulatedPositionData| is either null, a
1534- {{GeolocationCoordinates}}, or a {{GeolocationPositionError}}.
1535- </ li >
1536- < li > Let |traversable| be |navigable|’s [=navigable/top-level traversable=].
1537- </ li >
1538- < li > If |traversable| is not null:
1539- < ol class ="algorithm ">
1540- < li > Set |traversable|'s associated [=emulated position data=] to
1541- |emulatedPositionData|.
1542- </ li >
1543- < li > User agents MUST consider this as a "significant change" in the
1544- < a href ="#wait-for-change "> wait for a significant change of
1545- geographic position</ a > step.
1546- </ li >
1547- </ ol >
1548- </ li >
1549- </ ol >
1550- < p >
1551- To < dfn > get emulated position data</ dfn > , given {{Geolocation}}
1552- |geolocation|:
1553- </ p >
1554- < ol class ="algorithm ">
1555- < li > Let |navigable| be |geolocation|'s [=relevant global object=]'s
1556- [=associated `Document`=]'s [=node navigable=].
1557- </ li >
1558- < li > If |navigable| is null, return null.
1559- </ li >
1560- < li > Let |traversable| be |navigable|’s [=navigable/top-level traversable=].
1561- </ li >
1562- < li > If |traversable| is null, return null.
1563- </ li >
1564- < li > Return |traversable|'s associated [=emulated position data=].
1565- </ li >
1566- </ ol >
1567- </ ins >
1568- </ section >
1512+ < section data-cite ="html ">
1513+ < h2 >
1514+ Emulation
1515+ </ h2 >
1516+ < aside class ="addition " id ="a4 ">
1517+ < span class ="marker "> Candidate Addition:</ span > Introduce emulated
1518+ position data to enable user-agent automation.
1519+ </ aside > < ins cite ="#a4 ">
1520+ < p >
1521+ For the purposes of user-agent automation and application testing, this
1522+ document defines geolocation emulations.
1523+ </ p >
1524+ < p >
1525+ Each [=top-level traversable=] has an associated < dfn > emulated position
1526+ data</ dfn > , which is data representing {{GeolocationCoordinates}},
1527+ {{ GeolocationPositionError}} or null, initially null.
1528+ </ p >
1529+ < p >
1530+ To < dfn class =" export " > set emulated position data </ dfn > , given
1531+ [=navigable=] |navigable| and an |emulatedPositionData|:
1532+ </ p >
1533+ < ol class =" algorithm " >
1534+ < li > Assert |emulatedPositionData| is either null, a
1535+ {{GeolocationCoordinates}}, or a {{GeolocationPositionError}}.
1536+ </ li >
1537+ < li > Let |traversable| be |navigable|’s [=navigable/top-level
1538+ traversable=].
1539+ </ li >
1540+ < li > If |traversable| is not null:
1541+ < ol class ="algorithm ">
1542+ < li > Set |traversable|'s associated [=emulated position data=] to
1543+ |emulatedPositionData|.
1544+ </ li >
1545+ < li > User agents MUST consider this as a "significant change" in the
1546+ < a href ="#wait-for-change "> wait for a significant change of
1547+ geographic position</ a > step.
1548+ </ li >
1549+ </ ol >
1550+ </ li >
1551+ </ ol >
1552+ < p >
1553+ To < dfn > get emulated position data</ dfn > , given {{Geolocation}}
1554+ |geolocation|:
1555+ </ p >
1556+ < ol class ="algorithm ">
1557+ < li > Let |navigable| be |geolocation|'s [=relevant global object=]'s
1558+ [=associated `Document`=]'s [=node navigable=].
1559+ </ li >
1560+ < li > If |navigable| is null, return null.
1561+ </ li >
1562+ < li > Let |traversable| be |navigable|’s [=navigable/top-level
1563+ traversable=].
1564+ </ li >
1565+ < li > If |traversable| is null, return null.
1566+ </ li >
1567+ < li > Return |traversable|'s associated [=emulated position data=].
1568+ </ li >
1569+ </ ol > </ ins >
1570+ </ section >
15691571 < section id ="conformance "> </ section >
15701572 < section id ="idl-index " class ="appendix ">
15711573 <!-- All the Web IDL will magically appear here -->
0 commit comments