/** * @author Richard Davey * @copyright 2016 Photon Storm Ltd. * @license {@link https://github.com/photonstorm/phaser/blob/master/license.txt|MIT License} */ /** * Phaser.Net handles browser URL related tasks such as checking host names, domain names and query string manipulation. * * @class Phaser.Net * @constructor * @param {Phaser.Game} game - A reference to the currently running game. */ Phaser.Net = function (game) { this.game = game; }; Phaser.Net.prototype = { /** * Returns the hostname given by the browser. * * @method Phaser.Net#getHostName * @return {string} */ getHostName: function () { if (window.location && window.location.hostname) { return window.location.hostname; } return null; }, /** * Compares the given domain name against the hostname of the browser containing the game. * If the domain name is found it returns true. * You can specify a part of a domain, for example 'google' would match 'google.com', 'google.co.uk', etc. * Do not include 'http://' at the start. * * @method Phaser.Net#checkDomainName * @param {string} domain * @return {boolean} true if the given domain fragment can be found in the window.location.hostname */ checkDomainName: function (domain) { return window.location.hostname.indexOf(domain) !== -1; }, /** * Updates a value on the Query String and returns it in full. * If the value doesn't already exist it is set. * If the value exists it is replaced with the new value given. If you don't provide a new value it is removed from the query string. * Optionally you can redirect to the new url, or just return it as a string. * * @method Phaser.Net#updateQueryString * @param {string} key - The querystring key to update. * @param {string} value - The new value to be set. If it already exists it will be replaced. * @param {boolean} redirect - If true the browser will issue a redirect to the url with the new querystring. * @param {string} url - The URL to modify. If none is given it uses window.location.href. * @return {string} If redirect is false then the modified url and query string is returned. */ updateQueryString: function (key, value, redirect, url) { if (redirect === undefined) { redirect = false; } if (url === undefined || url === '') { url = window.location.href; } var output = ''; var re = new RegExp("([?|&])" + key + "=.*?(&|#|$)(.*)", "gi"); if (re.test(url)) { if (typeof value !== 'undefined' && value !== null) { output = url.replace(re, '$1' + key + "=" + value + '$2$3'); } else { output = url.replace(re, '$1$3').replace(/(&|\?)$/, ''); } } else { if (typeof value !== 'undefined' && value !== null) { var separator = url.indexOf('?') !== -1 ? '&' : '?'; var hash = url.split('#'); url = hash[0] + separator + key + '=' + value; if (hash[1]) { url += '#' + hash[1]; } output = url; } else { output = url; } } if (redirect) { window.location.href = output; } else { return output; } }, /** * Returns the Query String as an object. * If you specify a parameter it will return just the value of that parameter, should it exist. * * @method Phaser.Net#getQueryString * @param {string} [parameter=''] - If specified this will return just the value for that key. * @return {string|object} An object containing the key value pairs found in the query string or just the value if a parameter was given. */ getQueryString: function (parameter) { if (parameter === undefined) { parameter = ''; } var output = {}; var keyValues = location.search.substring(1).split('&'); for (var i in keyValues) { var key = keyValues[i].split('='); if (key.length > 1) { if (parameter && parameter === this.decodeURI(key[0])) { return this.decodeURI(key[1]); } else { output[this.decodeURI(key[0])] = this.decodeURI(key[1]); } } } return output; }, /** * Takes a Uniform Resource Identifier (URI) component (previously created by encodeURIComponent or by a similar routine) and * decodes it, replacing \ with spaces in the return. Used internally by the Net classes. * * @method Phaser.Net#decodeURI * @param {string} value - The URI component to be decoded. * @return {string} The decoded value. */ decodeURI: function (value) { return decodeURIComponent(value.replace(/\+/g, " ")); } }; Phaser.Net.prototype.constructor = Phaser.Net;