jii/helpers/Url.js

Jii - Full-Stack JavaScript Framework

/**
 * @author Vladimir Kozhin <affka@affka.ru>
 * @license MIT
 */


'use strict';

const Jii = require('../BaseJii');
const _trim = require('lodash/trim');
const _isObject = require('lodash/isObject');
const _isString = require('lodash/isString');
const _isArray = require('lodash/isArray');
const BaseObject = require('../base/BaseObject');

class Url extends BaseObject {

    /**
     * Returns a value indicating whether a URL is relative.
     * A relative URL does not have host info part.
     * @param {string} url the URL to be checked
     * @returns {boolean} whether the URL is relative
     */
    static isRelative(url) {
        return url.indexOf('//') !== 0 && url.indexOf('://') === -1;
    }

    static to(url, context, scheme) {
        if (_isObject(url)) {
            return Url.toRoute(url, context, scheme);
        }

        return url;
        // @todo
        /*$url = Yii::getAlias($url);
         if ($url === '') {
         $url = Yii::$app->getRequest()->getUrl();
         }

         if (!$scheme) {
         return $url;
         }

         if (strncmp($url, '//', 2) === 0) {
         // e.g. //hostname/path/to/resource
         return is_string($scheme) ? "$scheme:$url" : $url;
         }

         if (($pos = strpos($url, ':')) === false || !ctype_alpha(substr($url, 0, $pos))) {
         // turn relative URL into absolute
         $url = static::getUrlManager()->getHostInfo() . '/' . ltrim($url, '/');
         }

         if (is_string($scheme) && ($pos = strpos($url, ':')) !== false) {
         // replace the scheme with the specified one
         $url = $scheme . substr($url, $pos);
         }

         return $url;*/
    }

    static toRoute(route, context, scheme) {
        scheme = scheme || false;

        if (!_isObject(route)) {
            route = [route];
        }

        return scheme ? Url._getUrlManager().createAbsoluteUrl(route, context, _isString(scheme) ? scheme : null) : Url._getUrlManager().createUrl(route, context);
    }

    /**
     *
     * @returns {UrlManager}
     * @private
     */
    static _getUrlManager() {
        return this.constructor.urlManager || Jii.app.urlManager;
    }

    /**
     *
     * @param {string|array|object} route
     * @param {Context} context
     * @returns {{route: string, params: {}}}
     */
    static parseRoute(route, context) {
        var params = {};

        // Format ['site/index', {foo: 'bar'}]
        if (_isArray(route)) {
            if (_isObject(route[1]) && route.length === 2) {
                params = route[1];
            }
            route = route[0];
        }

        // Format {0:'site/index', foo: 'bar'}
        if (_isObject(route)) {
            params = route;
            route = params[0] || '';
            delete params[0];
        }

        return {
            route: this._normalizeRoute(route, context),
            params: params
        };
    }

    static _normalizeRoute(route, context) {
        route = Jii.getAlias(route);
        if (route.substr(0, 1) === '/') {
            // absolute route
            return _trim(route, '/');
        }

        return route;
        // relative route
        // @todo
        /*if (!Jii.app || controller === null) {
         throw new InvalidParamException("Unable to resolve the relative route: $route. No active controller is available.");
         }

         if (strpos($route, '/') === false) {
         // empty or an action ID
         return $route === '' ? Yii::$app->controller->getRoute() : Yii::$app->controller->getUniqueId() . '/' . $route;
         } else {
         // relative to module
         return ltrim(Yii::$app->controller->module->getUniqueId() . '/' . $route, '/');
         }*/
    }

}

/**
 * @type {UrlManager}
 */
Url.urlManager = null;
module.exports = Url;