Revision 1026322 of Bluetooth.requestDevice()

<p>{{APIRef()}}{{SeeCompatTable}}</p>

<p>The <strong><code>Bluetooth.requestDevice()</code></strong> method of the {{domxref("Bluetooth")}} interface returns&nbsp;a {{jsxref("Promise")}}&nbsp;to&nbsp;a {{domxref("BluetoothDevice")}}&nbsp;object with the specified options. If there is no chooser UI, this method returns the first device matching the criteria.</p>

<h2 id="Syntax">Syntax</h2>

<pre class="syntaxbox">
Bluetooth.requestDevice(options).then(function(bluetoothDevice) { ... })</pre>

<h3 id="Returns">Returns</h3>

<p>A {{jsxref("Promise")}}&nbsp;to&nbsp;a {{domxref("BluetoothDevice")}}&nbsp;object.</p>

<h3 id="Parameters">Parameters</h3>

<dl>
 <dt>options&nbsp;</dt>
 <dd>An object that sets&nbsp;options for the device request.&nbsp;The available options are:
 <ul>
  <li><code>filters[]</code>: An array of <code>BluetoothScanFilters</code>. This filter consists of an array of&nbsp; <code>BluetoothServiceUUID</code>s, a <code>name</code> parameter, and a <code>namePrefix</code> parameter.</li>
  <li><code>optionalServices[]</code>: An array of <code>BluetoothServiceUUID</code>s.</li>
 </ul>
 </dd>
</dl>

<h2 id="Example">Example</h2>

<pre class="brush: js">
navigator.bluetooth.requestDevice(options).then(function(device) {
&nbsp; console.log('Name: ' + device.name);
&nbsp; // Do something with the device.
})
.catch(function(error) {
&nbsp; console.log("Something went wrong. " + error);
});
</pre>

<h2 id="Specifications">Specifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('Web Bluetooth', '#dom-bluetooth-requestdevice', 'requestDevice()')}}</td>
   <td>{{Spec2('Web Bluetooth')}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility">Browser compatibility</h2>

<div>{{CompatibilityTable}}</div>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatChrome (45.0)}} [1]</td>
   <td>&nbsp;</td>
   <td>&nbsp;</td>
   <td>&nbsp;</td>
   <td>&nbsp;</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Android Webview</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>Firefox OS</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
   <th>Chrome for Android</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>&nbsp;</td>
   <td>&nbsp;</td>
   <td>&nbsp;</td>
   <td>&nbsp;</td>
   <td>&nbsp;</td>
   <td>{{CompatChrome (48.0)}} [2]</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] Behind a flag. Chrome OS only.</p>

<p>[2] Behind a flag. Requires&nbsp;Android 6 (Marshmallow).</p>