Serial.h - mozsearch

Enable keyboard shortcuts

/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */

/* vim:set ts=2 sw=2 sts=2 et cindent: */

/* This Source Code Form is subject to the terms of the Mozilla Public

 * License, v. 2.0. If a copy of the MPL was not distributed with this

 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef mozilla_dom_Serial_h

#define mozilla_dom_Serial_h

#include "mozilla/DOMEventTargetHelper.h"

#include "mozilla/WeakPtr.h"

#include "mozilla/dom/PSerialPortChild.h"

#include "mozilla/dom/SerialPortInfo.h"

#include "mozilla/ipc/Endpoint.h"

#include "nsCOMPtr.h"

#include "nsTArray.h"

namespace mozilla::dom {

class Promise;

class SerialManagerChild;

class SerialPort;

struct SerialPortRequestOptions;

struct SerialPortFilter;

class Serial final : public DOMEventTargetHelper, public SupportsWeakPtr {

 public:

  NS_DECL_ISUPPORTS_INHERITED

  NS_DECL_CYCLE_COLLECTION_CLASS_INHERITED(Serial, DOMEventTargetHelper)

  explicit Serial(nsPIDOMWindowInner* aWindow);

  explicit Serial(nsIGlobalObject* aGlobal);

  JSObject* WrapObject(JSContext* aCx,

                       JS::Handle<JSObject*> aGivenProto) override;

  already_AddRefed<Promise> RequestPort(

      const SerialPortRequestOptions& aOptions, ErrorResult& aRv);

  already_AddRefed<Promise> GetPorts(ErrorResult& aRv);

  IMPL_EVENT_HANDLER(connect)

  IMPL_EVENT_HANDLER(disconnect)

  // Apply filters to a list of ports, removing ports that don't match

  // Returns whether filters were applied successfully. If this function

  // returns false, this means one of the bluetoothServiceClassId's

  // was formatted wrong.

  static bool ApplyPortFilters(nsTArray<IPCSerialPortInfo>& aPorts,

                               const Sequence<SerialPortFilter>& aFilters);

  void Shutdown();

  SerialManagerChild* GetOrCreateManagerChild();

  void DisconnectFromOwner() override;

  MOZ_CAN_RUN_SCRIPT void ForgetAllPorts();

  already_AddRefed<Promise> SimulateDeviceConnection(

      const nsAString& aDeviceId, const nsAString& aDevicePath,

      uint16_t aVendorId, uint16_t aProductId, ErrorResult& aRv);

  already_AddRefed<Promise> SimulateDeviceDisconnection(

      const nsAString& aDeviceId, ErrorResult& aRv);

  already_AddRefed<Promise> RemoveAllMockDevices(ErrorResult& aRv);

  already_AddRefed<Promise> ResetToDefaultMockDevices(ErrorResult& aRv);

  // Find or create a SerialPort for the given info. On the main thread,

  // eagerly creates and binds a PSerialPort actor. Returns nullptr on failure.

  RefPtr<SerialPort> GetOrCreatePort(const IPCSerialPortInfo& aInfo);

  // Remove the port from the granted list and mark it forgotten.

  MOZ_CAN_RUN_SCRIPT_BOUNDARY void ForgetPort(const nsAString& aPortId);

  bool GetAutoselectPorts(ErrorResult& aRv) const;

  void SetAutoselectPorts(bool aAutoselect, ErrorResult& aRv);

  bool AutoselectPorts() const { return mAutoselectPorts; }

 private:

  ~Serial() override;

  already_AddRefed<Promise> RequestPortWithTestingAutoselect(

      const SerialPortRequestOptions& aOptions, RefPtr<Promise> aPromise);

  // Returns the manager child if the testing preference is enabled, otherwise

  // sets a NotSupportedError on aRv and returns nullptr.

  SerialManagerChild* GetManagerChildForTesting(ErrorResult& aRv);

  // The single list of granted SerialPort objects for this context.

  nsTArray<RefPtr<SerialPort>> mPorts;

  RefPtr<SerialManagerChild> mManagerChild;

  // True if shutdown has started

  bool mHasShutdown = false;

  // Auto-select port in testing mode (defaults to true since most tests want

  // this)

  bool mAutoselectPorts = true;

};

}  // namespace mozilla::dom

#endif  // mozilla_dom_Serial_h