File: device_collection.js

package info (click to toggle)
chromium 138.0.7204.157-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 6,071,864 kB
  • sloc: cpp: 34,936,859; ansic: 7,176,967; javascript: 4,110,704; python: 1,419,953; asm: 946,768; xml: 739,967; pascal: 187,324; sh: 89,623; perl: 88,663; objc: 79,944; sql: 50,304; cs: 41,786; fortran: 24,137; makefile: 21,806; php: 13,980; tcl: 13,166; yacc: 8,925; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (130 lines) | stat: -rw-r--r-- 3,573 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
// Copyright 2016 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

/**
 * Javascript for DeviceCollection, served from
 *     chrome://bluetooth-internals/.
 */

import {assert} from 'chrome://resources/js/assert.js';

/**
 * Enum of connection status for a device.
 * @enum {number}
 */
export const ConnectionStatus = {
  DISCONNECTED: 0,
  CONNECTING: 1,
  CONNECTED: 2,
};

/**
 * Collection of devices. Extends EventTarget to notify observers when the
 * collection changes.
 */
export class DeviceCollection extends EventTarget {
  /**
   * @param {!Array<!DeviceInfo>} array The starting
   *     collection of devices.
   */
  constructor(array) {
    super();

    /** @private {!Array<!DeviceInfo>} */
    this.array_ = array;

    // Keep track of MAC addresses which were previously found via scan, but
    // are no longer being advertised or nearby. Used to inform isRemoved().
    /** @private {!Object<string, boolean>} */
    this.removedDevices_ = {};
  }

  /** @return {number} */
  get length() {
    return this.array_.length;
  }

  /**
   * @param {number}
   * @return {DeviceInfo}
   */
  item(index) {
    return (index < 0 || index > this.length) ? undefined : this.array_[index];
  }

  /**
   * Finds the Device in the collection with the matching address.
   * @param {string} address
   * @return {number} The index where the device was found.
   */
  getByAddress(address) {
    for (let i = 0; i < this.length; i++) {
      const device = this.array_[i];
      if (address === device.address) {
        return i;
      }
    }
    return -1;
  }

  /**
   * Adds or updates a Device with new DeviceInfo.
   * @param {!DeviceInfo} deviceInfo
   */
  addOrUpdate(deviceInfo) {
    this.removedDevices_[deviceInfo.address] = false;
    const oldDeviceIndex = this.getByAddress(deviceInfo.address);

    if (oldDeviceIndex !== -1) {
      // Update rssi if it's valid
      const oldDeviceInfo = this.array_[oldDeviceIndex];
      const rssi = (deviceInfo.rssi && deviceInfo.rssi.value) ||
          (oldDeviceInfo.rssi && oldDeviceInfo.rssi.value);

      // The rssi property may be null, so it must be re-assigned.
      Object.assign(oldDeviceInfo, deviceInfo);
      oldDeviceInfo.rssi = {value: rssi};
      this.dispatchEvent(new CustomEvent(
          'device-update',
          {bubbles: true, composed: true, detail: oldDeviceIndex}));
    } else {
      this.array_.push(deviceInfo);
      this.dispatchEvent(new CustomEvent('device-added', {
        bubbles: true,
        composed: true,
        detail: {index: this.length - 1, device: deviceInfo},
      }));
    }
  }

  /**
   * Marks the Device as removed.
   * @param {!DeviceInfo} deviceInfo
   */
  remove(deviceInfo) {
    const deviceIndex = this.getByAddress(deviceInfo.address);
    assert(deviceIndex !== -1, 'Device does not exist.');
    this.removedDevices_[deviceInfo.address] = true;
    this.dispatchEvent(new CustomEvent(
        'device-update', {bubbles: true, composed: true, detail: deviceIndex}));
  }

  /**
   * Return true if device was "removed" -- previously found via scan but
   * either no longer advertising or no longer nearby.
   * @param {!DeviceInfo} deviceInfo
   * @return {boolean}
   */
  isRemoved(deviceInfo) {
    return !!this.removedDevices_[deviceInfo.address];
  }

  resetForTest() {
    this.array_ = [];
    this.removedDevices_ = [];

    this.dispatchEvent(new CustomEvent(
        'devices-reset-for-test', {bubbles: true, composed: true}));
  }
}