githubmirror/brackets

src/utils/UrlParams.js
122 строки4 KB
Lance Campbell
Fix _store initialization in public method parse()
21 дек 2013, 21:33
21 дек 2013, 21:3344d8b9d
/*
 * Copyright (c) 2012 Adobe Systems Incorporated. All rights reserved.
 *  
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"), 
 * to deal in the Software without restriction, including without limitation 
 * the rights to use, copy, modify, merge, publish, distribute, sublicense, 
 * and/or sell copies of the Software, and to permit persons to whom the 
 * Software is furnished to do so, subject to the following conditions:
 *  
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *  
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
 * DEALINGS IN THE SOFTWARE.
 * 
 */


/*jslint vars: true, plusplus: true, devel: true, nomen: true, indent: 4, maxerr: 50 */
/*global define, window */

define(function (require, exports, module) {
    "use strict";
    
    var _ = require("thirdparty/lodash");
    
    /**
     * Convert between URL querystring and name/value pairs. Decodes and encodes URL parameters.
     */
    function UrlParams() {
        this._store = {};
    }
    
    /**
     * Parse the window location by default. Optionally specify a URL to parse.
     * @param {string} url
     */
    UrlParams.prototype.parse = function (url) {
        var queryString = "",
            urlParams,
            p,
            self = this;
        
        self._store = {};
        
        if (!url) {
            queryString = window.document.location.search.substring(1);
        } else if (url.indexOf("?") !== -1) {
            queryString = url.substring(url.indexOf("?") + 1);
        }
        
        queryString = queryString.trimRight();
        
        if (queryString) {
            urlParams = queryString.split("&");
            
            urlParams.forEach(function (param) {
                p = param.split("=");
                p[1] = p[1] || "";
                self._store[decodeURIComponent(p[0])] = decodeURIComponent(p[1]);
            });
        }
    };
    
    /**
     * Store a name/value string pair
     * @param {!string} name
     * @param {!string} value
     */
    UrlParams.prototype.put = function (name, value) {
        this._store[name] = value;
    };
    
    /**
     * Retrieve a value by name
     * @param {!string} name
     * @return {string}
     */
    UrlParams.prototype.get = function (name) {
        return this._store[name];
    };
    
    /**
     * Remove a name/value string pair
     * @param {!string} name
     */
    UrlParams.prototype.remove = function (name) {
        delete this._store[name];
    };
    
    /**
     * Returns true if the parameter list is empty, else returns false.
     * @return {boolean}
     */
    UrlParams.prototype.isEmpty = function (name) {
        return _.isEmpty(this._store);
    };
    
    /**
     * Encode name/value pairs as URI components.
     * @return {string}
     */
    UrlParams.prototype.toString = function () {
        var strs = [],
            self = this;
        
        _.forEach(self._store, function (value, key) {
            strs.push(encodeURIComponent(key) + "=" + encodeURIComponent(value));
        });
        
        return strs.join("&");
    };
    
    // Define public API
    exports.UrlParams = UrlParams;
});