rx-player 3.33.0 → 3.33.1

package/src/compat/browser_compatibility_types.ts

@@ -1,222 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import isNullOrUndefined from "../utils/is_null_or_undefined";
-import isNode from "./is_node";
-
-/** Regular MediaKeys type + optional functions present in IE11. */
-interface ICompatMediaKeysConstructor {
-  isTypeSupported? : (type : string) => boolean; // IE11 only
-  new(keyType? : string) : MediaKeys; // argument for IE11 only
-}
-
-/**
- * Browser implementation of a VTTCue constructor.
- * TODO open TypeScript issue about it?
- */
-type ICompatVTTCueConstructor = new(start : number,
-                                    end : number,
-                                    cueText : string) => ICompatVTTCue;
-
-/** Browser implementation for a single VTTCue. */
-interface ICompatVTTCue { align : string;
-                          endTime : number;
-                          id : string;
-                          line : number | "auto";
-                          lineAlign : string;
-                          position : number | "auto";
-                          positionAlign : string;
-                          size : number | string;
-                          snapToLines : boolean;
-                          startTime : number;
-                          vertical : string; }
-
-/**
- * Overriden TextTrack browser implementation, to also include our own
- * definition of a VTTCue.
- */
-interface ICompatTextTrack extends TextTrack {
-  addCue(cue: TextTrackCue | ICompatVTTCue) : void;
-  removeCue(cue: TextTrackCue | ICompatVTTCue) : void;
-  HIDDEN? : "hidden";
-  SHOWING? :  "showing";
-}
-
-/**
- * Browser implementation of the `document` object with added optional vendored
- * functions for some "old" browsers.
- */
-interface ICompatDocument extends Document {
-  fullscreenElement : Element | null;
-  mozCancelFullScreen? : () => void;
-  mozFullScreenElement? : HTMLElement;
-  mozHidden? : boolean;
-  msExitFullscreen? : () => void;
-  msFullscreenElement? : Element | null;
-  msHidden? : boolean;
-  webkitExitFullscreen : () => void;
-  webkitFullscreenElement : Element | null;
-  webkitHidden? : boolean;
-}
-
-/**
- * HTMLMediaElement with added optional vendored functions used by "old"
- * browsers.
- * And TypeScript forgot to add assiociated AudioTrackList and VideoTrackList
- * (and yes apparently a HTMLAudioElement can have an assiociated
- * VideoTrackList).
- *
- * Note: I prefer to define my own `ICompatHTMLMediaElement` rather to extend
- * the original definition to better detect which types have been extended and
- * are not actually valid TypeScript types.
- */
-interface ICompatHTMLMediaElement extends HTMLMediaElement {
-  mozRequestFullScreen? : () => void;
-  msRequestFullscreen? : () => void;
-  webkitRequestFullscreen? : () => void;
-  webkitSupportsPresentationMode? : boolean;
-  webkitSetPresentationMode? : () => void;
-  webkitPresentationMode? : string;
-  mozSetMediaKeys? : (mediaKeys: unknown) => void;
-  msSetMediaKeys? : (mediaKeys: unknown) => void;
-  webkitSetMediaKeys? : (mediaKeys: unknown) => void;
-  webkitKeys? : {
-    createSession? : (
-      mimeType : string,
-      initData : BufferSource
-    ) => MediaKeySession;
-  };
-  readonly audioTracks? : ICompatAudioTrackList;
-  readonly videoTracks? : ICompatVideoTrackList;
-}
-
-/**
- * AudioTrackList implementation (that TS forgot).
- * Directly taken from the WHATG spec:
- * https://html.spec.whatwg.org/multipage/media.html#audiotracklist
- */
-interface ICompatAudioTrackList extends EventTarget {
-  readonly length : number;
-  getTrackById(id : string) : ICompatAudioTrack;
-  onchange? : ((n : Event) => void) | null;
-  onaddtrack? : ((n : Event) => void) | null;
-  onremovetrack? : ((n : Event) => void) | null;
-
-  // It can be indexed
-  [x : number] : ICompatAudioTrack;
-}
-
-/**
- * AudioTrack implementation (that TS forgot).
- * Directly taken from the WHATG spec:
- * https://html.spec.whatwg.org/multipage/media.html#audiotracklist
- */
-interface ICompatAudioTrack {
-  id : string;
-  kind : string;
-  label : string;
-  language : string;
-  enabled : boolean;
-}
-
-/**
- * VideoTrackList implementation (that TS forgot).
- * Directly taken from the WHATG spec:
- * https://html.spec.whatwg.org/multipage/media.html#audiotracklist
- */
-interface ICompatVideoTrackList extends EventTarget {
-  readonly length : number;
-  selectedIndex : number;
-  getTrackById(id : string) : ICompatVideoTrack;
-  onchange? : ((n : Event) => void) | null;
-  onaddtrack? : ((n : Event) => void) | null;
-  onremovetrack? : ((n : Event) => void) | null;
-
-  // It can be indexed
-  [x : number] : ICompatVideoTrack;
-}
-
-/**
- * VideoTrack implementation (that TS forgot).
- * Directly taken from the WHATG spec:
- * https://html.spec.whatwg.org/multipage/media.html#audiotracklist
- */
-interface ICompatVideoTrack {
-  id : string;
-  kind : string;
-  label : string;
-  language : string;
-  selected : boolean;
-}
-
-/**
- * Browser implementation of a Picture in picture window, as defined in the the
- * draft from the W3C:
- * https://wicg.github.io/picture-in-picture/#pictureinpicturewindow
- */
-export interface ICompatPictureInPictureWindow
-  extends EventTarget { width: number;
-                        height: number; }
-
-interface WindowsWithMediaSourceImplems extends Window {
-  MediaSource? : typeof MediaSource;
-  MozMediaSource? : typeof MediaSource;
-  WebKitMediaSource? : typeof MediaSource;
-  MSMediaSource? : typeof MediaSource;
-}
-
-const win : WindowsWithMediaSourceImplems | undefined = isNode ? undefined :
-                                                                 window;
-
-/** MediaSource implementation, including vendored implementations. */
-const MediaSource_ : typeof MediaSource | undefined =
-  win === undefined                            ? undefined :
-  !isNullOrUndefined(win.MediaSource)          ? win.MediaSource :
-  !isNullOrUndefined(win.MozMediaSource)       ? win.MozMediaSource :
-  !isNullOrUndefined(win.WebKitMediaSource)    ? win.WebKitMediaSource :
-                                                 win.MSMediaSource;
-
-/** List an HTMLMediaElement's possible values for its readyState property. */
-const READY_STATES = { HAVE_NOTHING: 0,
-                       HAVE_METADATA: 1,
-                       HAVE_CURRENT_DATA: 2,
-                       HAVE_FUTURE_DATA: 3,
-                       HAVE_ENOUGH_DATA: 4 };
-
-/**
- * TextTrackList browser implementation.
- * TODO W3C defines onremovetrack and onchange attributes which are not present on
- * ts type definition, open a TS issue?
- */
-export interface ICompatTextTrackList extends TextTrackList {
-  onremovetrack: ((ev: TrackEvent) => void) | null;
-  onchange: (() => void) | null;
-}
-
-export {
-  ICompatDocument,
-  ICompatHTMLMediaElement,
-  ICompatAudioTrackList,
-  ICompatVideoTrackList,
-  ICompatAudioTrack,
-  ICompatVideoTrack,
-  ICompatMediaKeysConstructor,
-  ICompatTextTrack,
-  ICompatVTTCue,
-  ICompatVTTCueConstructor,
-  MediaSource_,
-  READY_STATES,
-};

