View Javadoc
1   /*
2    * Copyright (c) 2002-2025 Gargoyle Software Inc.
3    *
4    * Licensed under the Apache License, Version 2.0 (the "License");
5    * you may not use this file except in compliance with the License.
6    * You may obtain a copy of the License at
7    * https://www.apache.org/licenses/LICENSE-2.0
8    *
9    * Unless required by applicable law or agreed to in writing, software
10   * distributed under the License is distributed on an "AS IS" BASIS,
11   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12   * See the License for the specific language governing permissions and
13   * limitations under the License.
14   */
15  package org.htmlunit.javascript.host.media;
16  
17  import org.htmlunit.corejs.javascript.NativePromise;
18  import org.htmlunit.javascript.configuration.JsxClass;
19  import org.htmlunit.javascript.configuration.JsxConstructor;
20  import org.htmlunit.javascript.configuration.JsxFunction;
21  import org.htmlunit.javascript.host.dom.DOMException;
22  import org.htmlunit.javascript.host.event.EventTarget;
23  
24  /**
25   * A JavaScript object for {@code MediaDevices}.
26   *
27   * @author Ahmed Ashour
28   * @author Ronald Brill
29   */
30  @JsxClass
31  public class MediaDevices extends EventTarget {
32  
33      /**
34       * JavaScript constructor.
35       */
36      @Override
37      @JsxConstructor
38      public void jsConstructor() {
39          super.jsConstructor();
40      }
41  
42      /**
43       * @return a {@link NativePromise} that resolves to a {@link DOMException} because HtmlUnit
44       *         does not support media streaming
45       */
46      @JsxFunction
47      public NativePromise getUserMedia() {
48          return setupRejectedPromise(() ->
49                  new DOMException("HtmlUnit does not support media streaming.", DOMException.NOT_FOUND_ERR));
50      }
51  }