File: service_worker_hid_delegate_observer.h

package info (click to toggle)
chromium 138.0.7204.183-1~deb12u1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm-proposed-updates
  • size: 6,080,960 kB
  • sloc: cpp: 34,937,079; ansic: 7,176,967; javascript: 4,110,704; python: 1,419,954; asm: 946,768; xml: 739,971; pascal: 187,324; sh: 89,623; perl: 88,663; objc: 79,944; sql: 50,304; cs: 41,786; fortran: 24,137; makefile: 21,811; 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 (113 lines) | stat: -rw-r--r-- 4,638 bytes parent folder | download | duplicates (8)
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
// Copyright 2023 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef CONTENT_BROWSER_SERVICE_WORKER_SERVICE_WORKER_HID_DELEGATE_OBSERVER_H_
#define CONTENT_BROWSER_SERVICE_WORKER_SERVICE_WORKER_HID_DELEGATE_OBSERVER_H_

#include "base/memory/weak_ptr.h"
#include "base/scoped_observation_traits.h"
#include "content/browser/hid/hid_service.h"
#include "content/browser/service_worker/service_worker_device_delegate_observer.h"
#include "content/public/browser/hid_delegate.h"

namespace content {

class ServiceWorkerContextCore;

// ServiceWorkerHidDelegateObserver acts as a broker between the
// content::HidService and content::HidDelegate when the HidService is created
// for a service worker.
// Each ServiceWorkerContextCore has one ServiceWorkerHidDelegateObserver,
// which is used to track all of the ServiceWorkerRegistration objects whose
// script uses the WebHID API.
// Furthermore, when a device event happens, the
// ServiceWorkerHidDelegateObserver's HidDelegate::Observer methods will be
// invoked and deliver the device events to the service worker that has a device
// event handler registered.
// For more information, please see go/usb-hid-extension-access.
class CONTENT_EXPORT ServiceWorkerHidDelegateObserver
    : public ServiceWorkerDeviceDelegateObserver,
      public HidDelegate::Observer {
 public:
  explicit ServiceWorkerHidDelegateObserver(ServiceWorkerContextCore* context);
  ServiceWorkerHidDelegateObserver(const ServiceWorkerHidDelegateObserver&) =
      delete;
  ServiceWorkerHidDelegateObserver& operator=(
      const ServiceWorkerHidDelegateObserver&) = delete;
  ~ServiceWorkerHidDelegateObserver() override;

  // HidDelegate::Observer:
  void OnDeviceAdded(const device::mojom::HidDeviceInfo& device_info) override;
  void OnDeviceRemoved(
      const device::mojom::HidDeviceInfo& device_info) override;
  void OnDeviceChanged(
      const device::mojom::HidDeviceInfo& device_info) override;
  void OnHidManagerConnectionError() override;
  void OnPermissionRevoked(const url::Origin& origin) override;

  // Register the `hid_service` to be the latest HidService for
  // `registraiton_id`.
  void RegisterHidService(int64_t registration_id,
                          base::WeakPtr<HidService> hid_service);

  HidService* GetHidServiceForTesting(int64_t registration_id) {
    return GetHidService(registration_id);
  }

 private:
  using HidServiceCallback = base::OnceCallback<void(HidService*)>;
  using HidServiceDeviceEventCallback =
      base::RepeatingCallback<void(const device::mojom::HidDeviceInfo&,
                                   HidService*)>;

  // ServiceWorkerDeviceDelegateObserver:
  void RegistrationAdded(int64_t registration_id) override;
  void RegistrationRemoved(int64_t registration_id) override;

  // Dispatch the device event to all registered service workers.
  void DispatchHidDeviceEventToWorkers(
      const device::mojom::HidDeviceInfo& device_info,
      HidServiceDeviceEventCallback callback);

  // Run `callback` with `device_info` after the worker of `version` is started.
  void WorkerStarted(device::mojom::HidDeviceInfoPtr device_info,
                     HidServiceDeviceEventCallback callback,
                     scoped_refptr<ServiceWorkerVersion> version,
                     blink::ServiceWorkerStatusCode service_worker_status);

  // Get HidService for the `registration_id`. It can be null if no live
  // HidService for the `registration_id`.
  HidService* GetHidService(int64_t registration_id);

  // The map for registration id to the latest registered HidService.
  base::flat_map<int64_t, base::WeakPtr<HidService>> hid_services_;

  base::ScopedObservation<HidDelegate, ServiceWorkerHidDelegateObserver>
      hid_delegate_observation{this};

  base::WeakPtrFactory<ServiceWorkerHidDelegateObserver> weak_ptr_factory_{
      this};
};

}  // namespace content

namespace base {

template <>
struct ScopedObservationTraits<content::HidDelegate,
                               content::ServiceWorkerHidDelegateObserver> {
  static void AddObserver(content::HidDelegate* source,
                          content::ServiceWorkerHidDelegateObserver* observer) {
    source->AddObserver(observer->GetBrowserContext(), observer);
  }
  static void RemoveObserver(
      content::HidDelegate* source,
      content::ServiceWorkerHidDelegateObserver* observer) {
    source->RemoveObserver(observer->GetBrowserContext(), observer);
  }
};

}  // namespace base

#endif  // CONTENT_BROWSER_SERVICE_WORKER_SERVICE_WORKER_HID_DELEGATE_OBSERVER_H_