package/src/compat/browser_detection.ts

@@ -1,172 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import isNode from "./is_node";
-
-interface IIE11WindowObject extends Window {
-  MSInputMethodContext? : unknown;
-}
-
-interface IIE11Document extends Document {
-  documentMode? : unknown;
-}
-
-/** Edge Chromium, regardless of the device */
-let isEdgeChromium = false;
-
-/** IE11, regardless of the device */
-let isIE11 = false;
-
-/** IE11 or Edge __Legacy__ (not Edge Chromium), regardless of the device */
-let isIEOrEdge = false;
-
-/** Firefox, regardless of the device */
-let isFirefox = false;
-
-/** `true` on Safari on a PC platform (i.e. not iPhone / iPad etc.) */
-let isSafariDesktop = false;
-
-/** `true` on Safari on an iPhone, iPad & iPod platform */
-let isSafariMobile = false;
-
-/** Samsung's own browser application */
-let isSamsungBrowser = false;
-
-/** `true` on devices where Tizen is the OS (e.g. Samsung TVs). */
-let isTizen = false;
-
-/** `true` on devices where WebOS is the OS (e.g. LG TVs). */
-let isWebOs = false;
-
-/** `true` specifically for WebOS 2021 version. */
-let isWebOs2021 = false;
-
-/** `true` specifically for WebOS 2022 version. */
-let isWebOs2022 = false;
-
-/** `true` for Panasonic devices. */
-let isPanasonic = false;
-
-/** `true` for the PlayStation 5 game console. */
-let isPlayStation5 = false;
-
-/** `true` for the Xbox game consoles. */
-let isXbox = false;
-
-((function findCurrentBrowser() : void {
-  if (isNode) {
-    return ;
-  }
-
-  // 1 - Find out browser between IE/Edge Legacy/Edge Chromium/Firefox/Safari
-
-  if (typeof (window as IIE11WindowObject).MSInputMethodContext !== "undefined" &&
-      typeof (document as IIE11Document).documentMode !== "undefined")
-  {
-    isIE11 = true;
-    isIEOrEdge = true;
-  } else if (
-    navigator.appName === "Microsoft Internet Explorer" ||
-    navigator.appName === "Netscape" &&
-    /(Trident|Edge)\//.test(navigator.userAgent)
-  ) {
-    isIEOrEdge = true;
-  } else if (navigator.userAgent.toLowerCase().indexOf("edg/") !== -1) {
-    isEdgeChromium = true;
-  } else if (navigator.userAgent.toLowerCase().indexOf("firefox") !== -1) {
-    isFirefox = true;
-  } else if (typeof navigator.platform === "string" &&
-             /iPad|iPhone|iPod/.test(navigator.platform))
-  {
-    isSafariMobile = true;
-  } else if (
-    // the following statement check if the window.safari contains the method
-    // "pushNotification", this condition is not met when using web app from the dock
-    // on macOS, this is why we also check userAgent.
-    Object.prototype.toString.call(window.HTMLElement).indexOf("Constructor") >= 0 ||
-    (window as ISafariWindowObject).safari?.pushNotification?.toString() ===
-      "[object SafariRemoteNotification]" ||
-    // browsers are lying: Chrome reports both as Chrome and Safari in user
-    // agent string, So to detect Safari we have to check for the Safari string
-    // and the absence of the Chrome string
-    // eslint-disable-next-line max-len
-    // @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Browser_detection_using_the_user_agent#which_part_of_the_user_agent_contains_the_information_you_are_looking_for
-    ((/Safari\/(\d+)/).test(navigator.userAgent) &&
-    // Safari should contain Version/ in userAgent
-    (/Version\/(\d+)/).test(navigator.userAgent) &&
-    (navigator.vendor?.indexOf("Apple") !== -1) &&
-    !(/Chrome\/(\d+)/).test(navigator.userAgent) &&
-    !(/Chromium\/(\d+)/).test(navigator.userAgent))
-  ) {
-    isSafariDesktop = true;
-  }
-
-  // 2 - Find out specific device/platform information
-
-  // Samsung browser e.g. on Android
-  if (/SamsungBrowser/.test(navigator.userAgent)) {
-    isSamsungBrowser = true;
-  }
-
-  if (navigator.userAgent.indexOf("PlayStation 5") !== -1) {
-    isPlayStation5 = true;
-  } else if (/Tizen/.test(navigator.userAgent)) {
-    isTizen = true;
-
-  // Inspired form: http://webostv.developer.lge.com/discover/specifications/web-engine/
-  // Note: even that page doesn't correspond to what we've actually seen in the
-  // wild
-  } else if (/[Ww]eb[O0]S/.test(navigator.userAgent)) {
-    isWebOs = true;
-
-    if (
-      /[Ww]eb[O0]S.TV-2022/.test(navigator.userAgent) ||
-      /[Cc]hr[o0]me\/87/.test(navigator.userAgent)
-    ) {
-      isWebOs2022 = true;
-    } else if (
-      /[Ww]eb[O0]S.TV-2021/.test(navigator.userAgent) ||
-      /[Cc]hr[o0]me\/79/.test(navigator.userAgent)
-    ) {
-      isWebOs2021 = true;
-    }
-  } else if (/[Pp]anasonic/.test(navigator.userAgent)) {
-    isPanasonic = true;
-  } else if (navigator.userAgent.indexOf("Xbox") !== -1) {
-    isXbox = true;
-  }
-})());
-
-interface ISafariWindowObject extends Window {
-  safari? : { pushNotification? : { toString() : string } };
-}
-
-export {
-  isEdgeChromium,
-  isIE11,
-  isIEOrEdge,
-  isFirefox,
-  isPanasonic,
-  isPlayStation5,
-  isXbox,
-  isSafariDesktop,
-  isSafariMobile,
-  isSamsungBrowser,
-  isTizen,
-  isWebOs,
-  isWebOs2021,
-  isWebOs2022,
-};

