third_party/blink/renderer/modules/mediastream/sub_capture_target.h

// 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 THIRD_PARTY_BLINK_RENDERER_MODULES_MEDIASTREAM_SUB_CAPTURE_TARGET_H_
#define THIRD_PARTY_BLINK_RENDERER_MODULES_MEDIASTREAM_SUB_CAPTURE_TARGET_H_

#include "media/capture/mojom/video_capture_types.mojom-blink.h"
#include "third_party/blink/renderer/modules/modules_export.h"
#include "third_party/blink/renderer/platform/bindings/script_wrappable.h"
#include "third_party/blink/renderer/platform/wtf/text/wtf_string.h"

namespace blink {

class Element;
class ExceptionState;
class MediaDevices;
class ScriptState;

// Mutual non-Web-exposed parent class for various Web-exposed tokens
// which use the same minting logic under the hood.
class MODULES_EXPORT SubCaptureTarget : public ScriptWrappable {
 public:
  using Type = media::mojom::blink::SubCaptureTargetType;

  Type GetType() const { return type_; }

  // The ID is a UUID. SubCaptureTarget wraps it and abstracts it away for JS,
  // but internally, the implementation is based on this implementation detail.
  const String& GetId() const { return id_; }

 protected:
  // Tries to get the relevant MediaDevices object.
  // If unsuccessful, throws a relevant exception and returns nullptr.
  static MediaDevices* GetMediaDevices(ScriptState* script_state,
                                       Element* element,
                                       ExceptionState& exception_state);

  SubCaptureTarget(Type type, String id);

 private:
  const Type type_;

  // TODO(crbug.com/1332628): Wrap the base::Token instead of wrapping its
  // string representation.
  const String id_;
};

}  // namespace blink

#endif  // THIRD_PARTY_BLINK_RENDERER_MODULES_MEDIASTREAM_SUB_CAPTURE_TARGET_H_