xe-utils
Version:
JavaScript 函数库、工具类
2,340 lines (1,878 loc) • 119 kB
JavaScript
/**
* xe-utils.js v3.7.8
* MIT License.
* @preserve
*/
(function (global, factory) {
typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
typeof define === 'function' && define.amd ? define(factory) :
(global.XEUtils = factory());
}(this, function () {'use strict'
var setupDefaults = {
keyId: 1,
cookies: {
path: '/'
},
treeOptions: {
parentKey: 'parentId',
key: 'id',
children: 'children'
},
parseDateFormat: 'yyyy-MM-dd HH:mm:ss',
firstDayOfWeek: 1
}
var XEUtils = function () {}
function mixin () {
arrayEach(arguments, function (methods) {
each(methods, function (fn, name) {
XEUtils[name] = isFunction(fn) ? function () {
var result = fn.apply(XEUtils.$context, arguments)
XEUtils.$context = null
return result
} : fn
})
})
}
function setConfig (options) {
return assign(setupDefaults, options)
}
function getConfig () {
return setupDefaults
}
var version = '3.7.8'
XEUtils.VERSION = version
XEUtils.version = version
XEUtils.mixin = mixin
XEUtils.setup = setConfig
XEUtils.setConfig = setConfig
XEUtils.getConfig = getConfig
function helperCheckCopyKey (key) {
return key !== '__proto__' && key !== 'constructor'
}
var nextStartMaps = map(range(0, 7), function (day) {
return [(day + 1) % 7, (day + 2) % 7, (day + 3) % 7]
})
function matchWeekStartDay (time, viewStartDay) {
var day = new Date(time).getDay()
return includes(nextStartMaps[viewStartDay], day)
}
function helperCreateGetDateWeek (getStartDate, checkCrossDate) {
return function (date, firstDay) {
var viewStartDay = isNumber(firstDay) ? firstDay : setupDefaults.firstDayOfWeek
var targetDate = toStringDate(date)
if (isValidDate(targetDate)) {
var targetWeekStartDate = getWhatWeek(targetDate, 0, viewStartDay, viewStartDay)
var firstDate = getStartDate(targetWeekStartDate)
var firstTime = helperGetDateTime(firstDate)
var targetWeekStartTime = helperGetDateTime(targetWeekStartDate)
var targetWeekEndTime = targetWeekStartTime + staticDayTime * 6
var targetWeekEndDate = new Date(targetWeekEndTime)
var firstWeekStartDate = getWhatWeek(firstDate, 0, viewStartDay, viewStartDay)
var firstWeekStartTime = helperGetDateTime(firstWeekStartDate)
var tempTime
if (targetWeekStartTime === firstWeekStartTime) {
return 1
}
if (checkCrossDate(targetWeekStartDate, targetWeekEndDate)) {
tempTime = helperGetDateTime(getStartDate(targetWeekEndDate))
for (; tempTime < targetWeekEndTime; tempTime += staticDayTime) {
if (matchWeekStartDay(tempTime, viewStartDay)) {
return 1
}
}
}
var firstWeekEndTime = firstWeekStartTime + staticDayTime * 6
var firstWeekEndDate = new Date(targetWeekEndTime)
var offsetNum = 1
if (checkCrossDate(firstWeekStartDate, firstWeekEndDate)) {
offsetNum = 0
tempTime = firstTime
for (; tempTime < firstWeekEndTime; tempTime += staticDayTime) {
if (matchWeekStartDay(tempTime, viewStartDay)) {
offsetNum++
break
}
}
}
return Math.floor((targetWeekStartTime - firstWeekStartTime) / staticWeekTime) + offsetNum
}
return NaN
}
}
function helperCreateGetObjects (name, getIndex) {
var proMethod = Object[name]
return function (obj) {
var result = []
if (obj) {
if (proMethod) {
return proMethod(obj)
}
each(obj, getIndex > 1 ? function (key) {
result.push(['' + key, obj[key]])
} : function () {
result.push(arguments[getIndex])
})
}
return result
}
}
function helperCreateIndexOf (name, callback) {
return function (obj, val) {
if (obj) {
if (obj[name]) {
return obj[name](val)
}
if (isString(obj) || isArray(obj)) {
return callback(obj, val)
}
for (var key in obj) {
if (hasOwnProp(obj, key)) {
if (val === obj[key]) {
return key
}
}
}
}
return -1
}
}
function helperCreateInInObjectString (type) {
return function (obj) {
return '[object ' + type + ']' === objectToString.call(obj)
}
}
/* eslint-disable valid-typeof */
function helperCreateInTypeof (type) {
return function (obj) {
return typeof obj === type
}
}
function helperCreateIterateHandle (prop, useArray, restIndex, matchValue, defaultValue) {
return function (obj, iterate, context) {
if (obj && iterate) {
if (prop && obj[prop]) {
return obj[prop](iterate, context)
} else {
if (useArray && isArray(obj)) {
for (var index = 0, len = obj.length; index < len; index++) {
if (!!iterate.call(context, obj[index], index, obj) === matchValue) {
return [true, false, index, obj[index]][restIndex]
}
}
} else {
for (var key in obj) {
if (hasOwnProp(obj, key)) {
if (!!iterate.call(context, obj[key], key, obj) === matchValue) {
return [true, false, key, obj[key]][restIndex]
}
}
}
}
}
}
return defaultValue
}
}
function helperCreateiterateIndexOf (callback) {
return function (obj, iterate, context) {
if (obj && isFunction(iterate)) {
if (isArray(obj) || isString(obj)) {
return callback(obj, iterate, context)
}
for (var key in obj) {
if (hasOwnProp(obj, key)) {
if (iterate.call(context, obj[key], key, obj)) {
return key
}
}
}
}
return -1
}
}
function helperCreateMathNumber(name) {
return function (num, digits) {
var numRest = toNumber(num)
var rest = numRest
if (numRest) {
digits = digits >> 0
var numStr = toNumberString(numRest)
var nums = numStr.split('.')
var intStr = nums[0]
var floatStr = nums[1] || ''
var fStr = floatStr.substring(0, digits + 1)
var subRest = intStr + (fStr ? ('.' + fStr) : '')
if (digits >= floatStr.length) {
return toNumber(subRest)
}
subRest = numRest
if (digits > 0) {
var ratio = Math.pow(10, digits)
rest = Math[name](helperMultiply(subRest, ratio)) / ratio
} else {
rest = Math[name](subRest)
}
}
return rest
}
}
function helperCreateMinMax (handle) {
return function (arr, iterate) {
if (arr && arr.length) {
var rest, itemIndex
arrayEach(arr, function (itemVal, index) {
if (iterate) {
itemVal = isFunction(iterate) ? iterate(itemVal, index, arr) : get(itemVal, iterate)
}
if (!eqNull(itemVal) && (eqNull(rest) || handle(rest, itemVal))) {
itemIndex = index
rest = itemVal
}
})
return arr[itemIndex]
}
return rest
}
}
function helperCreatePickOmit (case1, case2) {
return function (obj, callback) {
var item, index
var rest = {}
var result = []
var context = this
var args = arguments
var len = args.length
if (!isFunction(callback)) {
for (index = 1; index < len; index++) {
item = args[index]
result.push.apply(result, isArray(item) ? item : [item])
}
callback = 0
}
each(obj, function (val, key) {
if ((callback ? callback.call(context, val, key, obj) : findIndexOf(result, function (name) {
return name === key
}) > -1) ? case1 : case2) {
rest[key] = val
}
})
return rest
}
}
function helperCreateToNumber (handle) {
return function (str) {
if (str) {
var num = handle(str && str.replace ? str.replace(/,/g, '') : str)
if (!isNaN(num)) {
return num
}
}
return 0
}
}
function helperCreateTreeFunc (handle) {
return function (obj, iterate, options, context) {
var opts = options || {}
var optChildren = opts.children || 'children'
return handle(null, obj, iterate, context, [], [], optChildren, opts)
}
}
function helperDefaultCompare (v1, v2) {
return v1 === v2
}
function helperDeleteProperty (obj, property) {
try {
delete obj[property]
} catch (e) {
obj[property] = undefined
}
}
function helperEqualCompare (val1, val2, compare, func, key, obj1, obj2) {
if (val1 === val2) {
return true
}
if (val1 && val2 && !isNumber(val1) && !isNumber(val2) && !isString(val1) && !isString(val2)) {
if (isRegExp(val1)) {
return compare('' + val1, '' + val2, key, obj1, obj2)
} if (isDate(val1) || isBoolean(val1)) {
return compare(+val1, +val2, key, obj1, obj2)
} else {
var result, val1Keys, val2Keys
var isObj1Arr = isArray(val1)
var isObj2Arr = isArray(val2)
if (isObj1Arr || isObj2Arr ? isObj1Arr && isObj2Arr : val1.constructor === val2.constructor) {
val1Keys = keys(val1)
val2Keys = keys(val2)
if (func) {
result = func(val1, val2, key)
}
if (val1Keys.length === val2Keys.length) {
return isUndefined(result) ? every(val1Keys, function (key, index) {
return key === val2Keys[index] && helperEqualCompare(val1[key], val2[val2Keys[index]], compare, func, isObj1Arr || isObj2Arr ? index : key, val1, val2)
}) : !!result
}
return false
}
}
}
return compare(val1, val2, key, obj1, obj2)
}
function helperFormatEscaper (dataMap) {
var replaceRegexp = new RegExp('(?:' + keys(dataMap).join('|') + ')', 'g')
return function (str) {
return toValueString(str).replace(replaceRegexp, function (match) {
return dataMap[match]
})
}
}
function helperGetDateFullYear (date) {
return date.getFullYear()
}
function helperGetDateMonth (date) {
return date.getMonth()
}
function helperGetDateTime (date) {
return date.getTime()
}
function helperGetHGSKeys (property) {
// 以最快的方式判断数组,可忽略准确性
return property ? (property.splice && property.join ? property : ('' + property).replace(/(\[\d+\])\.?/g,'$1.').replace(/\.$/, '').split('.')) : []
}
function helperGetLocatOrigin () {
return staticLocation ? (staticLocation.origin || (staticLocation.protocol + '//' + staticLocation.host)) : ''
}
function helperGetUTCDateTime (resMaps) {
return Date.UTC(resMaps.y, resMaps.M || 0, resMaps.d || 1, resMaps.H || 0, resMaps.m || 0, resMaps.s || 0, resMaps.S || 0)
}
function helperGetYMD (date) {
return new Date(helperGetDateFullYear(date), helperGetDateMonth(date), date.getDate())
}
function helperGetYMDTime (date) {
return helperGetDateTime(helperGetYMD(date))
}
function helperLog (type, msg) {
return (console[type] || console.log)(msg)
}
function helperMultiply (multiplier, multiplicand) {
var str1 = toNumberString(multiplier)
var str2 = toNumberString(multiplicand)
return parseInt(str1.replace('.', '')) * parseInt(str2.replace('.', '')) / Math.pow(10, helperNumberDecimal(str1) + helperNumberDecimal(str2))
}
function helperNewDate () {
return new Date()
}
function helperNumberAdd (addend, augend) {
var str1 = toNumberString(addend)
var str2 = toNumberString(augend)
var ratio = Math.pow(10, Math.max(helperNumberDecimal(str1), helperNumberDecimal(str2)))
return (multiply(addend, ratio) + multiply(augend, ratio)) / ratio
}
function helperNumberDecimal (numStr) {
return (numStr.split('.')[1] || '').length
}
function helperNumberDivide (divisor, dividend) {
var str1 = toNumberString(divisor)
var str2 = toNumberString(dividend)
var divisorDecimal = helperNumberDecimal(str1)
var dividendDecimal = helperNumberDecimal(str2)
var powY = dividendDecimal - divisorDecimal
var isMinus = powY < 0
var multiplicand = Math.pow(10, isMinus ? Math.abs(powY) : powY)
return multiply(str1.replace('.', '') / str2.replace('.', ''), isMinus ? 1 / multiplicand : multiplicand)
}
function helperNumberOffsetPoint (str, offsetIndex) {
return str.substring(0, offsetIndex) + '.' + str.substring(offsetIndex, str.length)
}
function helperStringLowerCase (str) {
return str.toLowerCase()
}
function helperStringRepeat (str, count) {
if (str.repeat) {
return str.repeat(count)
}
var list = isNaN(count) ? [] : new Array(staticParseInt(count))
return list.join(str) + (list.length > 0 ? str : '')
}
function helperStringSubstring (str, start, end) {
return str.substring(start, end)
}
function helperStringUpperCase (str) {
return str.toUpperCase()
}
var staticStrUndefined = 'undefined'
var staticStrLast = 'last'
var staticStrFirst = 'first'
var staticDayTime = 86400000
var staticWeekTime = staticDayTime * 7
/* eslint-disable valid-typeof */
var staticLocation = typeof location === staticStrUndefined ? 0 : location
/* eslint-disable valid-typeof */
var staticWindow = typeof window === staticStrUndefined ? 0 : window
/* eslint-disable valid-typeof */
var staticDocument = typeof document === staticStrUndefined ? 0 : document
var staticEncodeURIComponent = encodeURIComponent
var staticDecodeURIComponent = decodeURIComponent
var objectToString = Object.prototype.toString
var staticParseInt = parseInt
var staticEscapeMap = {
'&': '&',
'<': '<',
'>': '>',
'"': '"',
"'": ''',
'`': '`'
}
var staticHGKeyRE = /(.+)?\[(\d+)\]$/
var objectAssignFns = Object.assign
function handleAssign (destination, args, isClone) {
var len = args.length
for (var source, index = 1; index < len; index++) {
source = args[index]
arrayEach(keys(args[index]), isClone ? function (key) {
destination[key] = clone(source[key], isClone)
} : function (key) {
destination[key] = source[key]
})
}
return destination
}
/**
* 将一个或多个源对象复制到目标对象中
*
* @param {Object} target 目标对象
* @param {...Object}
* @return {Boolean}
*/
var assign = function (target) {
if (target) {
var args = arguments
if (target === true) {
if (args.length > 1) {
target = isArray(target[1]) ? [] : {}
return handleAssign(target, args, true)
}
} else {
return objectAssignFns ? objectAssignFns.apply(Object, args) : handleAssign(target, args)
}
}
return target
}
/**
* 指定方法后的返回值组成的新对象
*
* @param {Object} obj 对象/数组
* @param {Function} iterate(item, index, obj) 回调
* @param {Object} context 上下文
* @return {Object}
*/
function objectMap (obj, iterate, context) {
var result = {}
if (obj) {
if (iterate) {
if (!isFunction(iterate)) {
iterate = property(iterate)
}
each(obj, function (val, index) {
result[index] = iterate.call(context, val, index, obj)
})
} else {
return obj
}
}
return result
}
function objectEach (obj, iterate, context) {
if (obj) {
for (var key in obj) {
if (hasOwnProp(obj, key)) {
iterate.call(context, obj[key], key, obj)
}
}
}
}
function lastObjectEach (obj, iterate, context) {
lastArrayEach(keys(obj), function (key) {
iterate.call(context, obj[key], key, obj)
})
}
function handleMerge (target, source) {
if ((isPlainObject(target) && isPlainObject(source)) || (isArray(target) && isArray(source))) {
each(source, function (val, key) {
if (helperCheckCopyKey(key)) {
target[key] = isFunction(source) ? val : handleMerge(target[key], val)
}
})
return target
}
return source
}
/**
* 将一个或多个源对象合并到目标对象中
*
* @param {Object} target 目标对象
* @param {...Object}
* @return {Boolean}
*/
var merge = function (target) {
if (!target) {
target = {}
}
var args = arguments
var len = args.length
for (var source, index = 1; index < len; index++) {
source = args[index]
if (source) {
handleMerge(target, source)
}
}
return target
}
/**
* 数组去重
*
* @param {*} array 数组
* @param {*} iterate 字段或回调
* @param {*} context
* @returns
*/
function uniq (array, iterate, context) {
var result = []
if (iterate) {
if (!isFunction(iterate)) {
iterate = property(iterate)
}
var val, valMap = {}
each(array, function (item, key) {
val = iterate.call(context, item, key, array)
if (!valMap[val]) {
valMap[val] = 1
result.push(item)
}
})
} else {
each(array, function (value) {
if (!includes(result, value)) {
result.push(value)
}
})
}
return result
}
/**
* 将多个数的值返回唯一的并集数组
*
* @param {...Array} 数组
* @return {Array}
*/
function union () {
var args = arguments
var result = []
var index = 0
var len = args.length
for (; index < len; index++) {
result = result.concat(toArray(args[index]))
}
return uniq(result)
}
var sortBy = orderBy
var ORDER_PROP_ASC = 'asc'
var ORDER_PROP_DESC = 'desc'
// function handleSort (v1, v2) {
// return v1 > v2 ? 1 : -1
// }
// '' < 数字 < 字符 < null < undefined
function handleSort (v1, v2) {
if (isUndefined(v1)) {
return 1
}
if (isNull(v1)) {
return isUndefined(v2) ? -1 : 1
}
return v1 && v1.localeCompare ? v1.localeCompare(v2) : (v1 > v2 ? 1 : -1)
}
function buildMultiOrders (name, confs, compares) {
return function (item1, item2) {
var v1 = item1[name]
var v2 = item2[name]
if (v1 === v2) {
return compares ? compares(item1, item2) : 0
}
return confs.order === ORDER_PROP_DESC ? handleSort(v2, v1) : handleSort(v1, v2)
}
}
function getSortConfs (arr, list, fieldConfs, context) {
var sortConfs = []
fieldConfs = isArray(fieldConfs) ? fieldConfs : [fieldConfs]
arrayEach(fieldConfs, function (handle, index) {
if (handle) {
var field = handle
var order
if (isArray(handle)) {
field = handle[0]
order = handle[1]
} else if (isPlainObject(handle)) {
field = handle.field
order = handle.order
}
sortConfs.push({
field: field,
order: order || ORDER_PROP_ASC
})
arrayEach(list, isFunction(field) ? function (item, key) {
item[index] = field.call(context, item.data, key, arr)
} : function (item) {
item[index] = field ? get(item.data, field) : item.data
})
}
})
return sortConfs
}
/**
* 将数组进行排序
*
* @param {Array} arr 数组
* @param {Function/String/Array} fieldConfs 方法或属性
* @param {Object} context 上下文
* @return {Array}
*/
function orderBy (arr, fieldConfs, context) {
if (arr) {
if (eqNull(fieldConfs)) {
return toArray(arr).sort(handleSort)
}
var compares
var list = map(arr, function (item) {
return { data: item }
})
var sortConfs = getSortConfs(arr, list, fieldConfs, context)
var len = sortConfs.length - 1
while (len >= 0) {
compares = buildMultiOrders(len, sortConfs[len], compares)
len--
}
if (compares) {
list = list.sort(compares)
}
return map(list, property('data'))
}
return []
}
/**
* 将一个数组随机打乱,返回一个新的数组
*
* @param {Array} array 数组
* @return {Array}
*/
function shuffle (array) {
var index
var result = []
var list = values(array)
var len = list.length - 1
for (; len >= 0; len--) {
index = len > 0 ? random(0, len) : 0
result.push(list[index])
list.splice(index, 1)
}
return result
}
/**
* 从一个数组中随机返回几个元素
*
* @param {Array} array 数组
* @param {Number} number 个数
* @return {Array}
*/
function sample (array, number) {
var result = shuffle(array)
if (arguments.length <= 1) {
return result[0]
}
if (number < result.length) {
result.length = number || 0
}
return result
}
/**
* 对象中的值中的每一项运行给定函数,如果函数对任一项返回true,则返回true,否则返回false
*
* @param {Object} obj 对象/数组
* @param {Function} iterate(item, index, obj) 回调
* @param {Object} context 上下文
* @return {Boolean}
*/
var some = helperCreateIterateHandle('some', 1, 0, true, false)
/**
* 对象中的值中的每一项运行给定函数,如果该函数对每一项都返回true,则返回true,否则返回false
*
* @param {Object} obj 对象/数组
* @param {Function} iterate(item, index, obj) 回调
* @param {Object} context 上下文
* @return {Boolean}
*/
var every = helperCreateIterateHandle('every', 1, 1, false, true)
/**
* 裁剪 Arguments 或数组 array,从 start 位置开始到 end 结束,但不包括 end 本身的位置
* @param {Array/Arguments} array 数组或Arguments
* @param {Number} startIndex 开始索引
* @param {Number} endIndex 结束索引
*/
function slice (array, startIndex, endIndex) {
var result = []
var argsSize = arguments.length
if (array) {
startIndex = argsSize >= 2 ? toNumber(startIndex) : 0
endIndex = argsSize >= 3 ? toNumber(endIndex) : array.length
if (array.slice) {
return array.slice(startIndex, endIndex)
}
for (; startIndex < endIndex; startIndex++) {
result.push(array[startIndex])
}
}
return result
}
/**
* 根据回调过滤数据
*
* @param {Object} obj 对象/数组
* @param {Function} iterate(item, index, obj) 回调
* @param {Object} context 上下文
* @return {Object}
*/
function filter (obj, iterate, context) {
var result = []
if (obj && iterate) {
if (obj.filter) {
return obj.filter(iterate, context)
}
each(obj, function (val, key) {
if (iterate.call(context, val, key, obj)) {
result.push(val)
}
})
}
return result
}
/**
* 从左至右遍历,匹配最近的一条数据
*
* @param {Object} obj 对象/数组
* @param {Function} iterate(item, index, obj) 回调
* @param {Object} context 上下文
* @return {Object}
*/
var find = helperCreateIterateHandle('find', 1, 3, true)
/**
* 从右至左遍历,匹配最近的一条数据
*
* @param {Object} obj 对象/数组
* @param {Function} iterate(item, index, obj) 回调
* @param {Object} context 上下文
* @return {Object}
*/
function findLast (obj, iterate, context) {
if (obj) {
if (!isArray(obj)) {
obj = values(obj)
}
for (var len = obj.length - 1; len >= 0; len--) {
if (iterate.call(context, obj[len], len, obj)) {
return obj[len]
}
}
}
}
/**
* 查找匹配第一条数据的键
*
* @param {Object} obj 对象/数组
* @param {Function} iterate(item, index, obj) 回调
* @param {Object} context 上下文
* @return {Object}
*/
var findKey = helperCreateIterateHandle('', 0, 2, true)
/**
* 判断对象是否包含该值,成功返回true否则false
*
* @param {Object} obj 对象
* @param {Object} val 值
* @return {Boolean}
*/
function includes (obj, val) {
if (obj) {
if (obj.includes) {
return obj.includes(val)
}
for (var key in obj) {
if (hasOwnProp(obj, key)) {
if (val === obj[key]) {
return true
}
}
}
}
return false
}
function arrayIndexOf (list, val) {
if (list.indexOf) {
return list.indexOf(val)
}
for (var index = 0, len = list.length; index < len; index++) {
if (val === list[index]) {
return index
}
}
}
function arrayLastIndexOf (list, val) {
if (list.lastIndexOf) {
return list.lastIndexOf(val)
}
for (var len = list.length - 1; len >= 0; len--) {
if (val === list[len]) {
return len
}
}
return -1
}
/**
* 指定方法后的返回值组成的新数组
*
* @param {Object} obj 对象/数组
* @param {Function} iterate(item, index, obj) 回调
* @param {Object} context 上下文
* @return {Array}
*/
function map (obj, iterate, context) {
var result = []
if (obj && arguments.length > 1) {
if (obj.map) {
return obj.map(iterate, context)
} else {
each(obj, function () {
result.push(iterate.apply(context, arguments))
})
}
}
return result
}
/**
* 接收一个函数作为累加器,数组中的每个值(从左到右)开始合并,最终为一个值。
*
* @param {Array} array 数组
* @param {Function} callback 方法
* @param {Object} initialValue 初始值
* @return {Number}
*/
function reduce (array, callback, initialValue) {
if (array) {
var len, reduceMethod
var index = 0
var context = null
var previous = initialValue
var isInitialVal = arguments.length > 2
var keyList = keys(array)
if (array.length && array.reduce) {
reduceMethod = function () {
return callback.apply(context, arguments)
}
if (isInitialVal) {
return array.reduce(reduceMethod, previous)
}
return array.reduce(reduceMethod)
}
if (isInitialVal) {
index = 1
previous = array[keyList[0]]
}
for (len = keyList.length; index < len; index++) {
previous = callback.call(context, previous, array[keyList[index]], index, array)
}
return previous
}
}
/**
* 浅复制数组的一部分到同一数组中的另一个位置,数组大小不变
*
* @param {Array} array 数组
* @param {Number} target 从该位置开始替换数据
* @param {Number} start 从该位置开始读取数据,默认为 0 。如果为负值,表示倒数
* @param {Number} end 到该位置前停止读取数据,默认等于数组长度。如果为负值,表示倒数
* @return {Array}
*/
function copyWithin (array, target, start, end) {
if (isArray(array) && array.copyWithin) {
return array.copyWithin(target, start, end)
}
var replaceIndex, replaceArray
var targetIndex = target >> 0
var startIndex = start >> 0
var len = array.length
var endIndex = arguments.length > 3 ? end >> 0 : len
if (targetIndex < len) {
targetIndex = targetIndex >= 0 ? targetIndex : len + targetIndex
if (targetIndex >= 0) {
startIndex = startIndex >= 0 ? startIndex : len + startIndex
endIndex = endIndex >= 0 ? endIndex : len + endIndex
if (startIndex < endIndex) {
for (replaceIndex = 0, replaceArray = array.slice(startIndex, endIndex); targetIndex < len; targetIndex++) {
if (replaceArray.length <= replaceIndex) {
break
}
array[targetIndex] = replaceArray[replaceIndex++]
}
}
}
}
return array
}
/**
* 将一个数组分割成大小的组。如果数组不能被平均分配,那么最后一块将是剩下的元素
*
* @param {Array} array 数组
* @param {Number} size 每组大小
* @return {Array}
*/
function chunk (array, size) {
var index
var result = []
var arrLen = size >> 0 || 1
if (isArray(array)) {
if (arrLen >= 0 && array.length > arrLen) {
index = 0
while (index < array.length) {
result.push(array.slice(index, index + arrLen))
index += arrLen
}
} else {
result = array.length ? [array] : array
}
}
return result
}
/**
* 将每个数组中相应位置的值合并在一起
*
* @param {Array*} array 数组
*/
function zip () {
return unzip(arguments)
}
/**
* 与 zip 相反
*
* @param {Array} arrays 数组集合
*/
function unzip (arrays) {
var index, maxItem, len
var result = []
if (arrays && arrays.length) {
index = 0
maxItem = max(arrays, function (item) {
return item ? item.length : 0
})
for (len = maxItem ? maxItem.length : 0; index < len; index++) {
result.push(pluck(arrays, index))
}
}
return result
}
/**
* 根据键数组、值数组对转换为对象
*
* @param {Array} props 键数组
* @param {Number} arr 值数组
* @return {Object}
*/
function zipObject (props, arr) {
var result = {}
arr = arr || []
each(values(props), function (val, key) {
result[val] = arr[key]
})
return result
}
function flattenDeep (array, deep) {
var result = []
arrayEach(array, function (vals) {
result = result.concat(isArray(vals) ? (deep ? flattenDeep(vals, deep) : vals) : [vals])
})
return result
}
/**
* 将一个多维数组铺平
* @param {Array} array 数组
* @param {Boolean} deep 是否深层
* @return {Array}
*/
function flatten (array, deep) {
if (isArray(array)) {
return flattenDeep(array, deep)
}
return []
}
/**
* 将对象或者伪数组转为新数组
*
* @param {Array} list 数组
* @return {Array}
*/
function toArray (list) {
return map(list, function (item) {
return item
})
}
/**
* 判断数组是否包含另一数组
*
* @param {Array} array1 数组
* @param {Array} array2 被包含数组
* @return {Boolean}
*/
function includeArrays (array1, array2) {
var len
var index = 0
if (isArray(array1) && isArray(array2)) {
for (len = array2.length; index < len; index++) {
if (!includes(array1, array2[index])) {
return false
}
}
return true
}
return includes(array1, array2)
}
/**
* 获取数组对象中某属性值,返回一个数组
*
* @param {Array} array 数组
* @param {String} key 属性值
* @return {Array}
*/
function pluck (obj, key) {
return map(obj, property(key))
}
function deepGetObj (obj, path) {
var index = 0
var len = path.length
while (obj && index < len) {
obj = obj[path[index++]]
}
return len && obj ? obj : 0
}
/**
* 在list的每个元素上执行方法,任何传递的额外参数都会在调用方法的时候传递给它
*
* @param {Array} list
* @param {Array/String/Function} path
* @param {...Object} arguments
* @return {Array}
*/
function invoke (list, path) {
var func
var args = arguments
var params = []
var paths = []
var index = 2
var len = args.length
for (; index < len; index++) {
params.push(args[index])
}
if (isArray(path)) {
len = path.length - 1
for (index = 0; index < len; index++) {
paths.push(path[index])
}
path = path[len]
}
return map(list, function (context) {
if (paths.length) {
context = deepGetObj(context, paths)
}
func = context[path] || path
if (func && func.apply) {
return func.apply(context, params)
}
})
}
function arrayEach (list, iterate, context) {
if (list) {
if (list.forEach) {
list.forEach(iterate, context)
} else {
for (var index = 0, len = list.length; index < len; index++) {
iterate.call(context, list[index], index, list)
}
}
}
}
function lastArrayEach (obj, iterate, context) {
for (var len = obj.length - 1; len >= 0; len--) {
iterate.call(context, obj[len], len, obj)
}
}
function strictTree (array, optChildren) {
each(array, function (item) {
if (item[optChildren] && !item[optChildren].length) {
remove(item, optChildren)
}
})
}
/**
* 将一个带层级的数据列表转成树结构
*
* @param {Array} array 数组
* @param {Object} options {strict: false, parentKey: 'parentId', key: 'id', children: 'children', mapChildren: 'children', data: 'data'}
* @return {Array}
*/
function toArrayTree (array, options) {
var opts = assign({}, setupDefaults.treeOptions, options)
var optStrict = opts.strict
var optKey = opts.key
var optParentKey = opts.parentKey
var optChildren = opts.children
var optMapChildren = opts.mapChildren
var optSortKey = opts.sortKey
var optReverse = opts.reverse
var optData = opts.data
var result = []
var treeMaps = {}
var idsMap = {}
var id, treeData, parentId
if (optSortKey) {
array = orderBy(clone(array), optSortKey)
if (optReverse) {
array = array.reverse()
}
}
each(array, function (item) {
id = item[optKey]
if (idsMap[id]) {
helperLog('warn', 'Duplicate primary key=' + id)
}
idsMap[id] = true
})
each(array, function (item) {
id = item[optKey]
if (optData) {
treeData = {}
treeData[optData] = item
} else {
treeData = item
}
parentId = item[optParentKey]
treeMaps[id] = treeMaps[id] || []
treeData[optKey] = id
treeData[optParentKey] = parentId
if (id === parentId) {
parentId = null
helperLog('warn', 'Error infinite Loop. key=' + id + ' parentKey=' + id)
}
treeMaps[parentId] = treeMaps[parentId] || []
treeMaps[parentId].push(treeData)
treeData[optChildren] = treeMaps[id]
if (optMapChildren) {
treeData[optMapChildren] = treeMaps[id]
}
if (!optStrict || (optStrict && eqNull(parentId))) {
if (!idsMap[parentId]) {
result.push(treeData)
}
}
})
if (optStrict) {
strictTree(array, optChildren)
}
return result
}
function unTreeList (result, parentItem, array, opts) {
var optKey = opts.key
var optParentKey = opts.parentKey
var optChildren = opts.children
var optData = opts.data
var optUpdated = opts.updated
var optClear = opts.clear
arrayEach(array, function (item) {
var childList = item[optChildren]
if (optData) {
item = item[optData]
}
if (optUpdated !== false) {
item[optParentKey] = parentItem ? parentItem[optKey] : null
}
result.push(item)
if (childList && childList.length) {
unTreeList(result, item, childList, opts)
}
if (optClear) {
delete item[optChildren]
}
})
return result
}
/**
* 将一个树结构转成数组列表
*
* @param {Array} array 数组
* @param {Object} options { children: 'children', data: 'data', clear: false }
* @return {Array}
*/
function toTreeArray (array, options) {
return unTreeList([], null, array, assign({}, setupDefaults.treeOptions, options))
}
function findTreeItem (parent, obj, iterate, context, path, node, parseChildren, opts) {
if (obj) {
var item, index, len, paths, nodes, match
for (index = 0, len = obj.length; index < len; index++) {
item = obj[index]
paths = path.concat(['' + index])
nodes = node.concat([item])
if (iterate.call(context, item, index, obj, paths, parent, nodes)) {
return { index: index, item: item, path: paths, items: obj, parent: parent, nodes: nodes }
}
if (parseChildren && item) {
match = findTreeItem(item, item[parseChildren], iterate, context, paths.concat([parseChildren]), nodes, parseChildren, opts)
if (match) {
return match
}
}
}
}
}
/**
* 从树结构中查找匹配第一条数据的键、值、路径
*
* @param {Object} obj 对象/数组
* @param {Function} iterate(item, index, items, path, parent, nodes) 回调
* @param {Object} options {children: 'children'}
* @param {Object} context 上下文
* @return {Object} { item, index, items, path, parent, nodes }
*/
var findTree = helperCreateTreeFunc(findTreeItem)
function eachTreeItem (parent, obj, iterate, context, path, node, parseChildren, opts) {
var paths, nodes
each(obj, function (item, index) {
paths = path.concat(['' + index])
nodes = node.concat([item])
iterate.call(context, item, index, obj, paths, parent, nodes)
if (item && parseChildren) {
paths.push(parseChildren)
eachTreeItem(item, item[parseChildren], iterate, context, paths, nodes, parseChildren, opts)
}
})
}
/**
* 从树结构中遍历数据的键、值、路径
*
* @param {Object} obj 对象/数组
* @param {Function} iterate(item, index, items, path, parent, nodes) 回调
* @param {Object} options {children: 'children', mapChildren: 'children}
* @param {Object} context 上下文
*/
var eachTree = helperCreateTreeFunc(eachTreeItem)
function mapTreeItem (parent, obj, iterate, context, path, node, parseChildren, opts) {
var paths, nodes, rest
var mapChildren = opts.mapChildren || parseChildren
return map(obj, function (item, index) {
paths = path.concat(['' + index])
nodes = node.concat([item])
rest = iterate.call(context, item, index, obj, paths, parent, nodes)
if (rest && item && parseChildren && item[parseChildren]) {
rest[mapChildren] = mapTreeItem(item, item[parseChildren], iterate, context, paths, nodes, parseChildren, opts)
}
return rest
})
}
/**
* 从树结构中指定方法后的返回值组成的新数组
*
* @param {Object} obj 对象/数组
* @param {Function} iterate(item, index, items, path, parent, nodes) 回调
* @param {Object} options {children: 'children'}
* @param {Object} context 上下文
* @return {Object/Array}
*/
var mapTree = helperCreateTreeFunc(mapTreeItem)
/**
* 从树结构中根据回调过滤数据
*
* @param {Object} obj 对象/数组
* @param {Function} iterate(item, index, items, path, parent) 回调
* @param {Object} options {children: 'children'}
* @param {Object} context 上下文
* @return {Array}
*/
function filterTree (obj, iterate, options, context) {
var result = []
if (obj && iterate) {
eachTree(obj, function (item, index, items, path, parent, nodes) {
if (iterate.call(context, item, index, items, path, parent, nodes)) {
result.push(item)
}
}, options)
}
return result
}
function searchTreeItem (matchParent, parent, obj, iterate, context, path, node, parseChildren, opts) {
var paths, nodes, rest, isMatch, hasChild
var rests = []
var hasOriginal = opts.original
var sourceData = opts.data
var mapChildren = opts.mapChildren || parseChildren
var isEvery = opts.isEvery
arrayEach(obj, function (item, index) {
paths = path.concat(['' + index])
nodes = node.concat([item])
isMatch = (matchParent && !isEvery) || iterate.call(context, item, index, obj, paths, parent, nodes)
hasChild = parseChildren && item[parseChildren]
if (isMatch || hasChild) {
if (hasOriginal) {
rest = item
} else {
rest = assign({}, item)
if (sourceData) {
rest[sourceData] = item
}
}
rest[mapChildren] = searchTreeItem(isMatch, item, item[parseChildren], iterate, context, paths, nodes, parseChildren, opts)
if (isMatch || rest[mapChildren].length) {
rests.push(rest)
}
} else if (isMatch) {
rests.push(rest)
}
})
return rests
}
/**
* 从树结构中根据回调查找数据
*
* @param {Object} obj 对象/数组
* @param {Function} iterate(item, index, items, path, parent, nodes) 回调
* @param {Object} options {children: 'children'}
* @param {Object} context 上下文
* @return {Array}
*/
var searchTree = helperCreateTreeFunc(function (parent, obj, iterate, context, path, nodes, parseChildren, opts) {
return searchTreeItem(0, parent, obj, iterate, context, path, nodes, parseChildren, opts)
})
/**
* 判断对象自身属性中是否具有指定的属性
*
* @param {Object} obj 对象
* @param {String/Number} key 键值
* @return {Boolean}
*/
function hasOwnProp (obj, key) {
return obj && obj.hasOwnProperty ? obj.hasOwnProperty(key) : false
}
/**
* 判断是否 undefined 和 null
* @param {Object} obj 对象
* @return {Boolean}
*/
function eqNull (obj) {
return isNull(obj) || isUndefined(obj)
}
/* eslint-disable eqeqeq */
function isNumberNaN (obj) {
return isNumber(obj) && isNaN(obj)
}
function isNumberFinite (obj) {
return isNumber(obj) && isFinite(obj)
}
/**
* 判断是否Undefined
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var isUndefined = helperCreateInTypeof(staticStrUndefined)
/**
* 判断是否数组
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var isArray = Array.isArray || helperCreateInInObjectString('Array')
/**
* 判断是否小数
*
* @param {Number} obj 数值
* @return {Boolean}
*/
function isFloat (obj) {
return !isNull(obj) && !isNaN(obj) && !isArray(obj) && !isInteger(obj)
}
/**
* 判断是否整数
*
* @param {Number, String} number 数值
* @return {Boolean}
*/
var isInteger = function (obj) {
return !isNull(obj) && !isNaN(obj) && !isArray(obj) && obj % 1 === 0
}
/**
* 判断是否方法
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var isFunction = helperCreateInTypeof('function')
/**
* 判断是否Boolean对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var isBoolean = helperCreateInTypeof('boolean')
/**
* 判断是否String对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var isString = helperCreateInTypeof('string')
/**
* 判断是否Number对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var isNumber = helperCreateInTypeof('number')
/**
* 判断是否RegExp对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var isRegExp = helperCreateInInObjectString('RegExp')
/**
* 判断是否Object对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var isObject = helperCreateInTypeof('object')
/**
* 判断是否对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
function isPlainObject (obj) {
return obj ? obj.constructor === Object : false
}
/**
* 判断是否Date对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var isDate = helperCreateInInObjectString('Date')
/**
* 判断是否Error对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var isError = helperCreateInInObjectString('Error')
/**
* 判断是否TypeError对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
function isTypeError (obj) {
return obj ? obj.constructor === TypeError : false
}
/**
* 判断是否为空对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
function isEmpty (obj) {
for (var key in obj) {
return false
}
return true
}
/**
* 判断是否为Null
*
* @param {Object} obj 对象
* @return {Boolean}
*/
function isNull (obj) {
return obj === null
}
/* eslint-disable valid-typeof */
/**
* 判断是否Symbol对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var supportSymbol = typeof Symbol !== staticStrUndefined
function isSymbol (obj) {
return supportSymbol && Symbol.isSymbol ? Symbol.isSymbol(obj) : (typeof obj === 'symbol')
}
/**
* 判断是否Arguments对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var isArguments = helperCreateInInObjectString('Arguments')
/**
* 判断是否Element对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
function isElement (obj) {
return !!(obj && isString(obj.nodeName) && isNumber(obj.nodeType))
}
/**
* 判断是否Document对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
function isDocument (obj) {
return !!(obj && staticDocument && obj.nodeType === 9)
}
/**
* 判断是否Window对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
function isWindow (obj) {
return !!(staticWindow && !!(obj && obj === obj.window))
}
/* eslint-disable valid-typeof */
/**
* 判断是否FormData对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var supportFormData = typeof FormData !== staticStrUndefined
function isFormData (obj) {
return supportFormData && obj instanceof FormData
}
/* eslint-disable valid-typeof */
/**
* 判断是否Map对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var supportMap = typeof Map !== staticStrUndefined
function isMap (obj) {
return supportMap && obj instanceof Map
}
/* eslint-disable valid-typeof */
/**
* 判断是否WeakMap对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var supportWeakMap = typeof WeakMap !== staticStrUndefined
function isWeakMap (obj) {
return supportWeakMap && obj instanceof WeakMap
}
/* eslint-disable valid-typeof */
/**
* 判断是否Set对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var supportSet = typeof Set !== staticStrUndefined
function isSet (obj) {
return supportSet && obj instanceof Set
}
/* eslint-disable valid-typeof */
/**
* 判断是否WeakSet对象
*
* @param {Object} obj 对象
* @return {Boolean}
*/
var supportWeakSet = typeof WeakSet !== staticStrUndefined
function isWeakSet (obj) {
return supportWeakSet && obj instanceof WeakSet
}
/**
* 判断是否闰年
*
* @param {Date} date 日期或数字
* @return {Boolean}
*/
function isLeapYear (date) {
var year
var currentDate = date ? toStringDate(date) : helperNewDate()
if (isDate(currentDate)) {
year = currentDate.getFullYear()
return (year % 4 === 0) && (year % 100 !== 0 || year % 400 === 0)
}
return false
}
/**
* 判断属性中的键和值是否包含在对象中
*
* @param {Object/Array} obj 对象
* @param {Object} source 值
* @return {Boolean}
*/
function isMatch (obj, source) {
var objKeys = keys(obj)
var sourceKeys = keys(source)
if (sourceKeys.length) {
if (includeArrays(objKeys, sourceKeys)) {
return some(sourceKeys, function (key2) {
return findIndexOf(objKeys, function (key1) {
return key1 === key2 && isEqual(obj[key1], source[key2])
}) > -1
})
}
} else {
return true
}
return isEqual(obj, source)
}
/**
* 深度比较两个对象之间的值是否相等
*
* @param {Object} obj1 值1
* @param {Object} obj2 值2
* @return {Boolean}
*/
function isEqual (obj1, obj2) {
return helperEqualCompare(obj1, obj2, helperDefaultCompare)
}
/**
* 深度比较两个对象之间的值是否相等,使用自定义比较函数
*
* @param {Object} obj1 值1
* @param {Object} obj2 值2
* @param {Function} func 自定义函数
* @return {Boolean}
*/
function isEqualWith (obj1, obj2, func) {
if (isFunction(func)) {
return helperEqualCompare(obj1, obj2, function (v1, v2, key, obj1, obj2) {
var result = func(v1, v2, key, obj1, obj2)
return isUndefined(result) ? helperDefaultCompare(v1, v2) : !!result
}, func)
}
return helperEqualCompare(obj1, obj2, helperDefaultCompare)
}
/**
* 获取对象类型
*
* @param {Object} obj 对象
* @return {String}
*/
function getType (obj) {
if (isNull(obj)) {
return 'null'
}
if (isSymbol(obj)) {
return 'symbol'
}
if (isDate(obj)) {
return 'date'
}
if (isArray(obj)) {
return 'array'
}
if (isRegExp(obj)) {
return 'regexp'
}
if (isError(obj)) {
return 'error'
}
return typeof obj
}
/**
* 获取一个全局唯一标识
*
* @param {String} prefix 前缀
* @return {Number}
*/
function uniqueId (prefix) {
return '' + (eqNull(prefix) ? '' : prefix) + (setupDefaults.keyId++)
}
/**
* 返回对象的长度
*
* @param {Object} obj 对象
* @return {Number}
*/
function getSize (obj) {
var len = 0
if (isString(obj) || isArray(obj)) {
return obj.length
}
each(obj, function () {
len++
})
return len
}
/**
* 返回对象第一个索引值
*
* @param {Object} obj 对象
* @param {Object} val 值
* @return {Number}
*/
var indexOf = helperCreateIndexOf('indexOf', arrayIndexOf)
/**
* 从最后开始的索引值,返回对象第一个索引值
*
* @param {Object} array 对象
* @param {Object} val 值
* @return {Number}
*/
var lastIndexOf = helperCreateIndexOf('lastIndexOf', arrayLastIndexOf)
/**
* 返回对象第一个索引值
*
* @param {Object} obj 对象/数组
* @param {Function} iterate(item, index, obj) 回调
* @param {Object} context 上下文
* @return {Object}
*/
var findIndexOf = helperCreateiterateIndexOf(function (obj, iterate, context) {
for (var index = 0, len = obj.length; index < len; index++) {
if (iterate.call(context, obj[index], index, obj)) {
return index
}
}
return -1
})
/**
* 从最后开始的索引值,返回对象第一个索引值
*
* @param {Object} obj 对象/数组
* @param {Function} iterate(item, index, obj) 回调
* @param {Object} context 上下文
* @return {Object}
*/
var findLastIndexOf = helperCreateiterateIndexOf(function (obj, iterate, context) {
for (var len = obj.length - 1; len >= 0; len--) {
if (iterate.call(context, obj[len], len, obj)) {
return len
}
}
return -1
})
/**
* 字符串转JSON
*
* @param {String} str 字符串
* @return {Object} 返回转换后对象
*/
function toStringJSON (str) {
if (isPlainObject(str)) {
return str
} else if (isString(str)) {
try {
return JSON.parse(str)
} catch (e) {}
}
return {}
}
/**
* JSON转字符串
*
* @param {Object} obj 对象
* @return {String} 返回字符串
*/
function toJSONString (obj) {
return eqNull(obj) ? '' : JSON.stringify(obj)
}
/**
* 获取对象所有属性
*
* @param {Object} obj 对象/数组
* @return {Array}
*/
var keys = helperCreateGetObjects('keys', 1)
/**
* 获取对象所有值
*
* @param {Object} obj 对象/数组
* @return {Array}
*/
var values = helperCreateGetObjects('values', 0)
/**
* 获取对象所有属性、值
*
* @param {Object} obj 对象/数组
* @return {Array}
*/
var entries = helperCreateGetObjects('entries', 2)
/**
* 根据 key 过滤指定的属性值,返回一个新的对象
*
* @param {Object} obj 对象
* @param {String/Array} key 键数组
* @return {Object}
*/
var pick = helperCreatePickOmit(1, 0)
/**
* 根据 key 排除指定的属性值,返回一个新的对象
*
* @param {Object} obj 对象
* @param {String/Array} key 键数组
* @return {Object}
*/
var omit = helperCreatePickOmit(0, 1)
/**
* 获取对象第一个值
*
* @param {Object} obj 对象/数组
* @return {Object}
*/
function first (obj) {
return values(obj)[0]
}
/**
* 获取对象最后一个值
*
* @param {Object} obj 对象/数组
* @return {Object}
*/
function last (obj) {
var list = values(obj)
return list[list.length - 1]
}
/**
* 迭代器
*
* @param {Object} obj 对象/数组
* @param {Function} iterate(item, index, obj) 回调
* @param {Object} context 上下文
* @return {Object}
*/
function each (obj, iterate, context) {
if (obj) {
return (isArray(obj) ? arrayEach : objectEach)(obj, iterate, context)
}
return obj
}
/**
* 已废弃,被 some, every 替换
* @deprecated
*/
function forOf (obj, iterate, context) {
if (obj) {
if (isArray(obj)) {
for (var index = 0, len = obj.length; index < len; index++) {
if (i