package/src/compat/browser_version.ts

@@ -1,44 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import log from "../log";
-import { isFirefox } from "./browser_detection";
-
-/**
- * Returns either :
- * - 'null' when the current browser is not Firefox.
- * - '-1' when it is impossible to get the Firefox version
- * - A number above 0 that is the Firefox version number
- * @returns {number|null}
- */
-function getFirefoxVersion(): number|null {
-  if (!isFirefox) {
-    log.warn("Compat: Can't access Firefox version on no firefox browser.");
-    return null;
-  }
-  const userAgent = navigator.userAgent;
-  const match = /Firefox\/([0-9]+)\./.exec(userAgent);
-  if (match === null) {
-    return -1;
-  }
-  const result = parseInt(match[1], 10);
-  if (isNaN(result)) {
-    return -1;
-  }
-  return result;
-}
-
-export { getFirefoxVersion };

package/src/compat/can_patch_isobmff.ts

@@ -1,30 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import { isIEOrEdge } from "./browser_detection";
-
-/**
- * TODO(pierre): fix patchSegmentInPlace to work with IE11. Maybe
- * try to put free atom inside traf children
- *
- * Returns true if the current target is tolerant enough for us to
- * simply be able to "patch" an ISOBMFF segment or if we have to create a
- * new one from scratch instead.
- * @returns {Boolean}
- */
-export default function canPatchISOBMFFSegment() : boolean {
-  return !isIEOrEdge;
-}

