@l5i/dashjs
Version:
A reference client implementation for the playback of MPEG DASH via Javascript and compliant browsers.
121 lines (120 loc) • 7.2 kB
JavaScript
/**
* The copyright in this software is being made available under the BSD License,
* included below. This software may be subject to other third party and contributor
* rights, including patent rights, and no such rights are granted under this license.
*
* Copyright (c) 2013, Dash Industry Forum.
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
* * Redistributions of source code must retain the above copyright notice, this
* list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation and/or
* other materials provided with the distribution.
* * Neither the name of Dash Industry Forum nor the names of its
* contributors may be used to endorse or promote products derived from this software
* without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
* IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
* INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/'use strict';Object.defineProperty(exports,'__esModule',{value:true});function _interopRequireDefault(obj){return obj && obj.__esModule?obj:{'default':obj};}var _coreFactoryMaker=require('../../core/FactoryMaker');var _coreFactoryMaker2=_interopRequireDefault(_coreFactoryMaker); /**
* @module URLUtils
* @description Provides utility functions for operating on URLs.
* Initially this is simply a method to determine the Base URL of a URL, but
* should probably include other things provided all over the place such as
* determining whether a URL is relative/absolute, resolving two paths etc.
*/function URLUtils(){var resolveFunction=undefined;var schemeRegex=/^[a-z][a-z0-9+\-.]*:/i;var httpUrlRegex=/^https?:\/\//i;var httpsUrlRegex=/^https:\/\//i;var originRegex=/^([a-z][a-z0-9+\-.]*:\/\/[^\/]+)\/?/i; /**
* Resolves a url given an optional base url
* Uses window.URL to do the resolution.
*
* @param {string} url
* @param {string} [baseUrl]
* @return {string}
* @memberof module:URLUtils
* @instance
* @private
*/var nativeURLResolver=function nativeURLResolver(url,baseUrl){try{ // this will throw if baseurl is undefined, invalid etc
return new window.URL(url,baseUrl).toString();}catch(e) {return url;}}; /**
* Resolves a url given an optional base url
* Does not resolve ./, ../ etc but will do enough to construct something
* which will satisfy XHR etc when window.URL is not available ie
* IE11/node etc.
*
* @param {string} url
* @param {string} [baseUrl]
* @return {string}
* @memberof module:URLUtils
* @instance
* @private
*/var dumbURLResolver=function dumbURLResolver(url,baseUrl){var baseUrlParseFunc=parseBaseUrl;if(!baseUrl){return url;}if(!isRelative(url)){return url;}if(isPathAbsolute(url)){baseUrlParseFunc = parseOrigin;}if(isSchemeRelative(url)){baseUrlParseFunc = parseScheme;}var base=baseUrlParseFunc(baseUrl);var joinChar=base.charAt(base.length - 1) !== '/' && url.charAt(0) !== '/'?'/':'';return [base,url].join(joinChar);};function setup(){try{var u=new window.URL('x','http://y'); //jshint ignore:line
resolveFunction = nativeURLResolver;}catch(e) { // must be IE11/Node etc
}finally {resolveFunction = resolveFunction || dumbURLResolver;}} /**
* Returns a string that contains the Base URL of a URL, if determinable.
* @param {string} url - full url
* @return {string}
* @memberof module:URLUtils
* @instance
*/function parseBaseUrl(url){var slashIndex=url.indexOf('/');var lastSlashIndex=url.lastIndexOf('/');if(slashIndex !== -1){ // if there is only '//'
if(lastSlashIndex === slashIndex + 1){return url;}if(url.indexOf('?') !== -1){url = url.substring(0,url.indexOf('?'));}return url.substring(0,lastSlashIndex + 1);}return '';} /**
* Returns a string that contains the scheme and origin of a URL,
* if determinable.
* @param {string} url - full url
* @return {string}
* @memberof module:URLUtils
* @instance
*/function parseOrigin(url){var matches=url.match(originRegex);if(matches){return matches[1];}return '';} /**
* Returns a string that contains the scheme of a URL, if determinable.
* @param {string} url - full url
* @return {string}
* @memberof module:URLUtils
* @instance
*/function parseScheme(url){var matches=url.match(schemeRegex);if(matches){return matches[0];}return '';} /**
* Determines whether the url is relative.
* @return {bool}
* @param {string} url
* @memberof module:URLUtils
* @instance
*/function isRelative(url){return !schemeRegex.test(url);} /**
* Determines whether the url is path-absolute.
* @return {bool}
* @param {string} url
* @memberof module:URLUtils
* @instance
*/function isPathAbsolute(url){return isRelative(url) && url.charAt(0) === '/';} /**
* Determines whether the url is scheme-relative.
* @return {bool}
* @param {string} url
* @memberof module:URLUtils
* @instance
*/function isSchemeRelative(url){return url.indexOf('//') === 0;} /**
* Determines whether the url is an HTTP-URL as defined in ISO/IEC
* 23009-1:2014 3.1.15. ie URL with a fixed scheme of http or https
* @return {bool}
* @param {string} url
* @memberof module:URLUtils
* @instance
*/function isHTTPURL(url){return httpUrlRegex.test(url);} /**
* Determines whether the supplied url has https scheme
* @return {bool}
* @param {string} url
* @memberof module:URLUtils
* @instance
*/function isHTTPS(url){return httpsUrlRegex.test(url);} /**
* Resolves a url given an optional base url
* @return {string}
* @param {string} url
* @param {string} [baseUrl]
* @memberof module:URLUtils
* @instance
*/function resolve(url,baseUrl){return resolveFunction(url,baseUrl);}setup();var instance={parseBaseUrl:parseBaseUrl,parseOrigin:parseOrigin,parseScheme:parseScheme,isRelative:isRelative,isPathAbsolute:isPathAbsolute,isSchemeRelative:isSchemeRelative,isHTTPURL:isHTTPURL,isHTTPS:isHTTPS,resolve:resolve};return instance;}URLUtils.__dashjs_factory_name = 'URLUtils';exports['default'] = _coreFactoryMaker2['default'].getSingletonFactory(URLUtils);module.exports = exports['default'];
//# sourceMappingURL=URLUtils.js.map