Source: lib/net/http_xhr_plugin.js

  1. /*! @license
  2. * Shaka Player
  3. * Copyright 2016 Google LLC
  4. * SPDX-License-Identifier: Apache-2.0
  5. */
  6. goog.provide('shaka.net.HttpXHRPlugin');
  7. goog.require('goog.asserts');
  8. goog.require('shaka.net.HttpPluginUtils');
  9. goog.require('shaka.net.NetworkingEngine');
  10. goog.require('shaka.util.AbortableOperation');
  11. goog.require('shaka.util.Error');
  12. /**
  13. * @summary A networking plugin to handle http and https URIs via XHR.
  14. * @export
  15. */
  16. shaka.net.HttpXHRPlugin = class {
  17. /**
  18. * @param {string} uri
  19. * @param {shaka.extern.Request} request
  20. * @param {shaka.net.NetworkingEngine.RequestType} requestType
  21. * @param {shaka.extern.ProgressUpdated} progressUpdated Called when a
  22. * progress event happened.
  23. * @param {shaka.extern.HeadersReceived} headersReceived Called when the
  24. * headers for the download are received, but before the body is.
  25. * @param {shaka.extern.SchemePluginConfig} config
  26. * @return {!shaka.extern.IAbortableOperation.<shaka.extern.Response>}
  27. * @export
  28. */
  29. static parse(uri, request, requestType, progressUpdated, headersReceived,
  30. config) {
  31. const xhr = new shaka.net.HttpXHRPlugin.Xhr_();
  32. // Last time stamp when we got a progress event.
  33. let lastTime = Date.now();
  34. // Last number of bytes loaded, from progress event.
  35. let lastLoaded = 0;
  36. const promise = new Promise(((resolve, reject) => {
  37. xhr.open(request.method, uri, true);
  38. xhr.responseType = 'arraybuffer';
  39. xhr.timeout = request.retryParameters.timeout;
  40. xhr.withCredentials = request.allowCrossSiteCredentials;
  41. xhr.onabort = () => {
  42. reject(new shaka.util.Error(
  43. shaka.util.Error.Severity.RECOVERABLE,
  44. shaka.util.Error.Category.NETWORK,
  45. shaka.util.Error.Code.OPERATION_ABORTED,
  46. uri, requestType));
  47. };
  48. let calledHeadersReceived = false;
  49. xhr.onreadystatechange = (event) => {
  50. // See if the readyState is 2 ("HEADERS_RECEIVED").
  51. if (xhr.readyState == 2 && !calledHeadersReceived) {
  52. const headers = shaka.net.HttpXHRPlugin.headersToGenericObject_(xhr);
  53. headersReceived(headers);
  54. // Don't send out this event twice.
  55. calledHeadersReceived = true;
  56. }
  57. };
  58. xhr.onload = (event) => {
  59. const headers = shaka.net.HttpXHRPlugin.headersToGenericObject_(xhr);
  60. goog.asserts.assert(xhr.response instanceof ArrayBuffer,
  61. 'XHR should have a response by now!');
  62. const xhrResponse = xhr.response;
  63. try {
  64. const currentTime = Date.now();
  65. progressUpdated(currentTime - lastTime, event.loaded - lastLoaded,
  66. /* numBytesRemaining= */ 0);
  67. const response = shaka.net.HttpPluginUtils.makeResponse(headers,
  68. xhrResponse, xhr.status, uri, xhr.responseURL, requestType);
  69. resolve(response);
  70. } catch (error) {
  71. goog.asserts.assert(error instanceof shaka.util.Error,
  72. 'Wrong error type!');
  73. reject(error);
  74. }
  75. };
  76. xhr.onerror = (event) => {
  77. reject(new shaka.util.Error(
  78. shaka.util.Error.Severity.RECOVERABLE,
  79. shaka.util.Error.Category.NETWORK,
  80. shaka.util.Error.Code.HTTP_ERROR,
  81. uri, event, requestType));
  82. };
  83. xhr.ontimeout = (event) => {
  84. reject(new shaka.util.Error(
  85. shaka.util.Error.Severity.RECOVERABLE,
  86. shaka.util.Error.Category.NETWORK,
  87. shaka.util.Error.Code.TIMEOUT,
  88. uri, requestType));
  89. };
  90. xhr.onprogress = (event) => {
  91. const currentTime = Date.now();
  92. // If the time between last time and this time we got progress event
  93. // is long enough, or if a whole segment is downloaded, call
  94. // progressUpdated().
  95. const minBytes = config.minBytesForProgressEvents || 0;
  96. const chunkSize = event.loaded - lastLoaded;
  97. if ((currentTime - lastTime > 100 && chunkSize >= minBytes) ||
  98. (event.lengthComputable && event.loaded == event.total)) {
  99. const numBytesRemaining =
  100. xhr.readyState == 4 ? 0 : event.total - event.loaded;
  101. progressUpdated(currentTime - lastTime, chunkSize,
  102. numBytesRemaining);
  103. lastLoaded = event.loaded;
  104. lastTime = currentTime;
  105. }
  106. };
  107. for (const key in request.headers) {
  108. // The Fetch API automatically normalizes outgoing header keys to
  109. // lowercase. For consistency's sake, do it here too.
  110. const lowercasedKey = key.toLowerCase();
  111. xhr.setRequestHeader(lowercasedKey, request.headers[key]);
  112. }
  113. xhr.send(request.body);
  114. }));
  115. return new shaka.util.AbortableOperation(
  116. promise,
  117. () => {
  118. xhr.abort();
  119. return Promise.resolve();
  120. });
  121. }
  122. /**
  123. * @param {!XMLHttpRequest} xhr
  124. * @return {!Object.<string, string>}
  125. * @private
  126. */
  127. static headersToGenericObject_(xhr) {
  128. // Since Edge incorrectly return the header with a leading new
  129. // line character ('\n'), we trim the header here.
  130. const headerLines = xhr.getAllResponseHeaders().trim().split('\r\n');
  131. const headers = {};
  132. for (const header of headerLines) {
  133. /** @type {!Array.<string>} */
  134. const parts = header.split(': ');
  135. headers[parts[0].toLowerCase()] = parts.slice(1).join(': ');
  136. }
  137. return headers;
  138. }
  139. };
  140. /**
  141. * Overridden in unit tests, but compiled out in production.
  142. *
  143. * @const {function(new: XMLHttpRequest)}
  144. * @private
  145. */
  146. shaka.net.HttpXHRPlugin.Xhr_ = window.XMLHttpRequest;
  147. shaka.net.NetworkingEngine.registerScheme(
  148. 'http', shaka.net.HttpXHRPlugin.parse,
  149. shaka.net.NetworkingEngine.PluginPriority.FALLBACK,
  150. /* progressSupport= */ true);
  151. shaka.net.NetworkingEngine.registerScheme(
  152. 'https', shaka.net.HttpXHRPlugin.parse,
  153. shaka.net.NetworkingEngine.PluginPriority.FALLBACK,
  154. /* progressSupport= */ true);
  155. shaka.net.NetworkingEngine.registerScheme(
  156. 'blob', shaka.net.HttpXHRPlugin.parse,
  157. shaka.net.NetworkingEngine.PluginPriority.FALLBACK,
  158. /* progressSupport= */ true);