mirror of
https://github.com/shaka-project/shaka-player.git
synced 2026-06-14 15:56:38 +03:00
Joey Parrish
836bd9a177
By exporting StringUtils and Uint8ArrayUtils, we can simplify the process of wrapping, unwrapping, and parsing requests and responses in NetworkingEngine filters. This makes it easier to write filters that deal with text-based data, as it is no longer the job of the application developer to deal with subtle conversions between string and ArrayBuffer. We will also fill in requests with defaults if needed. This allows developers to omit fields when initiating extra requests at the application level. Closes #667 Change-Id: Ie6a0f23b4d46e7e458d996759eac6cd85a36b741
112 lines
3.0 KiB
JavaScript
112 lines
3.0 KiB
JavaScript
/**
|
|
* @license
|
|
* Copyright 2016 Google Inc.
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
goog.provide('shaka.util.Uint8ArrayUtils');
|
|
|
|
|
|
/**
|
|
* @namespace shaka.util.Uint8ArrayUtils
|
|
* @summary A set of Uint8Array utility functions.
|
|
* @exportDoc
|
|
*/
|
|
|
|
|
|
/**
|
|
* Convert a Uint8Array to a base64 string. The output will always use the
|
|
* alternate encoding/alphabet also known as "base64url".
|
|
* @param {!Uint8Array} arr
|
|
* @param {boolean=} opt_padding If true, pad the output with equals signs.
|
|
* Defaults to true.
|
|
* @return {string}
|
|
* @export
|
|
*/
|
|
shaka.util.Uint8ArrayUtils.toBase64 = function(arr, opt_padding) {
|
|
// btoa expects a "raw string" where each character is interpreted as a byte.
|
|
var bytes = String.fromCharCode.apply(null, arr);
|
|
var padding = (opt_padding == undefined) ? true : opt_padding;
|
|
var base64 = window.btoa(bytes).replace(/\+/g, '-').replace(/\//g, '_');
|
|
return padding ? base64 : base64.replace(/=*$/, '');
|
|
};
|
|
|
|
|
|
/**
|
|
* Convert a base64 string to a Uint8Array. Accepts either the standard
|
|
* alphabet or the alternate "base64url" alphabet.
|
|
* @param {string} str
|
|
* @return {!Uint8Array}
|
|
* @export
|
|
*/
|
|
shaka.util.Uint8ArrayUtils.fromBase64 = function(str) {
|
|
// atob creates a "raw string" where each character is interpreted as a byte.
|
|
var bytes = window.atob(str.replace(/-/g, '+').replace(/_/g, '/'));
|
|
var result = new Uint8Array(bytes.length);
|
|
for (var i = 0; i < bytes.length; ++i) {
|
|
result[i] = bytes.charCodeAt(i);
|
|
}
|
|
return result;
|
|
};
|
|
|
|
|
|
/**
|
|
* Convert a hex string to a Uint8Array.
|
|
* @param {string} str
|
|
* @return {!Uint8Array}
|
|
* @export
|
|
*/
|
|
shaka.util.Uint8ArrayUtils.fromHex = function(str) {
|
|
var arr = new Uint8Array(str.length / 2);
|
|
for (var i = 0; i < str.length; i += 2) {
|
|
arr[i / 2] = window.parseInt(str.substr(i, 2), 16);
|
|
}
|
|
return arr;
|
|
};
|
|
|
|
|
|
/**
|
|
* Convert a Uint8Array to a hex string.
|
|
* @param {!Uint8Array} arr
|
|
* @return {string}
|
|
* @export
|
|
*/
|
|
shaka.util.Uint8ArrayUtils.toHex = function(arr) {
|
|
var hex = '';
|
|
for (var i = 0; i < arr.length; ++i) {
|
|
var value = arr[i].toString(16);
|
|
if (value.length == 1) value = '0' + value;
|
|
hex += value;
|
|
}
|
|
return hex;
|
|
};
|
|
|
|
|
|
/**
|
|
* Compare two Uint8Arrays for equality.
|
|
* @param {Uint8Array} arr1
|
|
* @param {Uint8Array} arr2
|
|
* @return {boolean}
|
|
* @export
|
|
*/
|
|
shaka.util.Uint8ArrayUtils.equal = function(arr1, arr2) {
|
|
if (!arr1 && !arr2) return true;
|
|
if (!arr1 || !arr2) return false;
|
|
if (arr1.length != arr2.length) return false;
|
|
for (var i = 0; i < arr1.length; ++i) {
|
|
if (arr1[i] != arr2[i]) return false;
|
|
}
|
|
return true;
|
|
};
|