package/src/compat/can_rely_on_video_visibility_and_size.ts

@@ -1,52 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import { isFirefox } from "./browser_detection";
-import { getFirefoxVersion } from "./browser_version";
-
-/**
- * This functions tells if the RxPlayer can trust on any browser data
- * about video element visibility and size.
- *
- * On Firefox (version >= 67) :
- * - The PIP feature exists but can be disabled by default according
- * to the OS and the channel used for updating / getting Firefox binaries.
- * - There is no API to know if the Picture-in-picture (PIP) is enabled
- * - There is no API to get the width of the PIP window
- *
- * The element clientWidth tells the width of the original video element, and
- * no PIP window API exists to determine its presence or width. Thus, there are
- * no way to determine the real width of the video window, as we can't know when
- * the PIP feature or window is enabled, and we can't have access to the windo
- * size information.
- *
- * Moreover, when the document is considered as hidden (e.g. in case of hidden
- * tab), as there is no way to know if the PIP feature or window is enabled,
- * we can't know if the video window is visible or not.
- * @returns {boolean}
- */
-export default function canRelyOnVideoVisibilityAndSize(): boolean {
-  if (!isFirefox) {
-    return true;
-  }
-  const firefoxVersion = getFirefoxVersion();
-  if (firefoxVersion === null || firefoxVersion < 67) {
-    return true;
-  }
-  const proto : (HTMLVideoElement & { requirePictureInPicture? : () => void }) |
-                undefined = HTMLVideoElement?.prototype;
-  return proto?.requirePictureInPicture !== undefined;
-}

