getDevices() method, when
invoked and given a {{BluetoothPermissionStorage}} |storage|, MUST return
[=a new promise=] |promise| and run the following steps [=in parallel=]:
-1. If [=this=]'s [=relevant global object=]'s [=associated Document=] is not
- [=allowed to use=] the [=policy-controlled feature=] named
+1. If [=this=]'s [=relevant global object=]'s
+ associated Document is not [=allowed to use=] the
+ [=policy-controlled feature=] named
"[=policy-controlled feature/bluetooth=]", reject |promise| with a
{{SecurityError}} and abort these steps.
1. Let |devices| be a new empty {{Array}}.
@@ -1291,8 +1299,9 @@ all devices can match, a sequence of {{BluetoothServiceUUID}}s,
devices, but for now it only ever returns a single one.
Document is not [=allowed to use=] the
+ [=policy-controlled feature=] named
"[=policy-controlled feature/bluetooth=]", throw a {{SecurityError}} and
abort these steps.
1. Check that the algorithm is triggered
@@ -1825,10 +1834,13 @@ The getAvailability() method,
when invoked, MUST return a new promise |promise| and run the following
steps in parallel:
-1. If [=this=]'s [=relevant global object=]'s [=associated Document=] is not
- [=allowed to use=] the [=policy-controlled feature=] named
- "[=policy-controlled feature/bluetooth=]", queue a task to
- resolve |promise| with `false`, and abort these steps.
+1. Let |global| be the [=relevant global object=] of [=this=].
+1. If [=this=]'s [=relevant global object=]'s associated
+ Document is not [=allowed to use=] the
+ [=policy-controlled feature=] named
+ "[=policy-controlled feature/bluetooth=]", [=queue a global task=] on
+ |global| using the [=Bluetooth task source=] to resolve |promise|
+ with `false`, and abort these steps.
1.
If the user has configured the UA to return a particular answer from this function for the current origin, queue a task to resolve |promise| with the configured answer, and abort @@ -1841,7 +1853,8 @@ steps in parallel: 1. If the UA is running on a system that has a Bluetooth radio queue a task to resolve |promise| with `true` regardless of the powered state of the Bluetooth radio. -1. Otherwise, queue a task to resolve |promise| with `false`. +1. Otherwise, [=queue a global task=] on |global| using the + [=Bluetooth task source=] to resolve |promise| with `false`.
|global|.navigator.bluetooth with its {{ValueEvent/value}}
- attribute initialized to |newAvailability|.
+1. If |oldAvailability| is not the same as |newAvailability|,
+ 1. Let |navigator| be |global|'s associated Navigator.
+ 1. Let |bluetooth| be |navigator|'s associated
+ Bluetooth.
+ 1. [=Fire an event=] named {{availabilitychanged}} using the {{ValueEvent}}
+ interface at |bluetooth| with its {{ValueEvent/value}} attribute
+ initialized to |newAvailability|.
watchAdvertisements(|options|)
method, when invoked, MUST return a new promise |promise| and
run the following steps:
+1. Let |global| be the [=relevant global object=] of [=this=].
1. If |options|.{{AbortSignal|signal}} is present, then perform
the following sub-steps:
1. If |options|.{{AbortSignal|signal}} is
@@ -2171,8 +2189,9 @@ run the following steps:
1. Ensure that the UA is scanning for this device's
advertisements. The UA SHOULD NOT filter out "duplicate"
advertisements for the same device.
- 1. If the UA fails to enable scanning, [=queue a task=] to
- perform the following steps, and abort these steps:
+ 1. If the UA fails to enable scanning, [=queue a global task=] on
+ |global| using the [=Bluetooth task source=] to perform the
+ following steps, and abort these steps:
1. Set this.{{[[watchAdvertisementsState]]}} to
`'not-watching'`.
1. [=Reject=] |promise| with one of the following errors:
@@ -2186,9 +2205,11 @@ run the following steps:
:: {{UnknownError}}
- 1. [=Queue a task=] to perform the following steps, but [=abort
- when=] this.{{[[watchAdvertisementsState]]}}
- becomes `not-watching`:
+ 1. [=Queue a global task=] on |global| using the
+ [=Bluetooth task source=] to perform the following steps, but
+ [=abort when=]
+ this.{{[[watchAdvertisementsState]]}} becomes
+ `not-watching`:
1. Set this.{{[[watchAdvertisementsState]]}} to
`watching`.
1. Set this.{{watchingAdvertisements}} to `true`.
@@ -2227,12 +2248,11 @@ To abort {{BluetoothDevice/watchAdvertisements}} for a
|device| in
- {{Bluetooth}}.{{[[deviceInstanceMap]]}}, perform the
- following steps:
- 1. If |device|.{{[[watchAdvertisementsState]]}} is
+1. [=map/For each=] |device| in
+ |bluetooth|.{{[[deviceInstanceMap]]}}, perform the following steps:
+ 1. If |device|.{{[[watchAdvertisementsState]]}} is
`pending-watch` or `watching`, run [=abort watchAdvertisements=]
with |device|.
@@ -2248,15 +2268,19 @@ aborted.
Document of the
-[=current settings object=]'s [=relevant global object=] changes, it must run
-these steps:
-
-1. Let |document| be the associated Document of
- the [=current settings object=]'s [=relevant global object=].
-1. If |document|'s [=document visibility state|visibility state=]
- is not "visible", then [=abort all active watchAdvertisements=]
- operations.
+state=] of a {{Document}} changes, it must run these steps:
+
+1. Let |document| be the {{Document}} where the
+ [=document visibility state|visibility state=] changed.
+1. Let |global| be |document|'s [=relevant global object=].
+1. [=Queue a global task=] on |global| using the [=Bluetooth task source=] to
+ perform the following steps:
+ 1. Let |navigator| be |global|'s associated Navigator.
+ 1. Let |bluetooth| be |navigator|'s associated
+ Bluetooth.
+ 1. If |document|'s [=document visibility state|visibility state=]
+ is not "visible", then [=abort all active
+ watchAdvertisements=] operations on |bluetooth|.
Document of
-the [=current settings object=]'s [=relevant global object=] is no longer
-[=fully active=], it must run these steps:
-
-1. Run [=abort all active watchAdvertisements=] operations.
+When the user agent determines that a {{Document}} is no longer [=fully
+active=], it must run these steps:
+
+1. Let |document| be the {{Document}} that is no longer [=fully active=].
+1. Let |global| be |document|'s [=relevant global object=].
+1. [=Queue a global task=] on |global| using the [=Bluetooth task source=] to
+ perform the following steps:
+ 1. Let |navigator| be |global|'s associated Navigator.
+ 1. Let |bluetooth| be |navigator|'s associated
+ Bluetooth.
+ 1. Run [=abort all active watchAdvertisements=] operations on |bluetooth|.
connect()
method, when invoked, MUST perform the following steps:
1. Let |promise| be a new promise.
+1. Let |global| be [=this=]'s [=relevant global object=].
1. If this.device.{{[[representedDevice]]}} is `null`, queue a
task to reject |promise| with a {{NetworkError}}, return
|promise|, and abort these steps.
-1. If the UA is currently using the Bluetooth system, it MAY queue a task
- to reject |promise| with a {{NetworkError}}, return |promise|, and
- abort these steps.
+1. If the UA is currently using the Bluetooth system, it MAY [=queue a global
+ task=] on |global| using the [=Bluetooth task source=] to [=reject=]
+ |promise| with a {{NetworkError}}, return |promise|, and abort these steps.
Issue(188): Implementations may be able to avoid this {{NetworkError}},
but for now sites need to serialize their use of this API
@@ -2954,7 +2985,8 @@ method, when invoked, MUST perform the following steps:
platforms where that's possible. This may cause a user-visible
pairing dialog to appear when a connection is created, instead of
when a restricted characteristic is accessed.
- 1. Queue a task to perform the following sub-steps:
+ 1. [=Queue a global task=] on |global| using the [=Bluetooth task source=]
+ to perform the following sub-steps:
1. If |promise| is not in this.{{[[activeAlgorithms]]}},
reject promise with an {{AbortError}},
garbage-collect the connection of
@@ -3355,7 +3387,8 @@ The readValue()
Handle errors as described in .
1. If the previous step returned an error, reject promise
with that error and abort these steps.
- 1. Queue a task to perform the following steps:
+ 1. [=Queue a global task=] on [=this=]'s [=relevant global object=] using
+ the [=Bluetooth task source=] to perform the following steps:
1. If promise is not in
this.service.device.gatt.{{[[activeAlgorithms]]}},
reject promise with a {{NetworkError}} and abort
@@ -3423,7 +3456,8 @@ the UA MUST perform the following steps:
Handle errors as described in .
1. If the previous step returned an error, reject promise
with that error and abort these steps.
- 1. Queue a task to perform the following steps:
+ 1. [=Queue a global task=] on [=this=]'s [=relevant global object=] using
+ the [=Bluetooth task source=] to perform the following steps:
1. If promise is not in
|this|.service.device.gatt.{{[[activeAlgorithms]]}},
reject promise with a {{NetworkError}} and abort
@@ -3562,7 +3596,8 @@ promise promise and run the following steps in parallel:
Descriptors procedures to clear the Notification and
Indication bits in characteristic's Client
Characteristic Configuration descriptor.
-1. Queue a task to resolve promise with `this`.
+1. [=Queue a global task=] on [=this=]'s [=relevant global object=] using the
+ [=Bluetooth task source=] to [=resolve=] |promise| with `this`.
Note: Queuing a task to resolve the promise ensures that no
@@ -3757,7 +3792,8 @@ readValue() method, when invoked, MUST run the following steps:
href="#error-handling">.
1. If the previous step returned an error, reject promise
with that error and abort these steps.
- 1. Queue a task to perform the following steps:
+ 1. [=Queue a global task=] on [=this=]'s [=relevant global object=] using the
+ [=Bluetooth task source=] to perform the following steps:
1. If promise is not in
this.characteristic.service.device.gatt.{{[[activeAlgorithms]]}},
reject promise with a {{NetworkError}} and abort
@@ -3802,7 +3838,8 @@ following steps:
.
1. If the previous step returned an error, reject promise
with that error and abort these steps.
- 1. Queue a task to perform the following steps:
+ 1. [=Queue a global task=] on [=this=]'s [=relevant global object=] using the
+ [=Bluetooth task source=] to perform the following steps:
1. If promise is not in
this.characteristic.service.device.gatt.{{[[activeAlgorithms]]}},
reject promise with a {{NetworkError}} and abort
@@ -3929,8 +3966,8 @@ interface participate in a tree.
When a Bluetooth device device's ATT Bearer is lost
(e.g. because the remote device moved out of range or the user used a platform
feature to disconnect it), for each {{BluetoothDevice}} deviceObj the
-UA MUST queue a task on deviceObj's relevant settings
-object's responsible event loop to perform the following steps:
+UA MUST [=queue a global task=] on |deviceObj|'s [=relevant global object=]
+using the [=Bluetooth task source=] to perform the following steps:
1. If deviceObj.{{BluetoothDevice/[[representedDevice]]}}
is not the same device as device, abort these steps.
@@ -3988,9 +4025,9 @@ When the UA receives a Bluetooth Characteristic Value Notification
or Indication,
it must perform the following steps:
-1. For each bluetoothGlobal in the Characteristic's active
- notification context set, queue a task on the event loop of the
- script settings object of bluetoothGlobal to do the following
+1. For each |bluetoothGlobal| in the Characteristic's [=active notification
+ context set=], [=queue a global task=] on |bluetoothGlobal|'s [=relevant
+ global object=] using the [=Bluetooth task source=] to do the following
sub-steps:
1. Let characteristicObject be the
{{BluetoothRemoteGATTCharacteristic}} in the Bluetooth tree
@@ -4163,9 +4200,10 @@ Changed characteristic, it MUST perform the following steps.
1. Let changedDevices be the set of Bluetooth devices that
contain any Service in removedAttributes,
addedAttributes, and changedServices.
-1. For each {{BluetoothDevice}} deviceObj that is connected to a
- device in changedDevices, queue a task on its relevant
- global object's responsible event loop to do the following steps:
+1. For each {{BluetoothDevice}} |deviceObj| that is connected to a device in
+ |changedDevices|, [=queue a global task=] on |deviceObj|'s [=relevant
+ global object=] using the [=Bluetooth task source=] to do the following
+ steps:
1. For each Service service in
removedAttributes:
1. If deviceObj.{{BluetoothDevice/[[allowedServices]]}}
@@ -4587,6 +4625,14 @@ blocklist.
};
+Each {{Navigator}} has an associated Bluetooth, which is
+a {{Bluetooth}} object. Upon creation of the {{Navigator}} object, its
+associated Bluetooth must be set to a [=new=] {{Bluetooth}}
+object created in the {{Navigator}} object's [=relevant Realm=].
+
+The {{Navigator/bluetooth}} getter steps are to return [=this=]'s associated
+Bluetooth.
+
# Integrations # {#integrations}
## Permissions Policy ## {#permissions-policy}