rx-player 3.33.0 → 3.33.1

package/src/core/api/option_utils.ts

@@ -1,700 +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.
- */
-
-/**
- * This file exports various helpers to parse options given to various APIs,
- * throw if something is wrong, and return a normalized option object.
- */
-
-import config from "../../config";
-import log from "../../log";
-import {
-  ISupplementaryImageTrack,
-  ISupplementaryTextTrack,
-} from "../../manifest";
-import {
-  IAudioTrackPreference,
-  IAudioTrackSwitchingMode,
-  IConstructorOptions,
-  IKeySystemOption,
-  ILoadedManifestFormat,
-  ILoadVideoOptions,
-  IManifestLoader,
-  INetworkConfigOption,
-  IRepresentationFilter,
-  ISegmentLoader,
-  IServerSyncInfos,
-  ISupplementaryImageTrackOption,
-  ISupplementaryTextTrackOption,
-  ITextTrackPreference,
-  IVideoTrackPreference,
-} from "../../public_types";
-import arrayIncludes from "../../utils/array_includes";
-import isNullOrUndefined from "../../utils/is_null_or_undefined";
-import {
-  normalizeAudioTrack,
-  normalizeTextTrack,
-} from "../../utils/languages";
-import objectAssign from "../../utils/object_assign";
-import warnOnce from "../../utils/warn_once";
-
-/** Value once parsed for the `startAt` option of the `loadVideo` method. */
-export type IParsedStartAtOption = { position : number } |
-                                   { wallClockTime : number } |
-                                   { percentage : number } |
-                                   { fromLastPosition : number } |
-                                   { fromLivePosition : number } |
-                                   { fromFirstPosition : number };
-
-export interface IParsedTransportOptions {
-  aggressiveMode? : boolean | undefined;
-  checkMediaSegmentIntegrity? : boolean | undefined;
-  lowLatencyMode : boolean;
-  manifestLoader?: IManifestLoader | undefined;
-  referenceDateTime? : number | undefined;
-  representationFilter? : IRepresentationFilter | undefined;
-  segmentLoader? : ISegmentLoader | undefined;
-  serverSyncInfos? : IServerSyncInfos | undefined;
-  /* eslint-disable import/no-deprecated */
-  manifestUpdateUrl? : string | undefined;
-  supplementaryImageTracks? : ISupplementaryImageTrack[] | undefined;
-  supplementaryTextTracks? : ISupplementaryTextTrack[] | undefined;
-  /* eslint-enable import/no-deprecated */
-
-  __priv_patchLastSegmentInSidx? : boolean | undefined;
-}
-
-/** Options of the RxPlayer's constructor once parsed. */
-export interface IParsedConstructorOptions {
-  maxBufferAhead : number;
-  maxBufferBehind : number;
-  wantedBufferAhead : number;
-  maxVideoBufferSize : number;
-  limitVideoWidth : boolean;
-  throttleWhenHidden : boolean;
-  throttleVideoBitrateWhenHidden : boolean;
-
-  preferredAudioTracks : IAudioTrackPreference[];
-  preferredTextTracks : ITextTrackPreference[];
-  preferredVideoTracks : IVideoTrackPreference[];
-
-  videoElement : HTMLMediaElement;
-  initialVideoBitrate : number;
-  initialAudioBitrate : number;
-  minAudioBitrate : number;
-  minVideoBitrate : number;
-  maxAudioBitrate : number;
-  maxVideoBitrate : number;
-  stopAtEnd : boolean;
-}
-
-/**
- * Base type which the types for the parsed options of the RxPlayer's
- * `loadVideo` method exend.
- */
-interface IParsedLoadVideoOptionsBase {
-  url : string | undefined;
-  transport : string;
-  autoPlay : boolean;
-  initialManifest : ILoadedManifestFormat | undefined;
-  keySystems : IKeySystemOption[];
-  lowLatencyMode : boolean;
-  minimumManifestUpdateInterval : number;
-  networkConfig: INetworkConfigOption;
-  transportOptions : IParsedTransportOptions;
-  defaultAudioTrack : IAudioTrackPreference|null|undefined;
-  defaultTextTrack : ITextTrackPreference|null|undefined;
-  startAt : IParsedStartAtOption|undefined;
-  manualBitrateSwitchingMode : "seamless"|"direct";
-  enableFastSwitching : boolean;
-  audioTrackSwitchingMode : IAudioTrackSwitchingMode;
-  onCodecSwitch : "continue"|"reload";
-}
-
-/**
- * Options of the RxPlayer's `loadVideo` method once parsed when a "native"
- * `textTrackMode` is asked.
- */
-interface IParsedLoadVideoOptionsNative extends IParsedLoadVideoOptionsBase {
-  textTrackMode : "native";
-  hideNativeSubtitle : boolean;
-}
-
-/**
- * Options of the RxPlayer's `loadVideo` method once parsed when an "html"
- * `textTrackMode` is asked.
- */
-interface IParsedLoadVideoOptionsHTML extends IParsedLoadVideoOptionsBase {
-  textTrackMode : "html";
-  textTrackElement : HTMLElement;
-}
-
-/**
- * Type enumerating all possible forms for the parsed options of the RxPlayer's
- * `loadVideo` method.
- */
-export type IParsedLoadVideoOptions =
-  IParsedLoadVideoOptionsNative |
-  IParsedLoadVideoOptionsHTML;
-
-/**
- * Parse options given to the API constructor and set default options as found
- * in the config.
- *
- * Do not mutate anything, only cross the given options and sane default options
- * (most coming from the config).
- * @param {Object|undefined} options
- * @returns {Object}
- */
-function parseConstructorOptions(
-  options : IConstructorOptions
-) : IParsedConstructorOptions {
-  let maxBufferAhead : number;
-  let maxBufferBehind : number;
-  let wantedBufferAhead : number;
-  let maxVideoBufferSize : number;
-
-  let throttleWhenHidden : boolean;
-  let throttleVideoBitrateWhenHidden : boolean;
-
-  let preferredAudioTracks : IAudioTrackPreference[];
-  let preferredTextTracks : ITextTrackPreference[];
-  let preferredVideoTracks : IVideoTrackPreference[];
-
-  let videoElement : HTMLMediaElement;
-  let initialVideoBitrate : number;
-  let initialAudioBitrate : number;
-  let minAudioBitrate : number;
-  let minVideoBitrate : number;
-  let maxAudioBitrate : number;
-  let maxVideoBitrate : number;
-
-  const { DEFAULT_INITIAL_BITRATES,
-          DEFAULT_LIMIT_VIDEO_WIDTH,
-          DEFAULT_MIN_BITRATES,
-          DEFAULT_MAX_BITRATES,
-          DEFAULT_MAX_BUFFER_AHEAD,
-          DEFAULT_MAX_BUFFER_BEHIND,
-          DEFAULT_MAX_VIDEO_BUFFER_SIZE,
-          DEFAULT_STOP_AT_END,
-          DEFAULT_THROTTLE_WHEN_HIDDEN,
-          DEFAULT_THROTTLE_VIDEO_BITRATE_WHEN_HIDDEN,
-          DEFAULT_WANTED_BUFFER_AHEAD } = config.getCurrent();
-
-  if (isNullOrUndefined(options.maxBufferAhead)) {
-    maxBufferAhead = DEFAULT_MAX_BUFFER_AHEAD;
-  } else {
-    maxBufferAhead = Number(options.maxBufferAhead);
-    if (isNaN(maxBufferAhead)) {
-      throw new Error("Invalid maxBufferAhead parameter. Should be a number.");
-    }
-  }
-
-  if (isNullOrUndefined(options.maxBufferBehind)) {
-    maxBufferBehind = DEFAULT_MAX_BUFFER_BEHIND;
-  } else {
-    maxBufferBehind = Number(options.maxBufferBehind);
-    if (isNaN(maxBufferBehind)) {
-      throw new Error("Invalid maxBufferBehind parameter. Should be a number.");
-    }
-  }
-
-  if (isNullOrUndefined(options.wantedBufferAhead)) {
-    wantedBufferAhead = DEFAULT_WANTED_BUFFER_AHEAD;
-  } else {
-    wantedBufferAhead = Number(options.wantedBufferAhead);
-    if (isNaN(wantedBufferAhead)) {
-      /* eslint-disable max-len */
-      throw new Error("Invalid wantedBufferAhead parameter. Should be a number.");
-      /* eslint-enable max-len */
-    }
-  }
-
-  if (isNullOrUndefined(options.maxVideoBufferSize)) {
-    maxVideoBufferSize = DEFAULT_MAX_VIDEO_BUFFER_SIZE;
-  } else {
-    maxVideoBufferSize = Number(options.maxVideoBufferSize);
-    if (isNaN(maxVideoBufferSize)) {
-      /* eslint-disable max-len */
-      throw new Error("Invalid maxVideoBufferSize parameter. Should be a number.");
-      /* eslint-enable max-len */
-    }
-  }
-
-
-  const limitVideoWidth = isNullOrUndefined(options.limitVideoWidth) ?
-    DEFAULT_LIMIT_VIDEO_WIDTH :
-    !!options.limitVideoWidth;
-
-  if (!isNullOrUndefined(options.throttleWhenHidden)) {
-    warnOnce("`throttleWhenHidden` API is deprecated. Consider using " +
-             "`throttleVideoBitrateWhenHidden` instead.");
-
-    throttleWhenHidden = !!options.throttleWhenHidden;
-  } else {
-    throttleWhenHidden = DEFAULT_THROTTLE_WHEN_HIDDEN;
-  }
-
-  // `throttleWhenHidden` and `throttleVideoBitrateWhenHidden` can be in conflict
-  // Do not activate the latter if the former is
-  if (throttleWhenHidden) {
-    throttleVideoBitrateWhenHidden = false;
-  } else {
-    throttleVideoBitrateWhenHidden =
-      isNullOrUndefined(options.throttleVideoBitrateWhenHidden) ?
-        DEFAULT_THROTTLE_VIDEO_BITRATE_WHEN_HIDDEN :
-        !!options.throttleVideoBitrateWhenHidden;
-  }
-
-  if (options.preferredTextTracks !== undefined) {
-    if (!Array.isArray(options.preferredTextTracks)) {
-      warnOnce("Invalid `preferredTextTracks` option, it should be an Array");
-      preferredTextTracks = [];
-    } else {
-      preferredTextTracks = options.preferredTextTracks;
-    }
-  } else {
-    preferredTextTracks = [];
-  }
-
-  if (options.preferredAudioTracks !== undefined) {
-    if (!Array.isArray(options.preferredAudioTracks)) {
-      warnOnce("Invalid `preferredAudioTracks` option, it should be an Array");
-      preferredAudioTracks = [];
-    } else {
-      preferredAudioTracks = options.preferredAudioTracks;
-    }
-  } else {
-    preferredAudioTracks = [];
-  }
-
-  if (options.preferredVideoTracks !== undefined) {
-    if (!Array.isArray(options.preferredVideoTracks)) {
-      warnOnce("Invalid `preferredVideoTracks` option, it should be an Array");
-      preferredVideoTracks = [];
-    } else {
-      preferredVideoTracks = options.preferredVideoTracks;
-    }
-  } else {
-    preferredVideoTracks = [];
-  }
-
-  if (isNullOrUndefined(options.videoElement)) {
-    videoElement = document.createElement("video");
-  } else if (options.videoElement instanceof HTMLMediaElement) {
-    videoElement = options.videoElement;
-  } else {
-    /* eslint-disable max-len */
-    throw new Error("Invalid videoElement parameter. Should be a HTMLMediaElement.");
-    /* eslint-enable max-len */
-  }
-
-  if (isNullOrUndefined(options.initialVideoBitrate)) {
-    initialVideoBitrate = DEFAULT_INITIAL_BITRATES.video;
-  } else {
-    initialVideoBitrate = Number(options.initialVideoBitrate);
-    if (isNaN(initialVideoBitrate)) {
-      /* eslint-disable max-len */
-      throw new Error("Invalid initialVideoBitrate parameter. Should be a number.");
-      /* eslint-enable max-len */
-    }
-  }
-
-  if (isNullOrUndefined(options.initialAudioBitrate)) {
-    initialAudioBitrate = DEFAULT_INITIAL_BITRATES.audio;
-  } else {
-    initialAudioBitrate = Number(options.initialAudioBitrate);
-    if (isNaN(initialAudioBitrate)) {
-      /* eslint-disable max-len */
-      throw new Error("Invalid initialAudioBitrate parameter. Should be a number.");
-      /* eslint-enable max-len */
-    }
-  }
-
-  if (isNullOrUndefined(options.minVideoBitrate)) {
-    minVideoBitrate = DEFAULT_MIN_BITRATES.video;
-  } else {
-    minVideoBitrate = Number(options.minVideoBitrate);
-    if (isNaN(minVideoBitrate)) {
-      throw new Error("Invalid maxVideoBitrate parameter. Should be a number.");
-    }
-  }
-
-  if (isNullOrUndefined(options.minAudioBitrate)) {
-    minAudioBitrate = DEFAULT_MIN_BITRATES.audio;
-  } else {
-    minAudioBitrate = Number(options.minAudioBitrate);
-    if (isNaN(minAudioBitrate)) {
-      throw new Error("Invalid minAudioBitrate parameter. Should be a number.");
-    }
-  }
-
-  if (isNullOrUndefined(options.maxVideoBitrate)) {
-    maxVideoBitrate = DEFAULT_MAX_BITRATES.video;
-  } else {
-    maxVideoBitrate = Number(options.maxVideoBitrate);
-    if (isNaN(maxVideoBitrate)) {
-      throw new Error("Invalid maxVideoBitrate parameter. Should be a number.");
-    } else if (minVideoBitrate > maxVideoBitrate) {
-      throw new Error("Invalid maxVideoBitrate parameter. Its value, \"" +
-                      `${maxVideoBitrate}", is inferior to the set minVideoBitrate, "` +
-                      `${minVideoBitrate}"`);
-    }
-  }
-
-  if (isNullOrUndefined(options.maxAudioBitrate)) {
-    maxAudioBitrate = DEFAULT_MAX_BITRATES.audio;
-  } else {
-    maxAudioBitrate = Number(options.maxAudioBitrate);
-    if (isNaN(maxAudioBitrate)) {
-      throw new Error("Invalid maxAudioBitrate parameter. Should be a number.");
-    } else if (minAudioBitrate > maxAudioBitrate) {
-      throw new Error("Invalid maxAudioBitrate parameter. Its value, \"" +
-                      `${maxAudioBitrate}", is inferior to the set minAudioBitrate, "` +
-                      `${minAudioBitrate}"`);
-    }
-  }
-
-  const stopAtEnd = isNullOrUndefined(options.stopAtEnd) ? DEFAULT_STOP_AT_END :
-                                                           !!options.stopAtEnd;
-
-  return { maxBufferAhead,
-           maxBufferBehind,
-           limitVideoWidth,
-           videoElement,
-           wantedBufferAhead,
-           maxVideoBufferSize,
-           throttleWhenHidden,
-           throttleVideoBitrateWhenHidden,
-           preferredAudioTracks,
-           preferredTextTracks,
-           preferredVideoTracks,
-           initialAudioBitrate,
-           initialVideoBitrate,
-           minAudioBitrate,
-           minVideoBitrate,
-           maxAudioBitrate,
-           maxVideoBitrate,
-           stopAtEnd };
-}
-
-/**
- * Check the format of given reload options.
- * Throw if format in invalid.
- * @param {object | undefined} options
- */
-function checkReloadOptions(options?: {
-  reloadAt?: { position?: number; relative?: number };
-  keySystems?: IKeySystemOption[];
-  autoPlay?: boolean;
-}): void {
-  if (options === null ||
-      (typeof options !== "object" && options !== undefined)) {
-    throw new Error("API: reload - Invalid options format.");
-  }
-  if (options?.reloadAt === null ||
-      (typeof options?.reloadAt !== "object" && options?.reloadAt !== undefined)) {
-    throw new Error("API: reload - Invalid 'reloadAt' option format.");
-  }
-  if (typeof options?.reloadAt?.position !== "number" &&
-      options?.reloadAt?.position !== undefined) {
-    throw new Error("API: reload - Invalid 'reloadAt.position' option format.");
-  }
-  if (typeof options?.reloadAt?.relative !== "number" &&
-      options?.reloadAt?.relative !== undefined) {
-    throw new Error("API: reload - Invalid 'reloadAt.relative' option format.");
-  }
-  if (!Array.isArray(options?.keySystems) && options?.keySystems !== undefined) {
-    throw new Error("API: reload - Invalid 'keySystems' option format.");
-  }
-  if (options?.autoPlay !== undefined && typeof options.autoPlay !== "boolean") {
-    throw new Error("API: reload - Invalid 'autoPlay' option format.");
-  }
-}
-
-/**
- * Parse options given to loadVideo and set default options as found
- * in the config.
- *
- * Do not mutate anything, only cross the given options and sane default options
- * (most coming from the config).
- *
- * Throws if any mandatory option is not set.
- * @param {Object|undefined} options
- * @param {Object} ctx - The player context, needed for some default values.
- * @returns {Object}
- */
-function parseLoadVideoOptions(
-  options : ILoadVideoOptions
-) : IParsedLoadVideoOptions {
-  let url : string|undefined;
-  let transport : string;
-  let keySystems : IKeySystemOption[];
-  let textTrackMode : "native"|"html";
-  let textTrackElement : HTMLElement|undefined;
-  let startAt : IParsedStartAtOption|undefined;
-
-  const { DEFAULT_AUDIO_TRACK_SWITCHING_MODE,
-          DEFAULT_AUTO_PLAY,
-          DEFAULT_CODEC_SWITCHING_BEHAVIOR,
-          DEFAULT_ENABLE_FAST_SWITCHING,
-          DEFAULT_MANUAL_BITRATE_SWITCHING_MODE,
-          DEFAULT_SHOW_NATIVE_SUBTITLE,
-          DEFAULT_TEXT_TRACK_MODE } = config.getCurrent();
-
-  if (isNullOrUndefined(options)) {
-    throw new Error("No option set on loadVideo");
-  }
-
-  if (!isNullOrUndefined(options.url)) {
-    url = String(options.url);
-  } else if (
-    isNullOrUndefined(options.transportOptions?.initialManifest) &&
-    isNullOrUndefined(options.transportOptions?.manifestLoader)
-  ) {
-    throw new Error("Unable to load a content: no url set on loadVideo.\n" +
-                    "Please provide at least either an `url` argument, a " +
-                    "`transportOptions.initialManifest` option or a " +
-                    "`transportOptions.manifestLoader` option so the RxPlayer " +
-                    "can load the content.");
-  }
-
-  if (isNullOrUndefined(options.transport)) {
-    throw new Error("No transport set on loadVideo");
-  } else {
-    transport = String(options.transport);
-  }
-
-  if (!isNullOrUndefined(options.transportOptions?.aggressiveMode)) {
-    warnOnce("`transportOptions.aggressiveMode` is deprecated and won't " +
-             "be present in the next major version. " +
-             "Please open an issue if you still need this.");
-  }
-
-  const autoPlay = isNullOrUndefined(options.autoPlay) ? DEFAULT_AUTO_PLAY :
-                                                         !!options.autoPlay;
-
-  if (isNullOrUndefined(options.keySystems)) {
-    keySystems = [];
-  } else {
-    keySystems = Array.isArray(options.keySystems) ? options.keySystems :
-                                                     [options.keySystems];
-    for (const keySystem of keySystems) {
-      if (typeof keySystem.type !== "string" ||
-          typeof keySystem.getLicense !== "function"
-      ) {
-        throw new Error("Invalid key system given: Missing type string or " +
-                        "getLicense callback");
-      }
-      if (!isNullOrUndefined(keySystem.onKeyStatusesChange)) {
-        warnOnce("`keySystems[].onKeyStatusesChange` is deprecated and won't " +
-                 "be present in the next major version. " +
-                 "Please open an issue if you still need this.");
-      }
-      if (!isNullOrUndefined(keySystem.throwOnLicenseExpiration)) {
-        warnOnce("`keySystems[].throwOnLicenseExpiration` is deprecated and won't " +
-                 "be present in the next major version. " +
-                 "Please open an issue if you still need this.");
-      }
-    }
-  }
-
-  const lowLatencyMode = options.lowLatencyMode === undefined ?
-    false :
-    !!options.lowLatencyMode;
-  const transportOptsArg = typeof options.transportOptions === "object" &&
-                                  options.transportOptions !== null ?
-    options.transportOptions :
-    {};
-
-  const initialManifest = options.transportOptions?.initialManifest;
-  const minimumManifestUpdateInterval =
-    options.transportOptions?.minimumManifestUpdateInterval ?? 0;
-
-  let audioTrackSwitchingMode = isNullOrUndefined(options.audioTrackSwitchingMode)
-                                  ? DEFAULT_AUDIO_TRACK_SWITCHING_MODE
-                                  : options.audioTrackSwitchingMode;
-  if (!arrayIncludes(["seamless", "direct", "reload"], audioTrackSwitchingMode)) {
-    log.warn("The `audioTrackSwitchingMode` loadVideo option must match one of " +
-             "the following strategy name:\n" +
-             "- `seamless`\n" +
-             "- `direct`\n" +
-             "- `reload`\n" +
-             "If badly set, " + DEFAULT_AUDIO_TRACK_SWITCHING_MODE +
-             " strategy will be used as default");
-    audioTrackSwitchingMode = DEFAULT_AUDIO_TRACK_SWITCHING_MODE;
-  }
-
-  let onCodecSwitch = isNullOrUndefined(options.onCodecSwitch)
-                        ? DEFAULT_CODEC_SWITCHING_BEHAVIOR
-                        : options.onCodecSwitch;
-  if (!arrayIncludes(["continue", "reload"], onCodecSwitch)) {
-    log.warn("The `onCodecSwitch` loadVideo option must match one of " +
-             "the following string:\n" +
-             "- `continue`\n" +
-             "- `reload`\n" +
-             "If badly set, " + DEFAULT_CODEC_SWITCHING_BEHAVIOR +
-             " will be used as default");
-    onCodecSwitch = DEFAULT_CODEC_SWITCHING_BEHAVIOR;
-  }
-
-  const transportOptions = objectAssign({}, transportOptsArg, {
-    /* eslint-disable import/no-deprecated */
-    supplementaryImageTracks: [] as ISupplementaryImageTrackOption[],
-    supplementaryTextTracks: [] as ISupplementaryTextTrackOption[],
-    /* eslint-enable import/no-deprecated */
-    lowLatencyMode,
-  });
-
-  // remove already parsed data to simplify the `transportOptions` object
-  delete transportOptions.initialManifest;
-  delete transportOptions.minimumManifestUpdateInterval;
-
-  if (options.supplementaryTextTracks !== undefined) {
-    warnOnce("The `supplementaryTextTracks` loadVideo option is deprecated.\n" +
-             "Please use the `TextTrackRenderer` tool instead.");
-    const supplementaryTextTracks =
-      Array.isArray(options.supplementaryTextTracks) ?
-        options.supplementaryTextTracks : [options.supplementaryTextTracks];
-
-    for (const supplementaryTextTrack of supplementaryTextTracks) {
-      if (typeof supplementaryTextTrack.language !== "string" ||
-          typeof supplementaryTextTrack.mimeType !== "string" ||
-          typeof supplementaryTextTrack.url !== "string"
-      ) {
-        throw new Error("Invalid supplementary text track given. " +
-                        "Missing either language, mimetype or url");
-      }
-    }
-    transportOptions.supplementaryTextTracks = supplementaryTextTracks;
-  }
-  if (options.supplementaryImageTracks !== undefined) {
-    warnOnce("The `supplementaryImageTracks` loadVideo option is deprecated.\n" +
-             "Please use the `parseBifThumbnails` tool instead.");
-    const supplementaryImageTracks =
-      Array.isArray(options.supplementaryImageTracks) ?
-        options.supplementaryImageTracks : [options.supplementaryImageTracks];
-    for (const supplementaryImageTrack of supplementaryImageTracks) {
-      if (typeof supplementaryImageTrack.mimeType !== "string" ||
-          typeof supplementaryImageTrack.url !== "string"
-      ) {
-        throw new Error("Invalid supplementary image track given. " +
-                        "Missing either mimetype or url");
-      }
-    }
-    transportOptions.supplementaryImageTracks = supplementaryImageTracks;
-  }
-
-  if (!isNullOrUndefined(options.transportOptions?.manifestUpdateUrl)) {
-    warnOnce("`manifestUpdateUrl` API is deprecated, please open an issue if you" +
-             " still rely on this.");
-  }
-
-  if (isNullOrUndefined(options.textTrackMode)) {
-    textTrackMode = DEFAULT_TEXT_TRACK_MODE;
-  } else {
-    if (options.textTrackMode !== "native" && options.textTrackMode !== "html") {
-      throw new Error("Invalid textTrackMode.");
-    }
-    textTrackMode = options.textTrackMode;
-  }
-
-  if (!isNullOrUndefined(options.defaultAudioTrack)) {
-    warnOnce("The `defaultAudioTrack` loadVideo option is deprecated.\n" +
-             "Please use the `preferredAudioTracks` constructor option or the" +
-             "`setPreferredAudioTracks` method instead");
-  }
-  const defaultAudioTrack = normalizeAudioTrack(options.defaultAudioTrack);
-
-  if (!isNullOrUndefined(options.defaultTextTrack)) {
-    warnOnce("The `defaultTextTrack` loadVideo option is deprecated.\n" +
-             "Please use the `preferredTextTracks` constructor option or the" +
-             "`setPreferredTextTracks` method instead");
-  }
-  const defaultTextTrack = normalizeTextTrack(options.defaultTextTrack);
-
-  let hideNativeSubtitle = !DEFAULT_SHOW_NATIVE_SUBTITLE;
-  if (!isNullOrUndefined(options.hideNativeSubtitle)) {
-    warnOnce("The `hideNativeSubtitle` loadVideo option is deprecated");
-    hideNativeSubtitle = !!options.hideNativeSubtitle;
-  }
-  const manualBitrateSwitchingMode = options.manualBitrateSwitchingMode ??
-                                     DEFAULT_MANUAL_BITRATE_SWITCHING_MODE;
-
-  const enableFastSwitching = isNullOrUndefined(options.enableFastSwitching) ?
-    DEFAULT_ENABLE_FAST_SWITCHING :
-    options.enableFastSwitching;
-
-  if (textTrackMode === "html") {
-    // TODO Better way to express that in TypeScript?
-    if (isNullOrUndefined(options.textTrackElement)) {
-      throw new Error("You have to provide a textTrackElement " +
-                      "in \"html\" textTrackMode.");
-    } else if (!(options.textTrackElement instanceof HTMLElement)) {
-      throw new Error("textTrackElement should be an HTMLElement.");
-    } else {
-      textTrackElement = options.textTrackElement;
-    }
-  } else if (!isNullOrUndefined(options.textTrackElement)) {
-    log.warn("API: You have set a textTrackElement without being in " +
-             "an \"html\" textTrackMode. It will be ignored.");
-  }
-
-  if (!isNullOrUndefined(options.startAt)) {
-    if ("wallClockTime" in options.startAt
-    && options.startAt.wallClockTime instanceof Date
-    ) {
-      const wallClockTime = (options.startAt as { wallClockTime : Date })
-        .wallClockTime.getTime() / 1000;
-      startAt = objectAssign({},
-                             options.startAt,
-                             { wallClockTime });
-    } else {
-      startAt = options.startAt as IParsedStartAtOption;
-    }
-  }
-
-  const networkConfig = options.networkConfig ?? {};
-
-  // TODO without cast
-  /* eslint-disable @typescript-eslint/consistent-type-assertions */
-  return { autoPlay,
-           defaultAudioTrack,
-           defaultTextTrack,
-           enableFastSwitching,
-           hideNativeSubtitle,
-           keySystems,
-           initialManifest,
-           lowLatencyMode,
-           manualBitrateSwitchingMode,
-           audioTrackSwitchingMode,
-           minimumManifestUpdateInterval,
-           networkConfig,
-           onCodecSwitch,
-           startAt,
-           textTrackElement,
-           textTrackMode,
-           transport,
-           transportOptions,
-           url } as IParsedLoadVideoOptions;
-  /* eslint-enable @typescript-eslint/consistent-type-assertions */
-}
-
-export {
-  checkReloadOptions,
-  parseConstructorOptions,
-  parseLoadVideoOptions,
-};