@uirouter/core
Version:
UI-Router Core: Framework agnostic, State-based routing for JavaScript Single Page Apps
138 lines • 5.04 kB
JavaScript
/**
* Functions that manipulate strings
*
* Although these functions are exported, they are subject to change without notice.
*
* @packageDocumentation
*/
import { isArray, isFunction, isInjectable, isNull, isObject, isPromise, isString, isUndefined } from './predicates';
import { Rejection } from '../transition/rejectFactory';
import { identity, pushR, tail } from './common';
import { pattern, val } from './hof';
/**
* Returns a string shortened to a maximum length
*
* If the string is already less than the `max` length, return the string.
* Else return the string, shortened to `max - 3` and append three dots ("...").
*
* @param max the maximum length of the string to return
* @param str the input string
*/
export function maxLength(max, str) {
if (str.length <= max)
return str;
return str.substr(0, max - 3) + '...';
}
/**
* Returns a string, with spaces added to the end, up to a desired str length
*
* If the string is already longer than the desired length, return the string.
* Else returns the string, with extra spaces on the end, such that it reaches `length` characters.
*
* @param length the desired length of the string to return
* @param str the input string
*/
export function padString(length, str) {
while (str.length < length)
str += ' ';
return str;
}
export function kebobString(camelCase) {
return camelCase
.replace(/^([A-Z])/, function ($1) { return $1.toLowerCase(); }) // replace first char
.replace(/([A-Z])/g, function ($1) { return '-' + $1.toLowerCase(); }); // replace rest
}
export function functionToString(fn) {
var fnStr = fnToString(fn);
var namedFunctionMatch = fnStr.match(/^(function [^ ]+\([^)]*\))/);
var toStr = namedFunctionMatch ? namedFunctionMatch[1] : fnStr;
var fnName = fn['name'] || '';
if (fnName && toStr.match(/function \(/)) {
return 'function ' + fnName + toStr.substr(9);
}
return toStr;
}
export function fnToString(fn) {
var _fn = isArray(fn) ? fn.slice(-1)[0] : fn;
return (_fn && _fn.toString()) || 'undefined';
}
export function stringify(o) {
var seen = [];
var isRejection = Rejection.isRejectionPromise;
var hasToString = function (obj) {
return isObject(obj) && !isArray(obj) && obj.constructor !== Object && isFunction(obj.toString);
};
var stringifyPattern = pattern([
[isUndefined, val('undefined')],
[isNull, val('null')],
[isPromise, val('[Promise]')],
[isRejection, function (x) { return x._transitionRejection.toString(); }],
[hasToString, function (x) { return x.toString(); }],
[isInjectable, functionToString],
[val(true), identity],
]);
function format(value) {
if (isObject(value)) {
if (seen.indexOf(value) !== -1)
return '[circular ref]';
seen.push(value);
}
return stringifyPattern(value);
}
if (isUndefined(o)) {
// Workaround for IE & Edge Spec incompatibility where replacer function would not be called when JSON.stringify
// is given `undefined` as value. To work around that, we simply detect `undefined` and bail out early by
// manually stringifying it.
return format(o);
}
return JSON.stringify(o, function (key, value) { return format(value); }).replace(/\\"/g, '"');
}
/** Returns a function that splits a string on a character or substring */
export var beforeAfterSubstr = function (char) {
return function (str) {
if (!str)
return ['', ''];
var idx = str.indexOf(char);
if (idx === -1)
return [str, ''];
return [str.substr(0, idx), str.substr(idx + 1)];
};
};
export var hostRegex = new RegExp('^(?:[a-z]+:)?//[^/]+/');
export var stripLastPathElement = function (str) { return str.replace(/\/[^/]*$/, ''); };
export var splitHash = beforeAfterSubstr('#');
export var splitQuery = beforeAfterSubstr('?');
export var splitEqual = beforeAfterSubstr('=');
export var trimHashVal = function (str) { return (str ? str.replace(/^#/, '') : ''); };
/**
* Splits on a delimiter, but returns the delimiters in the array
*
* #### Example:
* ```js
* var splitOnSlashes = splitOnDelim('/');
* splitOnSlashes("/foo"); // ["/", "foo"]
* splitOnSlashes("/foo/"); // ["/", "foo", "/"]
* ```
*/
export function splitOnDelim(delim) {
var re = new RegExp('(' + delim + ')', 'g');
return function (str) { return str.split(re).filter(identity); };
}
/**
* Reduce fn that joins neighboring strings
*
* Given an array of strings, returns a new array
* where all neighboring strings have been joined.
*
* #### Example:
* ```js
* let arr = ["foo", "bar", 1, "baz", "", "qux" ];
* arr.reduce(joinNeighborsR, []) // ["foobar", 1, "bazqux" ]
* ```
*/
export function joinNeighborsR(acc, x) {
if (isString(tail(acc)) && isString(x))
return acc.slice(0, -1).concat(tail(acc) + x);
return pushR(acc, x);
}
//# sourceMappingURL=strings.js.map