package/src/compat/can_reuse_media_keys.ts

@@ -1,20 +0,0 @@
-import {
-  isPanasonic,
-  isWebOs,
-} from "./browser_detection";
-
-/**
- * Returns `true` if a `MediaKeys` instance (the  `Encrypted Media Extension`
- * concept) can be reused between contents.
- *
- * This should usually be the case but we found rare devices where this would
- * cause problem:
- *   - (2022-11-21): WebOS (LG TVs), for some encrypted contents, just
- *     rebuffered indefinitely when loading a content already-loaded on the
- *     HTMLMediaElement.
- *
- * @returns {boolean}
- */
-export default function canReuseMediaKeys() : boolean {
-  return !isWebOs && !isPanasonic;
-}

package/src/compat/change_source_buffer_type.ts

@@ -1,66 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import log from "../log";
-import { IEventEmitter } from "../utils/event_emitter";
-
-interface ICompatSourceBufferEvents { updatestart : Event|undefined;
-                                      update : Event|undefined;
-                                      updateend : Event|undefined;
-                                      error : Event; }
-
-/**
- * Definition of a SourceBuffer Object.
- * Adds some non-standard APIs to the regular one like `changeType`, which exist
- * on some browsers.
- */
-export interface ICompatSourceBuffer
-  extends IEventEmitter<ICompatSourceBufferEvents> {
-    buffered : TimeRanges;
-    changeType? : (type: string) => void;
-    updating : boolean;
-    appendWindowStart : number;
-    appendWindowEnd : number;
-    timestampOffset : number;
-    appendBuffer(data : BufferSource) : void;
-    remove(from : number, to : number) : void;
-    abort() : void;
-  }
-
-/**
- * If the changeType MSE API is implemented, update the current codec of the
- * SourceBuffer and return true if it succeeded.
- * In any other cases, return false.
- * @param {Object} sourceBuffer
- * @param {string} codec
- * @returns {boolean}
- */
-export default function tryToChangeSourceBufferType(
-  sourceBuffer : ICompatSourceBuffer,
-  codec : string
-) : boolean {
-  if (typeof sourceBuffer.changeType === "function") {
-    try {
-      sourceBuffer.changeType(codec);
-    } catch (e) {
-      log.warn("Could not call 'changeType' on the given SourceBuffer:",
-                e instanceof Error ? e : "");
-      return false;
-    }
-    return true;
-  }
-  return false;
-}

package/src/compat/clear_element_src.ts

@@ -1,55 +0,0 @@
-/**
- * Copyright 2015 CANAL+ Group
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import log from "../log";
-import isNullOrUndefined from "../utils/is_null_or_undefined";
-
-/**
- * Clear element's src attribute.
- * @param {HTMLMediaElement} element
- */
-export default function clearElementSrc(element : HTMLMediaElement) : void {
-  // On some browsers, we first have to make sure the textTracks elements are
-  // both disabled and removed from the DOM.
-  // If we do not do that, we may be left with displayed text tracks on the
-  // screen, even if the track elements are properly removed, due to browser
-  // issues.
-  // Bug seen on Firefox (I forgot which version) and Chrome 96.
-  const { textTracks } = element;
-  if (!isNullOrUndefined(textTracks)) {
-    for (let i = 0; i < textTracks.length; i++) {
-      textTracks[i].mode = "disabled";
-    }
-    if (element.hasChildNodes()) {
-      const { childNodes } = element;
-      for (let j = childNodes.length - 1; j >= 0; j--) {
-        if (childNodes[j].nodeName === "track") {
-          try {
-            element.removeChild(childNodes[j]);
-          } catch (err) {
-            log.warn("Compat: Could not remove text track child from element.");
-          }
-        }
-      }
-    }
-  }
-  element.src = "";
-
-  // On IE11, element.src = "" is not sufficient as it
-  // does not clear properly the current MediaKey Session.
-  // Microsoft recommended to use element.removeAttr("src").
-  element.removeAttribute("src");
-}