xe-utils.umd.js 107 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105
  1. /**
  2. * xe-utils.js v2.8.3
  3. * MIT License.
  4. * @preserve
  5. */
  6. (function (global, factory) {
  7. typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory()
  8. : typeof define === 'function' && define.amd ? define(factory)
  9. : (global.XEUtils = factory())
  10. }(this, function () {
  11. 'use strict'
  12. var formatString = 'yyyy-MM-dd HH:mm:ss'
  13. var setupDefaults = {
  14. treeOptions: {
  15. parentKey: 'parentId',
  16. key: 'id',
  17. children: 'children'
  18. },
  19. formatDate: formatString + '.SSSZ',
  20. formatString: formatString,
  21. dateDiffRules: [
  22. ['yyyy', 31536000000],
  23. ['MM', 2592000000],
  24. ['dd', 86400000],
  25. ['HH', 3600000],
  26. ['mm', 60000],
  27. ['ss', 1000],
  28. ['S', 0]
  29. ]
  30. }
  31. function mixin () {
  32. arrayEach(arguments, function (methods) {
  33. each(methods, function (fn, name) {
  34. XEUtils[name] = isFunction(fn) ? function () {
  35. var result = fn.apply(XEUtils.$context, arguments)
  36. XEUtils.$context = null
  37. return result
  38. } : fn
  39. })
  40. })
  41. }
  42. function setup (options) {
  43. return assign(setupDefaults, options)
  44. }
  45. function XEUtils () {}
  46. XEUtils.v = 'v2'
  47. XEUtils.mixin = mixin
  48. XEUtils.setup = setup
  49. var staticStrUndefined = 'undefined'
  50. var staticStrLast = 'last'
  51. var staticStrFirst = 'first'
  52. var staticDayTime = 86400000
  53. var staticWeekTime = staticDayTime * 7
  54. /* eslint-disable valid-typeof */
  55. var staticLocation = typeof location === staticStrUndefined ? 0 : location
  56. /* eslint-disable valid-typeof */
  57. var staticWindow = typeof window === staticStrUndefined ? 0 : window
  58. /* eslint-disable valid-typeof */
  59. var staticDocument = typeof document === staticStrUndefined ? 0 : document
  60. var staticEncodeURIComponent = encodeURIComponent
  61. var staticDecodeURIComponent = decodeURIComponent
  62. var objectToString = Object.prototype.toString
  63. var staticParseInt = parseInt
  64. var staticEscapeMap = {
  65. '&': '&',
  66. '<': '&lt;',
  67. '>': '&gt;',
  68. '"': '&quot;',
  69. "'": '&#x27;',
  70. '`': '&#x60;'
  71. }
  72. var staticHGKeyRE = /(.+)?\[(\d+)\]$/
  73. var objectAssignFns = Object.assign
  74. function handleAssign (destination, args, isClone) {
  75. var len = args.length
  76. for (var source, index = 1; index < len; index++) {
  77. source = args[index]
  78. arrayEach(keys(args[index]), isClone ? function (key) {
  79. destination[key] = clone(source[key], isClone)
  80. } : function (key) {
  81. destination[key] = source[key]
  82. })
  83. }
  84. return destination
  85. }
  86. /**
  87. * 将一个或多个源对象复制到目标对象中
  88. *
  89. * @param {Object} target 目标对象
  90. * @param {...Object}
  91. * @return {Boolean}
  92. */
  93. var assign = function (target) {
  94. if (target) {
  95. var args = arguments
  96. if (target === true) {
  97. if (args.length > 1) {
  98. target = isArray(target[1]) ? [] : {}
  99. return handleAssign(target, args, true)
  100. }
  101. } else {
  102. return objectAssignFns ? objectAssignFns.apply(Object, args) : handleAssign(target, args)
  103. }
  104. }
  105. return target
  106. }
  107. /**
  108. * 该方法已废弃,被 assign 替换
  109. * @param target 目标对象
  110. * @param sources 多个对象
  111. */
  112. var extend = assign
  113. /**
  114. * 指定方法后的返回值组成的新对象
  115. *
  116. * @param {Object} obj 对象/数组
  117. * @param {Function} iterate(item, index, obj) 回调
  118. * @param {Object} context 上下文
  119. * @return {Object}
  120. */
  121. function objectMap (obj, iterate, context) {
  122. var result = {}
  123. if (obj) {
  124. if (iterate) {
  125. if (!isFunction(iterate)) {
  126. iterate = property(iterate)
  127. }
  128. each(obj, function (val, index) {
  129. result[index] = iterate.call(context, val, index, obj)
  130. })
  131. } else {
  132. return obj
  133. }
  134. }
  135. return result
  136. }
  137. function objectEach (obj, iterate, context) {
  138. if (obj) {
  139. for (var key in obj) {
  140. if (hasOwnProp(obj, key)) {
  141. iterate.call(context, obj[key], key, obj)
  142. }
  143. }
  144. }
  145. }
  146. function lastObjectEach (obj, iterate, context) {
  147. lastArrayEach(keys(obj), function (key) {
  148. iterate.call(context, obj[key], key, obj)
  149. })
  150. }
  151. function handleMerge (target, source) {
  152. if ((isPlainObject(target) && isPlainObject(source)) || (isArray(target) && isArray(source))) {
  153. each(source, function (obj, key) {
  154. target[key] = handleMerge(target[key], obj)
  155. })
  156. return target
  157. }
  158. return source
  159. }
  160. /**
  161. * 将一个或多个源对象合并到目标对象中
  162. *
  163. * @param {Object} target 目标对象
  164. * @param {...Object}
  165. * @return {Boolean}
  166. */
  167. var merge = function (target) {
  168. if (!target) {
  169. target = {}
  170. }
  171. var args = arguments
  172. var len = args.length
  173. for (var source, index = 1; index < len; index++) {
  174. source = args[index]
  175. if (source) {
  176. handleMerge(target, source)
  177. }
  178. }
  179. return target
  180. }
  181. /**
  182. * 数组去重
  183. *
  184. * @param {Array} array 数组
  185. * @return {Array}
  186. */
  187. function uniq (array) {
  188. var result = []
  189. each(array, function (value) {
  190. if (!includes(result, value)) {
  191. result.push(value)
  192. }
  193. })
  194. return result
  195. }
  196. /**
  197. * 将多个数的值返回唯一的并集数组
  198. *
  199. * @param {...Array} 数组
  200. * @return {Array}
  201. */
  202. function union () {
  203. var args = arguments
  204. var result = []
  205. var index = 0
  206. var len = args.length
  207. for (; index < len; index++) {
  208. result = result.concat(toArray(args[index]))
  209. }
  210. return uniq(result)
  211. }
  212. var sortBy = orderBy
  213. var ORDER_PROP_ASC = 'asc'
  214. var ORDER_PROP_DESC = 'desc'
  215. // function handleSort (v1, v2) {
  216. // return v1 > v2 ? 1 : -1
  217. // }
  218. // '' < 数字 < 字符 < null < undefined
  219. function handleSort (v1, v2) {
  220. if (isUndefined(v1)) {
  221. return 1
  222. }
  223. if (isNull(v1)) {
  224. return isUndefined(v2) ? -1 : 1
  225. }
  226. return v1 && v1.localeCompare ? v1.localeCompare(v2) : (v1 > v2 ? 1 : -1)
  227. }
  228. function buildMultiOrders (name, confs, compares) {
  229. return function (item1, item2) {
  230. var v1 = item1[name]
  231. var v2 = item2[name]
  232. if (v1 === v2) {
  233. return compares ? compares(item1, item2) : 0
  234. }
  235. return confs.order === ORDER_PROP_DESC ? handleSort(v2, v1) : handleSort(v1, v2)
  236. }
  237. }
  238. function getSortConfs (arr, list, fieldConfs, context) {
  239. var sortConfs = []
  240. fieldConfs = isArray(fieldConfs) ? fieldConfs : [fieldConfs]
  241. arrayEach(fieldConfs, function (handle, index) {
  242. if (handle) {
  243. var field = handle
  244. var order
  245. if (isArray(handle)) {
  246. field = handle[0]
  247. order = handle[1]
  248. } else if (isPlainObject(handle)) {
  249. field = handle.field
  250. order = handle.order
  251. }
  252. sortConfs.push({
  253. field: field,
  254. order: order || ORDER_PROP_ASC
  255. })
  256. arrayEach(list, isFunction(field) ? function (item, key) {
  257. item[index] = field.call(context, item.data, key, arr)
  258. } : function (item) {
  259. item[index] = field ? get(item.data, field) : item.data
  260. })
  261. }
  262. })
  263. return sortConfs
  264. }
  265. /**
  266. * 将数组进行排序
  267. *
  268. * @param {Array} arr 数组
  269. * @param {Function/String/Array} fieldConfs 方法或属性
  270. * @param {Object} context 上下文
  271. * @return {Array}
  272. */
  273. function orderBy (arr, fieldConfs, context) {
  274. if (arr) {
  275. if (eqNull(fieldConfs)) {
  276. return toArray(arr).sort(handleSort)
  277. }
  278. var compares
  279. var list = map(arr, function (item) {
  280. return { data: item }
  281. })
  282. var sortConfs = getSortConfs(arr, list, fieldConfs, context)
  283. var len = sortConfs.length - 1
  284. while (len >= 0) {
  285. compares = buildMultiOrders(len, sortConfs[len], compares)
  286. len--
  287. }
  288. if (compares) {
  289. list = list.sort(compares)
  290. }
  291. return map(list, property('data'))
  292. }
  293. return []
  294. }
  295. /**
  296. * 将一个数组随机打乱,返回一个新的数组
  297. *
  298. * @param {Array} array 数组
  299. * @return {Array}
  300. */
  301. function shuffle (array) {
  302. var index
  303. var result = []
  304. var list = values(array)
  305. var len = list.length - 1
  306. for (; len >= 0; len--) {
  307. index = len > 0 ? random(0, len) : 0
  308. result.push(list[index])
  309. list.splice(index, 1)
  310. }
  311. return result
  312. }
  313. /**
  314. * 从一个数组中随机返回几个元素
  315. *
  316. * @param {Array} array 数组
  317. * @param {Number} number 个数
  318. * @return {Array}
  319. */
  320. function sample (array, number) {
  321. var result = shuffle(array)
  322. if (arguments.length <= 1) {
  323. return result[0]
  324. }
  325. if (number < result.length) {
  326. result.length = number || 0
  327. }
  328. return result
  329. }
  330. /**
  331. * 对象中的值中的每一项运行给定函数,如果函数对任一项返回true,则返回true,否则返回false
  332. *
  333. * @param {Object} obj 对象/数组
  334. * @param {Function} iterate(item, index, obj) 回调
  335. * @param {Object} context 上下文
  336. * @return {Boolean}
  337. */
  338. var some = helperCreateIterateHandle('some', 1, 0, true, false)
  339. /**
  340. * 对象中的值中的每一项运行给定函数,如果该函数对每一项都返回true,则返回true,否则返回false
  341. *
  342. * @param {Object} obj 对象/数组
  343. * @param {Function} iterate(item, index, obj) 回调
  344. * @param {Object} context 上下文
  345. * @return {Boolean}
  346. */
  347. var every = helperCreateIterateHandle('every', 1, 1, false, true)
  348. /**
  349. * 裁剪 Arguments 或数组 array,从 start 位置开始到 end 结束,但不包括 end 本身的位置
  350. * @param {Array/Arguments} array 数组或Arguments
  351. * @param {Number} startIndex 开始索引
  352. * @param {Number} endIndex 结束索引
  353. */
  354. function slice (array, startIndex, endIndex) {
  355. var result = []
  356. var argsSize = arguments.length
  357. if (array) {
  358. startIndex = argsSize >= 2 ? toNumber(startIndex) : 0
  359. endIndex = argsSize >= 3 ? toNumber(endIndex) : array.length
  360. if (array.slice) {
  361. return array.slice(startIndex, endIndex)
  362. }
  363. for (; startIndex < endIndex; startIndex++) {
  364. result.push(array[startIndex])
  365. }
  366. }
  367. return result
  368. }
  369. /**
  370. * 根据回调过滤数据
  371. *
  372. * @param {Object} obj 对象/数组
  373. * @param {Function} iterate(item, index, obj) 回调
  374. * @param {Object} context 上下文
  375. * @return {Object}
  376. */
  377. function filter (obj, iterate, context) {
  378. var result = []
  379. if (obj && iterate) {
  380. if (obj.filter) {
  381. return obj.filter(iterate, context)
  382. }
  383. each(obj, function (val, key) {
  384. if (iterate.call(context, val, key, obj)) {
  385. result.push(val)
  386. }
  387. })
  388. }
  389. return result
  390. }
  391. /**
  392. * 查找匹配第一条数据
  393. *
  394. * @param {Object} obj 对象/数组
  395. * @param {Function} iterate(item, index, obj) 回调
  396. * @param {Object} context 上下文
  397. * @return {Object}
  398. */
  399. var find = helperCreateIterateHandle('find', 1, 3, true)
  400. /**
  401. * 从右至左遍历,匹配最近的一条数据
  402. *
  403. * @param {Object} obj 对象/数组
  404. * @param {Function} iterate(item, index, obj) 回调
  405. * @param {Object} context 上下文
  406. * @return {Object}
  407. */
  408. function findLast (obj, iterate, context) {
  409. if (obj) {
  410. if (!isArray(obj)) {
  411. obj = values(obj)
  412. }
  413. for (var len = obj.length - 1; len >= 0; len--) {
  414. if (iterate.call(context, obj[len], len, obj)) {
  415. return obj[len]
  416. }
  417. }
  418. }
  419. }
  420. /**
  421. * 查找匹配第一条数据的键
  422. *
  423. * @param {Object} obj 对象/数组
  424. * @param {Function} iterate(item, index, obj) 回调
  425. * @param {Object} context 上下文
  426. * @return {Object}
  427. */
  428. var findKey = helperCreateIterateHandle('', 0, 2, true)
  429. /**
  430. * 判断对象是否包含该值,成功返回true否则false
  431. *
  432. * @param {Object} obj 对象
  433. * @param {Object} val 值
  434. * @return {Boolean}
  435. */
  436. function includes (obj, val) {
  437. return indexOf(obj, val) !== -1
  438. }
  439. function arrayIndexOf (obj, val) {
  440. if (obj.indexOf) {
  441. return obj.indexOf(val)
  442. }
  443. for (var index = 0, len = obj.length; index < len; index++) {
  444. if (val === obj[index]) {
  445. return index
  446. }
  447. }
  448. }
  449. function arrayLastIndexOf (obj, val) {
  450. if (obj.lastIndexOf) {
  451. return obj.lastIndexOf(val)
  452. }
  453. for (var len = obj.length - 1; len >= 0; len--) {
  454. if (val === obj[len]) {
  455. return len
  456. }
  457. }
  458. return -1
  459. }
  460. /**
  461. * 指定方法后的返回值组成的新数组
  462. *
  463. * @param {Object} obj 对象/数组
  464. * @param {Function} iterate(item, index, obj) 回调
  465. * @param {Object} context 上下文
  466. * @return {Array}
  467. */
  468. function map (obj, iterate, context) {
  469. var result = []
  470. if (obj && arguments.length > 1) {
  471. if (obj.map) {
  472. return obj.map(iterate, context)
  473. } else {
  474. each(obj, function () {
  475. result.push(iterate.apply(context, arguments))
  476. })
  477. }
  478. }
  479. return result
  480. }
  481. /**
  482. * 接收一个函数作为累加器,数组中的每个值(从左到右)开始合并,最终为一个值。
  483. *
  484. * @param {Array} array 数组
  485. * @param {Function} callback 方法
  486. * @param {Object} initialValue 初始值
  487. * @return {Number}
  488. */
  489. function reduce (array, callback, initialValue) {
  490. if (array) {
  491. var len, reduceMethod
  492. var index = 0
  493. var context = null
  494. var previous = initialValue
  495. var isInitialVal = arguments.length > 2
  496. var keyList = keys(array)
  497. if (array.length && array.reduce) {
  498. reduceMethod = function () {
  499. return callback.apply(context, arguments)
  500. }
  501. if (isInitialVal) {
  502. return array.reduce(reduceMethod, previous)
  503. }
  504. return array.reduce(reduceMethod)
  505. }
  506. if (isInitialVal) {
  507. index = 1
  508. previous = array[keyList[0]]
  509. }
  510. for (len = keyList.length; index < len; index++) {
  511. previous = callback.call(context, previous, array[keyList[index]], index, array)
  512. }
  513. return previous
  514. }
  515. }
  516. /**
  517. * 浅复制数组的一部分到同一数组中的另一个位置,数组大小不变
  518. *
  519. * @param {Array} array 数组
  520. * @param {Number} target 从该位置开始替换数据
  521. * @param {Number} start 从该位置开始读取数据,默认为 0 。如果为负值,表示倒数
  522. * @param {Number} end 到该位置前停止读取数据,默认等于数组长度。如果为负值,表示倒数
  523. * @return {Array}
  524. */
  525. function copyWithin (array, target, start, end) {
  526. if (isArray(array) && array.copyWithin) {
  527. return array.copyWithin(target, start, end)
  528. }
  529. var replaceIndex, replaceArray
  530. var targetIndex = target >> 0
  531. var startIndex = start >> 0
  532. var len = array.length
  533. var endIndex = arguments.length > 3 ? end >> 0 : len
  534. if (targetIndex < len) {
  535. targetIndex = targetIndex >= 0 ? targetIndex : len + targetIndex
  536. if (targetIndex >= 0) {
  537. startIndex = startIndex >= 0 ? startIndex : len + startIndex
  538. endIndex = endIndex >= 0 ? endIndex : len + endIndex
  539. if (startIndex < endIndex) {
  540. for (replaceIndex = 0, replaceArray = array.slice(startIndex, endIndex); targetIndex < len; targetIndex++) {
  541. if (replaceArray.length <= replaceIndex) {
  542. break
  543. }
  544. array[targetIndex] = replaceArray[replaceIndex++]
  545. }
  546. }
  547. }
  548. }
  549. return array
  550. }
  551. /**
  552. * 将一个数组分割成大小的组。如果数组不能被平均分配,那么最后一块将是剩下的元素
  553. *
  554. * @param {Array} array 数组
  555. * @param {Number} size 每组大小
  556. * @return {Array}
  557. */
  558. function chunk (array, size) {
  559. var index
  560. var result = []
  561. var arrLen = size >> 0 || 1
  562. if (isArray(array)) {
  563. if (arrLen >= 0 && array.length > arrLen) {
  564. index = 0
  565. while (index < array.length) {
  566. result.push(array.slice(index, index + arrLen))
  567. index += arrLen
  568. }
  569. } else {
  570. result = array.length ? [array] : array
  571. }
  572. }
  573. return result
  574. }
  575. /**
  576. * 将每个数组中相应位置的值合并在一起
  577. *
  578. * @param {Array*} array 数组
  579. */
  580. function zip () {
  581. return unzip(arguments)
  582. }
  583. /**
  584. * 与 zip 相反
  585. *
  586. * @param {Array} arrays 数组集合
  587. */
  588. function unzip (arrays) {
  589. var index, maxItem, len
  590. var result = []
  591. if (arrays && arrays.length) {
  592. index = 0
  593. maxItem = max(arrays, function (item) {
  594. return item ? item.length : 0
  595. })
  596. for (len = maxItem ? maxItem.length : 0; index < len; index++) {
  597. result.push(pluck(arrays, index))
  598. }
  599. }
  600. return result
  601. }
  602. /**
  603. * 根据键数组、值数组对转换为对象
  604. *
  605. * @param {Array} props 键数组
  606. * @param {Number} arr 值数组
  607. * @return {Object}
  608. */
  609. function zipObject (props, arr) {
  610. var result = {}
  611. arr = arr || []
  612. each(values(props), function (val, key) {
  613. result[val] = arr[key]
  614. })
  615. return result
  616. }
  617. function flattenDeep (array, deep) {
  618. var result = []
  619. arrayEach(array, function (vals) {
  620. result = result.concat(isArray(vals) ? (deep ? flattenDeep(vals, deep) : vals) : [vals])
  621. })
  622. return result
  623. }
  624. /**
  625. * 将一个多维数组铺平
  626. * @param {Array} array 数组
  627. * @param {Boolean} deep 是否深层
  628. * @return {Array}
  629. */
  630. function flatten (array, deep) {
  631. if (isArray(array)) {
  632. return flattenDeep(array, deep)
  633. }
  634. return []
  635. }
  636. /**
  637. * 将对象或者伪数组转为新数组
  638. *
  639. * @param {Array} obj 数组
  640. * @return {Array}
  641. */
  642. function toArray (array) {
  643. return map(array, function (item) {
  644. return item
  645. })
  646. }
  647. /**
  648. * 判断数组是否包含另一数组
  649. *
  650. * @param {Array} array1 数组
  651. * @param {Array} array2 被包含数组
  652. * @return {Boolean}
  653. */
  654. function includeArrays (array1, array2) {
  655. var len
  656. var index = 0
  657. if (isArray(array1) && isArray(array2)) {
  658. for (len = array2.length; index < len; index++) {
  659. if (!includes(array1, array2[index])) {
  660. return false
  661. }
  662. }
  663. return true
  664. }
  665. return includes(array1, array2)
  666. }
  667. /**
  668. * 获取数组对象中某属性值,返回一个数组
  669. *
  670. * @param {Array} array 数组
  671. * @param {String} key 属性值
  672. * @return {Array}
  673. */
  674. function pluck (obj, key) {
  675. return map(obj, property(key))
  676. }
  677. function deepGetObj (obj, path) {
  678. var index = 0
  679. var len = path.length
  680. while (obj && index < len) {
  681. obj = obj[path[index++]]
  682. }
  683. return len && obj ? obj : 0
  684. }
  685. /**
  686. * 在list的每个元素上执行方法,任何传递的额外参数都会在调用方法的时候传递给它
  687. *
  688. * @param {Array} list
  689. * @param {Array/String/Function} path
  690. * @param {...Object} arguments
  691. * @return {Array}
  692. */
  693. function invoke (list, path) {
  694. var func
  695. var args = arguments
  696. var params = []
  697. var paths = []
  698. var index = 2
  699. var len = args.length
  700. for (; index < len; index++) {
  701. params.push(args[index])
  702. }
  703. if (isArray(path)) {
  704. len = path.length - 1
  705. for (index = 0; index < len; index++) {
  706. paths.push(path[index])
  707. }
  708. path = path[len]
  709. }
  710. return map(list, function (context) {
  711. if (paths.length) {
  712. context = deepGetObj(context, paths)
  713. }
  714. func = context[path] || path
  715. if (func && func.apply) {
  716. return func.apply(context, params)
  717. }
  718. })
  719. }
  720. var invokeMap = invoke
  721. function arrayEach (obj, iterate, context) {
  722. if (obj) {
  723. if (obj.forEach) {
  724. obj.forEach(iterate, context)
  725. } else {
  726. for (var index = 0, len = obj.length; index < len; index++) {
  727. iterate.call(context, obj[index], index, obj)
  728. }
  729. }
  730. }
  731. }
  732. function lastArrayEach (obj, iterate, context) {
  733. for (var len = obj.length - 1; len >= 0; len--) {
  734. iterate.call(context, obj[len], len, obj)
  735. }
  736. }
  737. function strictTree (array, optChildren) {
  738. each(array, function (item) {
  739. if (item.children && !item.children.length) {
  740. remove(item, optChildren)
  741. }
  742. })
  743. }
  744. /**
  745. * 将一个带层级的数据列表转成树结构
  746. *
  747. * @param {Array} array 数组
  748. * @param {Object} options {strict: false, parentKey: 'parentId', key: 'id', children: 'children', data: 'data'}
  749. * @return {Array}
  750. */
  751. function toArrayTree (array, options) {
  752. var opts = assign({}, setupDefaults.treeOptions, options)
  753. var optStrict = opts.strict
  754. var optKey = opts.key
  755. var optParentKey = opts.parentKey
  756. var optChildren = opts.children
  757. var optSortKey = opts.sortKey
  758. var optReverse = opts.reverse
  759. var optData = opts.data
  760. var result = []
  761. var treeMap = {}
  762. var idList, id, treeData, parentId
  763. if (optSortKey) {
  764. array = orderBy(clone(array), optSortKey)
  765. if (optReverse) {
  766. array = array.reverse()
  767. }
  768. }
  769. idList = map(array, function (item) {
  770. return item[optKey]
  771. })
  772. each(array, function (item) {
  773. id = item[optKey]
  774. if (optData) {
  775. treeData = {}
  776. treeData[optData] = item
  777. } else {
  778. treeData = item
  779. }
  780. parentId = item[optParentKey]
  781. treeMap[id] = treeMap[id] || []
  782. treeMap[parentId] = treeMap[parentId] || []
  783. treeMap[parentId].push(treeData)
  784. treeData[optKey] = id
  785. treeData[optParentKey] = parentId
  786. treeData[optChildren] = treeMap[id]
  787. if (!optStrict || (optStrict && !parentId)) {
  788. if (!includes(idList, parentId)) {
  789. result.push(treeData)
  790. }
  791. }
  792. })
  793. if (optStrict) {
  794. strictTree(array, optChildren)
  795. }
  796. return result
  797. }
  798. function unTreeList (result, array, opts) {
  799. var optChildren = opts.children
  800. var optData = opts.data
  801. var optClear = opts.clear
  802. each(array, function (item) {
  803. var children = item[optChildren]
  804. if (optData) {
  805. item = item[optData]
  806. }
  807. result.push(item)
  808. if (children && children.length) {
  809. unTreeList(result, children, opts)
  810. }
  811. if (optClear) {
  812. delete item[optChildren]
  813. }
  814. })
  815. return result
  816. }
  817. /**
  818. * 将一个树结构转成数组列表
  819. *
  820. * @param {Array} array 数组
  821. * @param {Object} options {children: 'children', data: 'data'}
  822. * @return {Array}
  823. */
  824. function toTreeArray (array, options) {
  825. return unTreeList([], array, assign({}, setupDefaults.treeOptions, options))
  826. }
  827. function findTreeItem (parent, obj, iterate, context, path, node, parseChildren, opts) {
  828. if (obj) {
  829. var item, index, len, paths, nodes, match
  830. for (index = 0, len = obj.length; index < len; index++) {
  831. item = obj[index]
  832. paths = path.concat(['' + index])
  833. nodes = node.concat([item])
  834. if (iterate.call(context, item, index, obj, paths, parent, nodes)) {
  835. return { index: index, item: item, path: paths, items: obj, parent: parent, nodes: nodes }
  836. }
  837. if (parseChildren && item) {
  838. match = findTreeItem(item, item[parseChildren], iterate, context, paths.concat([parseChildren]), nodes, parseChildren, opts)
  839. if (match) {
  840. return match
  841. }
  842. }
  843. }
  844. }
  845. }
  846. /**
  847. * 从树结构中查找匹配第一条数据的键、值、路径
  848. *
  849. * @param {Object} obj 对象/数组
  850. * @param {Function} iterate(item, index, items, path, parent, nodes) 回调
  851. * @param {Object} options {children: 'children'}
  852. * @param {Object} context 上下文
  853. * @return {Object} { item, index, items, path, parent, nodes }
  854. */
  855. var findTree = helperCreateTreeFunc(findTreeItem)
  856. function eachTreeItem (parent, obj, iterate, context, path, node, parseChildren, opts) {
  857. var paths, nodes
  858. each(obj, function (item, index) {
  859. paths = path.concat(['' + index])
  860. nodes = node.concat([item])
  861. iterate.call(context, item, index, obj, paths, parent, nodes)
  862. if (item && parseChildren) {
  863. paths.push(parseChildren)
  864. eachTreeItem(item, item[parseChildren], iterate, context, paths, nodes, parseChildren, opts)
  865. }
  866. })
  867. }
  868. /**
  869. * 从树结构中遍历数据的键、值、路径
  870. *
  871. * @param {Object} obj 对象/数组
  872. * @param {Function} iterate(item, index, items, path, parent, nodes) 回调
  873. * @param {Object} options {children: 'children', mapChildren: 'children}
  874. * @param {Object} context 上下文
  875. */
  876. var eachTree = helperCreateTreeFunc(eachTreeItem)
  877. function mapTreeItem (parent, obj, iterate, context, path, node, parseChildren, opts) {
  878. var paths, nodes, rest
  879. var mapChildren = opts.mapChildren || parseChildren
  880. return map(obj, function (item, index) {
  881. paths = path.concat(['' + index])
  882. nodes = node.concat([item])
  883. rest = iterate.call(context, item, index, obj, paths, parent, nodes)
  884. if (rest && item && parseChildren && item[parseChildren]) {
  885. rest[mapChildren] = mapTreeItem(item, item[parseChildren], iterate, context, paths, nodes, parseChildren, opts)
  886. }
  887. return rest
  888. })
  889. }
  890. /**
  891. * 从树结构中指定方法后的返回值组成的新数组
  892. *
  893. * @param {Object} obj 对象/数组
  894. * @param {Function} iterate(item, index, items, path, parent, nodes) 回调
  895. * @param {Object} options {children: 'children'}
  896. * @param {Object} context 上下文
  897. * @return {Object/Array}
  898. */
  899. var mapTree = helperCreateTreeFunc(mapTreeItem)
  900. /**
  901. * 从树结构中根据回调过滤数据
  902. *
  903. * @param {Object} obj 对象/数组
  904. * @param {Function} iterate(item, index, items, path, parent) 回调
  905. * @param {Object} options {children: 'children'}
  906. * @param {Object} context 上下文
  907. * @return {Array}
  908. */
  909. function filterTree (obj, iterate, options, context) {
  910. var result = []
  911. if (obj && iterate) {
  912. eachTree(obj, function (item, index, items, path, parent, nodes) {
  913. if (iterate.call(context, item, index, items, path, parent, nodes)) {
  914. result.push(item)
  915. }
  916. }, options)
  917. }
  918. return result
  919. }
  920. function searchTreeItem (parentAllow, parent, obj, iterate, context, path, node, parseChildren, opts) {
  921. var paths, nodes, rest, isAllow, hasChild
  922. var rests = []
  923. var hasOriginal = opts.original
  924. var sourceData = opts.data
  925. var mapChildren = opts.mapChildren || parseChildren
  926. arrayEach(obj, function (item, index) {
  927. paths = path.concat(['' + index])
  928. nodes = node.concat([item])
  929. isAllow = parentAllow || iterate.call(context, item, index, obj, paths, parent, nodes)
  930. hasChild = parseChildren && item[parseChildren]
  931. if (isAllow || hasChild) {
  932. if (hasOriginal) {
  933. rest = item
  934. } else {
  935. rest = assign({}, item)
  936. if (sourceData) {
  937. rest[sourceData] = item
  938. }
  939. }
  940. rest[mapChildren] = searchTreeItem(isAllow, item, item[parseChildren], iterate, context, paths, nodes, parseChildren, opts)
  941. if (isAllow || rest[mapChildren].length) {
  942. rests.push(rest)
  943. }
  944. } else if (isAllow) {
  945. rests.push(rest)
  946. }
  947. })
  948. return rests
  949. }
  950. /**
  951. * 从树结构中根据回调查找数据
  952. *
  953. * @param {Object} obj 对象/数组
  954. * @param {Function} iterate(item, index, items, path, parent, nodes) 回调
  955. * @param {Object} options {children: 'children'}
  956. * @param {Object} context 上下文
  957. * @return {Array}
  958. */
  959. var searchTree = helperCreateTreeFunc(function (parent, obj, iterate, context, path, nodes, parseChildren, opts) {
  960. return searchTreeItem(0, parent, obj, iterate, context, path, nodes, parseChildren, opts)
  961. })
  962. function helperCreateIterateHandle (prop, useArray, restIndex, matchValue, defaultValue) {
  963. return function (obj, iterate, context) {
  964. if (obj && iterate) {
  965. if (prop && obj[prop]) {
  966. return obj[prop](iterate, context)
  967. } else {
  968. if (useArray && isArray(obj)) {
  969. for (var index = 0, len = obj.length; index < len; index++) {
  970. if (!!iterate.call(context, obj[index], index, obj) === matchValue) {
  971. return [true, false, index, obj[index]][restIndex]
  972. }
  973. }
  974. } else {
  975. for (var key in obj) {
  976. if (hasOwnProp(obj, key)) {
  977. if (!!iterate.call(context, obj[key], key, obj) === matchValue) {
  978. return [true, false, key, obj[key]][restIndex]
  979. }
  980. }
  981. }
  982. }
  983. }
  984. }
  985. return defaultValue
  986. }
  987. }
  988. function helperCreateTreeFunc (handle) {
  989. return function (obj, iterate, options, context) {
  990. var opts = options || {}
  991. var optChildren = opts.children || 'children'
  992. return handle(null, obj, iterate, context, [], [], optChildren, opts)
  993. }
  994. }
  995. /**
  996. * 判断对象自身属性中是否具有指定的属性
  997. *
  998. * @param {Object} obj 对象
  999. * @param {String/Number} key 键值
  1000. * @return {Boolean}
  1001. */
  1002. function hasOwnProp (obj, key) {
  1003. return obj && obj.hasOwnProperty ? obj.hasOwnProperty(key) : false
  1004. }
  1005. /**
  1006. * 判断是否 undefined 和 null
  1007. * @param {Object} obj 对象
  1008. * @return {Boolean}
  1009. */
  1010. function eqNull (obj) {
  1011. return isNull(obj) || isUndefined(obj)
  1012. }
  1013. /* eslint-disable eqeqeq */
  1014. function isNumberNaN (obj) {
  1015. return isNumber(obj) && isNaN(obj)
  1016. }
  1017. function isNumberFinite (obj) {
  1018. return isNumber(obj) && isFinite(obj)
  1019. }
  1020. /**
  1021. * 判断是否Undefined
  1022. *
  1023. * @param {Object} obj 对象
  1024. * @return {Boolean}
  1025. */
  1026. var isUndefined = helperCreateInTypeof(staticStrUndefined)
  1027. /**
  1028. * 判断是否数组
  1029. *
  1030. * @param {Object} obj 对象
  1031. * @return {Boolean}
  1032. */
  1033. var isArray = Array.isArray || helperCreateInInObjectString('Array')
  1034. /**
  1035. * 判断是否小数
  1036. *
  1037. * @param {Number} obj 数值
  1038. * @return {Boolean}
  1039. */
  1040. function isFloat (obj) {
  1041. return !isNull(obj) && !isNaN(obj) && !isArray(obj) && !isInteger(obj)
  1042. }
  1043. /**
  1044. * 判断是否整数
  1045. *
  1046. * @param {Number, String} number 数值
  1047. * @return {Boolean}
  1048. */
  1049. var isInteger = function (obj) {
  1050. return !isNull(obj) && !isNaN(obj) && !isArray(obj) && obj % 1 === 0
  1051. }
  1052. /**
  1053. * 判断是否方法
  1054. *
  1055. * @param {Object} obj 对象
  1056. * @return {Boolean}
  1057. */
  1058. var isFunction = helperCreateInTypeof('function')
  1059. /**
  1060. * 判断是否Boolean对象
  1061. *
  1062. * @param {Object} obj 对象
  1063. * @return {Boolean}
  1064. */
  1065. var isBoolean = helperCreateInTypeof('boolean')
  1066. /**
  1067. * 判断是否String对象
  1068. *
  1069. * @param {Object} obj 对象
  1070. * @return {Boolean}
  1071. */
  1072. var isString = helperCreateInTypeof('string')
  1073. /**
  1074. * 判断是否Number对象
  1075. *
  1076. * @param {Object} obj 对象
  1077. * @return {Boolean}
  1078. */
  1079. var isNumber = helperCreateInTypeof('number')
  1080. /**
  1081. * 判断是否RegExp对象
  1082. *
  1083. * @param {Object} obj 对象
  1084. * @return {Boolean}
  1085. */
  1086. var isRegExp = helperCreateInInObjectString('RegExp')
  1087. /**
  1088. * 判断是否Object对象
  1089. *
  1090. * @param {Object} obj 对象
  1091. * @return {Boolean}
  1092. */
  1093. var isObject = helperCreateInTypeof('object')
  1094. /**
  1095. * 判断是否对象
  1096. *
  1097. * @param {Object} obj 对象
  1098. * @return {Boolean}
  1099. */
  1100. function isPlainObject (obj) {
  1101. return obj ? obj.constructor === Object : false
  1102. }
  1103. /**
  1104. * 判断是否Date对象
  1105. *
  1106. * @param {Object} obj 对象
  1107. * @return {Boolean}
  1108. */
  1109. var isDate = helperCreateInInObjectString('Date')
  1110. /**
  1111. * 判断是否Error对象
  1112. *
  1113. * @param {Object} obj 对象
  1114. * @return {Boolean}
  1115. */
  1116. var isError = helperCreateInInObjectString('Error')
  1117. /**
  1118. * 判断是否TypeError对象
  1119. *
  1120. * @param {Object} obj 对象
  1121. * @return {Boolean}
  1122. */
  1123. function isTypeError (obj) {
  1124. return obj ? obj.constructor === TypeError : false
  1125. }
  1126. /**
  1127. * 判断是否为空对象
  1128. *
  1129. * @param {Object} obj 对象
  1130. * @return {Boolean}
  1131. */
  1132. function isEmpty (obj) {
  1133. for (var key in obj) {
  1134. return false
  1135. }
  1136. return true
  1137. }
  1138. /**
  1139. * 判断是否为Null
  1140. *
  1141. * @param {Object} obj 对象
  1142. * @return {Boolean}
  1143. */
  1144. function isNull (obj) {
  1145. return obj === null
  1146. }
  1147. /* eslint-disable valid-typeof */
  1148. /**
  1149. * 判断是否Symbol对象
  1150. *
  1151. * @param {Object} obj 对象
  1152. * @return {Boolean}
  1153. */
  1154. var supportSymbol = typeof Symbol !== staticStrUndefined
  1155. function isSymbol (obj) {
  1156. return supportSymbol && Symbol.isSymbol ? Symbol.isSymbol(obj) : (typeof obj === 'symbol')
  1157. }
  1158. /**
  1159. * 判断是否Arguments对象
  1160. *
  1161. * @param {Object} obj 对象
  1162. * @return {Boolean}
  1163. */
  1164. var isArguments = helperCreateInInObjectString('Arguments')
  1165. /**
  1166. * 判断是否Element对象
  1167. *
  1168. * @param {Object} obj 对象
  1169. * @return {Boolean}
  1170. */
  1171. function isElement (obj) {
  1172. return !!(obj && isString(obj.nodeName) && isNumber(obj.nodeType))
  1173. }
  1174. /**
  1175. * 判断是否Document对象
  1176. *
  1177. * @param {Object} obj 对象
  1178. * @return {Boolean}
  1179. */
  1180. function isDocument (obj) {
  1181. return !!(obj && staticDocument && obj.nodeType === 9)
  1182. }
  1183. /**
  1184. * 判断是否Window对象
  1185. *
  1186. * @param {Object} obj 对象
  1187. * @return {Boolean}
  1188. */
  1189. function isWindow (obj) {
  1190. return staticWindow && !!(obj && obj === obj.window)
  1191. }
  1192. /* eslint-disable valid-typeof */
  1193. /**
  1194. * 判断是否FormData对象
  1195. *
  1196. * @param {Object} obj 对象
  1197. * @return {Boolean}
  1198. */
  1199. var supportFormData = typeof FormData !== staticStrUndefined
  1200. function isFormData (obj) {
  1201. return supportFormData && obj instanceof FormData
  1202. }
  1203. /* eslint-disable valid-typeof */
  1204. /**
  1205. * 判断是否Map对象
  1206. *
  1207. * @param {Object} obj 对象
  1208. * @return {Boolean}
  1209. */
  1210. var supportMap = typeof Map !== staticStrUndefined
  1211. function isMap (obj) {
  1212. return supportMap && obj instanceof Map
  1213. }
  1214. /* eslint-disable valid-typeof */
  1215. /**
  1216. * 判断是否WeakMap对象
  1217. *
  1218. * @param {Object} obj 对象
  1219. * @return {Boolean}
  1220. */
  1221. var supportWeakMap = typeof WeakMap !== staticStrUndefined
  1222. function isWeakMap (obj) {
  1223. return supportWeakMap && obj instanceof WeakMap
  1224. }
  1225. /* eslint-disable valid-typeof */
  1226. /**
  1227. * 判断是否Set对象
  1228. *
  1229. * @param {Object} obj 对象
  1230. * @return {Boolean}
  1231. */
  1232. var supportSet = typeof Set !== staticStrUndefined
  1233. function isSet (obj) {
  1234. return supportSet && obj instanceof Set
  1235. }
  1236. /* eslint-disable valid-typeof */
  1237. /**
  1238. * 判断是否WeakSet对象
  1239. *
  1240. * @param {Object} obj 对象
  1241. * @return {Boolean}
  1242. */
  1243. var supportWeakSet = typeof WeakSet !== staticStrUndefined
  1244. function isWeakSet (obj) {
  1245. return supportWeakSet && obj instanceof WeakSet
  1246. }
  1247. /**
  1248. * 判断是否闰年
  1249. *
  1250. * @param {Date} date 日期或数字
  1251. * @return {Boolean}
  1252. */
  1253. function isLeapYear (date) {
  1254. var year
  1255. var currentDate = date ? toStringDate(date) : helperNewDate()
  1256. if (isDate(currentDate)) {
  1257. year = currentDate.getFullYear()
  1258. return (year % 4 === 0) && (year % 100 !== 0 || year % 400 === 0)
  1259. }
  1260. return false
  1261. }
  1262. /**
  1263. * 判断属性中的键和值是否包含在对象中
  1264. *
  1265. * @param {Object/Array} obj 对象
  1266. * @param {Object} source 值
  1267. * @return {Boolean}
  1268. */
  1269. function isMatch (obj, source) {
  1270. var objKeys = keys(obj)
  1271. var sourceKeys = keys(source)
  1272. if (sourceKeys.length) {
  1273. if (includeArrays(objKeys, sourceKeys)) {
  1274. return some(sourceKeys, function (key2) {
  1275. return findIndexOf(objKeys, function (key1) {
  1276. return key1 === key2 && isEqual(obj[key1], source[key2])
  1277. }) > -1
  1278. })
  1279. }
  1280. } else {
  1281. return true
  1282. }
  1283. return isEqual(obj, source)
  1284. }
  1285. /**
  1286. * 深度比较两个对象之间的值是否相等
  1287. *
  1288. * @param {Object} obj1 值1
  1289. * @param {Object} obj2 值2
  1290. * @return {Boolean}
  1291. */
  1292. function isEqual (obj1, obj2) {
  1293. return helperEqualCompare(obj1, obj2, helperDefaultCompare)
  1294. }
  1295. /**
  1296. * 深度比较两个对象之间的值是否相等,使用自定义比较函数
  1297. *
  1298. * @param {Object} obj1 值1
  1299. * @param {Object} obj2 值2
  1300. * @param {Function} func 自定义函数
  1301. * @return {Boolean}
  1302. */
  1303. function isEqualWith (obj1, obj2, func) {
  1304. if (isFunction(func)) {
  1305. return helperEqualCompare(obj1, obj2, function (v1, v2, key, obj1, obj2) {
  1306. var result = func(v1, v2, key, obj1, obj2)
  1307. return isUndefined(result) ? helperDefaultCompare(v1, v2) : !!result
  1308. }, func)
  1309. }
  1310. return helperEqualCompare(obj1, obj2, helperDefaultCompare)
  1311. }
  1312. /**
  1313. * 获取对象类型
  1314. *
  1315. * @param {Object} obj 对象
  1316. * @return {String}
  1317. */
  1318. function getType (obj) {
  1319. if (isNull(obj)) {
  1320. return 'null'
  1321. }
  1322. if (isSymbol(obj)) {
  1323. return 'symbol'
  1324. }
  1325. if (isDate(obj)) {
  1326. return 'date'
  1327. }
  1328. if (isArray(obj)) {
  1329. return 'array'
  1330. }
  1331. if (isRegExp(obj)) {
  1332. return 'regexp'
  1333. }
  1334. if (isError(obj)) {
  1335. return 'error'
  1336. }
  1337. return typeof obj
  1338. }
  1339. /**
  1340. * 获取一个全局唯一标识
  1341. *
  1342. * @param {String} prefix 前缀
  1343. * @return {Number}
  1344. */
  1345. var __uniqueId = 0
  1346. function uniqueId (prefix) {
  1347. return [prefix, ++__uniqueId].join('')
  1348. }
  1349. /**
  1350. * 返回对象的长度
  1351. *
  1352. * @param {Object} obj 对象
  1353. * @return {Number}
  1354. */
  1355. function getSize (obj) {
  1356. var len = 0
  1357. if (isString(obj) || isArray(obj)) {
  1358. return obj.length
  1359. }
  1360. each(obj, function () {
  1361. len++
  1362. })
  1363. return len
  1364. }
  1365. /**
  1366. * 返回对象第一个索引值
  1367. *
  1368. * @param {Object} obj 对象
  1369. * @param {Object} val 值
  1370. * @return {Number}
  1371. */
  1372. var indexOf = helperCreateIndexOf('indexOf', arrayIndexOf)
  1373. /**
  1374. * 从最后开始的索引值,返回对象第一个索引值
  1375. *
  1376. * @param {Object} array 对象
  1377. * @param {Object} val 值
  1378. * @return {Number}
  1379. */
  1380. var lastIndexOf = helperCreateIndexOf('lastIndexOf', arrayLastIndexOf)
  1381. /**
  1382. * 返回对象第一个索引值
  1383. *
  1384. * @param {Object} obj 对象/数组
  1385. * @param {Function} iterate(item, index, obj) 回调
  1386. * @param {Object} context 上下文
  1387. * @return {Object}
  1388. */
  1389. var findIndexOf = helperCreateiterateIndexOf(function (obj, iterate, context) {
  1390. for (var index = 0, len = obj.length; index < len; index++) {
  1391. if (iterate.call(context, obj[index], index, obj)) {
  1392. return index
  1393. }
  1394. }
  1395. return -1
  1396. })
  1397. /**
  1398. * 从最后开始的索引值,返回对象第一个索引值
  1399. *
  1400. * @param {Object} obj 对象/数组
  1401. * @param {Function} iterate(item, index, obj) 回调
  1402. * @param {Object} context 上下文
  1403. * @return {Object}
  1404. */
  1405. var findLastIndexOf = helperCreateiterateIndexOf(function (obj, iterate, context) {
  1406. for (var len = obj.length - 1; len >= 0; len--) {
  1407. if (iterate.call(context, obj[len], len, obj)) {
  1408. return len
  1409. }
  1410. }
  1411. return -1
  1412. })
  1413. /**
  1414. * 字符串转JSON
  1415. *
  1416. * @param {String} str 字符串
  1417. * @return {Object} 返回转换后对象
  1418. */
  1419. function toStringJSON (str) {
  1420. if (isObject(str)) {
  1421. return str
  1422. } else if (isString(str)) {
  1423. try {
  1424. return JSON.parse(str)
  1425. } catch (e) {}
  1426. }
  1427. return {}
  1428. }
  1429. /**
  1430. * JSON转字符串
  1431. *
  1432. * @param {Object} obj 对象
  1433. * @return {String} 返回字符串
  1434. */
  1435. function toJSONString (obj) {
  1436. return JSON.stringify(obj) || ''
  1437. }
  1438. /**
  1439. * 获取对象所有属性
  1440. *
  1441. * @param {Object} obj 对象/数组
  1442. * @return {Array}
  1443. */
  1444. var keys = helperCreateGetObjects('keys', 1)
  1445. /**
  1446. * 获取对象所有值
  1447. *
  1448. * @param {Object} obj 对象/数组
  1449. * @return {Array}
  1450. */
  1451. var values = helperCreateGetObjects('values', 0)
  1452. /**
  1453. * 获取对象所有属性、值
  1454. *
  1455. * @param {Object} obj 对象/数组
  1456. * @return {Array}
  1457. */
  1458. var entries = helperCreateGetObjects('entries', 2)
  1459. /**
  1460. * 根据 key 过滤指定的属性值,返回一个新的对象
  1461. *
  1462. * @param {Object} obj 对象
  1463. * @param {String/Array} key 键数组
  1464. * @return {Object}
  1465. */
  1466. var pick = helperCreatePickOmit(1, 0)
  1467. /**
  1468. * 根据 key 排除指定的属性值,返回一个新的对象
  1469. *
  1470. * @param {Object} obj 对象
  1471. * @param {String/Array} key 键数组
  1472. * @return {Object}
  1473. */
  1474. var omit = helperCreatePickOmit(0, 1)
  1475. /**
  1476. * 获取对象第一个值
  1477. *
  1478. * @param {Object} obj 对象/数组
  1479. * @return {Object}
  1480. */
  1481. function first (obj) {
  1482. return values(obj)[0]
  1483. }
  1484. /**
  1485. * 获取对象最后一个值
  1486. *
  1487. * @param {Object} obj 对象/数组
  1488. * @return {Object}
  1489. */
  1490. function last (obj) {
  1491. var list = values(obj)
  1492. return list[list.length - 1]
  1493. }
  1494. /**
  1495. * 迭代器
  1496. *
  1497. * @param {Object} obj 对象/数组
  1498. * @param {Function} iterate(item, index, obj) 回调
  1499. * @param {Object} context 上下文
  1500. * @return {Object}
  1501. */
  1502. function each (obj, iterate, context) {
  1503. if (obj) {
  1504. return (isArray(obj) ? arrayEach : objectEach)(obj, iterate, context)
  1505. }
  1506. return obj
  1507. }
  1508. /**
  1509. * 迭代器,支持 return false 跳出循环 break
  1510. *
  1511. * @param {Object} obj 对象/数组
  1512. * @param {Function} iterate(item, index, obj) 回调
  1513. * @param {Object} context 上下文
  1514. * @return {Object}
  1515. */
  1516. function forOf (obj, iterate, context) {
  1517. if (obj) {
  1518. if (isArray(obj)) {
  1519. for (var index = 0, len = obj.length; index < len; index++) {
  1520. if (iterate.call(context, obj[index], index, obj) === false) {
  1521. break
  1522. }
  1523. }
  1524. } else {
  1525. for (var key in obj) {
  1526. if (hasOwnProp(obj, key)) {
  1527. if (iterate.call(context, obj[key], key, obj) === false) {
  1528. break
  1529. }
  1530. }
  1531. }
  1532. }
  1533. }
  1534. }
  1535. /**
  1536. * 迭代器,从最后开始迭代,支持 return false 跳出循环 break
  1537. *
  1538. * @param {Object} obj 对象/数组
  1539. * @param {Function} iterate(item, index, obj) 回调
  1540. * @param {Object} context 上下文
  1541. * @return {Object}
  1542. */
  1543. function lastForOf (obj, iterate, context) {
  1544. if (obj) {
  1545. var len, list
  1546. if (isArray(obj)) {
  1547. for (len = obj.length - 1; len >= 0; len--) {
  1548. if (iterate.call(context, obj[len], len, obj) === false) {
  1549. break
  1550. }
  1551. }
  1552. } else {
  1553. list = keys(obj)
  1554. for (len = list.length - 1; len >= 0; len--) {
  1555. if (iterate.call(context, obj[list[len]], list[len], obj) === false) {
  1556. break
  1557. }
  1558. }
  1559. }
  1560. }
  1561. }
  1562. /**
  1563. * 迭代器,从最后开始迭代
  1564. *
  1565. * @param {Object} obj 对象/数组
  1566. * @param {Function} iterate(item, index, obj) 回调
  1567. * @param {Object} context 上下文
  1568. * @return {Object}
  1569. */
  1570. function lastEach (obj, iterate, context) {
  1571. if (obj) {
  1572. return (isArray(obj) ? lastArrayEach : lastObjectEach)(obj, iterate, context)
  1573. }
  1574. return obj
  1575. }
  1576. /**
  1577. * 检查键、路径是否是该对象的属性
  1578. *
  1579. * @param {Object/Array} data 对象
  1580. * @param {String/Function} property 键、路径
  1581. * @return {Boolean}
  1582. */
  1583. function has (obj, property) {
  1584. if (obj) {
  1585. if (hasOwnProp(obj, property)) {
  1586. return true
  1587. } else {
  1588. var prop, arrIndex, objProp, matchs, rest, isHas
  1589. var props = helperGetHGSKeys(property)
  1590. var index = 0
  1591. var len = props.length
  1592. for (rest = obj; index < len; index++) {
  1593. isHas = false
  1594. prop = props[index]
  1595. matchs = prop ? prop.match(staticHGKeyRE) : ''
  1596. if (matchs) {
  1597. arrIndex = matchs[1]
  1598. objProp = matchs[2]
  1599. if (arrIndex) {
  1600. if (rest[arrIndex]) {
  1601. if (hasOwnProp(rest[arrIndex], objProp)) {
  1602. isHas = true
  1603. rest = rest[arrIndex][objProp]
  1604. }
  1605. }
  1606. } else {
  1607. if (hasOwnProp(rest, objProp)) {
  1608. isHas = true
  1609. rest = rest[objProp]
  1610. }
  1611. }
  1612. } else {
  1613. if (hasOwnProp(rest, prop)) {
  1614. isHas = true
  1615. rest = rest[prop]
  1616. }
  1617. }
  1618. if (isHas) {
  1619. if (index === len - 1) {
  1620. return true
  1621. }
  1622. } else {
  1623. break
  1624. }
  1625. }
  1626. }
  1627. }
  1628. return false
  1629. }
  1630. /**
  1631. * 获取对象的属性的值,如果值为 undefined,则返回默认值
  1632. * @param {Object/Array} obj 对象
  1633. * @param {String/Function} property 键、路径
  1634. * @param {Object} defaultValue 默认值
  1635. * @return {Object}
  1636. */
  1637. function get (obj, property, defaultValue) {
  1638. if (eqNull(obj)) {
  1639. return defaultValue
  1640. }
  1641. var result = pathGet(obj, property)
  1642. return isUndefined(result) ? defaultValue : result
  1643. }
  1644. function valGet (obj, key) {
  1645. var matchs = key ? key.match(staticHGKeyRE) : ''
  1646. return matchs ? (matchs[1] ? (obj[matchs[1]] ? obj[matchs[1]][matchs[2]] : undefined) : obj[matchs[2]]) : obj[key]
  1647. }
  1648. function pathGet (obj, property) {
  1649. if (obj) {
  1650. var rest, props, len
  1651. var index = 0
  1652. if (obj[property] || hasOwnProp(obj, property)) {
  1653. return obj[property]
  1654. } else {
  1655. props = helperGetHGSKeys(property)
  1656. len = props.length
  1657. if (len) {
  1658. for (rest = obj; index < len; index++) {
  1659. rest = valGet(rest, props[index])
  1660. if (eqNull(rest)) {
  1661. if (index === len - 1) {
  1662. return rest
  1663. }
  1664. return
  1665. }
  1666. }
  1667. }
  1668. return rest
  1669. }
  1670. }
  1671. }
  1672. var sKeyRE = /(.+)\[(\d+)\]$/
  1673. function valSet (obj, key, isSet, value) {
  1674. if (obj[key]) {
  1675. if (isSet) {
  1676. obj[key] = value
  1677. }
  1678. } else {
  1679. var index
  1680. var matchs = key ? key.match(sKeyRE) : null
  1681. var rest = isSet ? value : {}
  1682. if (matchs) {
  1683. index = staticParseInt(matchs[2])
  1684. if (obj[matchs[1]]) {
  1685. obj[matchs[1]][index] = rest
  1686. } else {
  1687. obj[matchs[1]] = new Array(index + 1)
  1688. obj[matchs[1]][index] = rest
  1689. }
  1690. } else {
  1691. obj[key] = rest
  1692. }
  1693. return rest
  1694. }
  1695. return obj[key]
  1696. }
  1697. /**
  1698. * 设置对象属性上的值。如果属性不存在则创建它
  1699. * @param {Object/Array} obj 对象
  1700. * @param {String/Function} property 键、路径
  1701. * @param {Object} value 值
  1702. */
  1703. function set (obj, property, value) {
  1704. if (obj) {
  1705. if (obj[property] || hasOwnProp(obj, property)) {
  1706. obj[property] = value
  1707. } else {
  1708. var rest = obj
  1709. var props = helperGetHGSKeys(property)
  1710. var len = props.length
  1711. for (var index = 0; index < len; index++) {
  1712. rest = valSet(rest, props[index], index === len - 1, value)
  1713. }
  1714. }
  1715. }
  1716. return obj
  1717. }
  1718. function createiterateEmpty (iterate) {
  1719. return function () {
  1720. return isEmpty(iterate)
  1721. }
  1722. }
  1723. /**
  1724. * 集合分组,默认使用键值分组,如果有iterate则使用结果进行分组
  1725. *
  1726. * @param {Array} obj 对象
  1727. * @param {Function} iterate 回调/对象属性
  1728. * @param {Object} context 上下文
  1729. * @return {Object}
  1730. */
  1731. function groupBy (obj, iterate, context) {
  1732. var groupKey
  1733. var result = {}
  1734. if (obj) {
  1735. if (iterate && isObject(iterate)) {
  1736. iterate = createiterateEmpty(iterate)
  1737. } else if (!isFunction(iterate)) {
  1738. iterate = property(iterate)
  1739. }
  1740. each(obj, function (val, key) {
  1741. groupKey = iterate ? iterate.call(context, val, key, obj) : val
  1742. if (result[groupKey]) {
  1743. result[groupKey].push(val)
  1744. } else {
  1745. result[groupKey] = [val]
  1746. }
  1747. })
  1748. }
  1749. return result
  1750. }
  1751. /**
  1752. * 集合分组统计,返回各组中对象的数量统计
  1753. *
  1754. * @param {Array} obj 对象
  1755. * @param {Function} iterate 回调/对象属性
  1756. * @param {Object} context 上下文
  1757. * @return {Object}
  1758. */
  1759. function countBy (obj, iterate, context) {
  1760. var result = groupBy(obj, iterate, context || this)
  1761. objectEach(result, function (item, key) {
  1762. result[key] = item.length
  1763. })
  1764. return result
  1765. }
  1766. function handleObjectAndArrayClone (func, obj, deep) {
  1767. return func(obj, deep ? function (val) {
  1768. return copyValue(val, deep)
  1769. } : function (val) {
  1770. return val
  1771. })
  1772. }
  1773. function handleValueClone (val, deep) {
  1774. if (deep && val) {
  1775. var Ctor = val.constructor
  1776. switch (objectToString.call(val)) {
  1777. case '[object Date]':
  1778. case '[object RegExp]':
  1779. return new Ctor(val.valueOf())
  1780. case '[object Set]':
  1781. var set = new Ctor()
  1782. val.forEach(function (v) {
  1783. set.add(v)
  1784. })
  1785. return set
  1786. case '[object Map]':
  1787. var map = new Ctor()
  1788. val.forEach(function (v, k) {
  1789. map.set(k, v)
  1790. })
  1791. return map
  1792. }
  1793. }
  1794. return val
  1795. }
  1796. function copyValue (val, deep) {
  1797. if (isPlainObject(val)) {
  1798. return handleObjectAndArrayClone(objectMap, val, deep)
  1799. } else if (isArray(val)) {
  1800. return handleObjectAndArrayClone(map, val, deep)
  1801. }
  1802. return handleValueClone(val, deep)
  1803. }
  1804. /**
  1805. * 浅拷贝/深拷贝
  1806. *
  1807. * @param {Object} obj 对象/数组
  1808. * @param {Boolean} deep 是否深拷贝
  1809. * @return {Object}
  1810. */
  1811. function clone (obj, deep) {
  1812. if (obj) {
  1813. return copyValue(obj, deep)
  1814. }
  1815. return obj
  1816. }
  1817. /**
  1818. * 清空对象
  1819. *
  1820. * @param {Object} obj 对象
  1821. * @param {*} defs 默认值,如果不传(清空所有属性)、如果传对象(清空并继承)、如果传值(给所有赋值)
  1822. * @param {Object/Array} assigns 默认值
  1823. * @return {Object}
  1824. */
  1825. function clear (obj, defs, assigns) {
  1826. if (obj) {
  1827. var len
  1828. var isDefs = arguments.length > 1 && (isNull(defs) || !isObject(defs))
  1829. var extds = isDefs ? assigns : defs
  1830. if (isPlainObject(obj)) {
  1831. objectEach(obj, isDefs ? function (val, key) {
  1832. obj[key] = defs
  1833. } : function (val, key) {
  1834. helperDeleteProperty(obj, key)
  1835. })
  1836. if (extds) {
  1837. assign(obj, extds)
  1838. }
  1839. } else if (isArray(obj)) {
  1840. if (isDefs) {
  1841. len = obj.length
  1842. while (len > 0) {
  1843. len--
  1844. obj[len] = defs
  1845. }
  1846. } else {
  1847. obj.length = 0
  1848. }
  1849. if (extds) {
  1850. obj.push.apply(obj, extds)
  1851. }
  1852. }
  1853. }
  1854. return obj
  1855. }
  1856. function pluckProperty (name) {
  1857. return function (obj, key) {
  1858. return key === name
  1859. }
  1860. }
  1861. /**
  1862. * 移除对象属性
  1863. *
  1864. * @param {Object/Array} obj 对象/数组
  1865. * @param {Function/String} iterate 方法或属性
  1866. * @param {Object} context 上下文
  1867. * @return {Object/Array}
  1868. */
  1869. function remove (obj, iterate, context) {
  1870. if (obj) {
  1871. if (!eqNull(iterate)) {
  1872. var removeKeys = []
  1873. var rest = []
  1874. if (!isFunction(iterate)) {
  1875. iterate = pluckProperty(iterate)
  1876. }
  1877. each(obj, function (item, index, rest) {
  1878. if (iterate.call(context, item, index, rest)) {
  1879. removeKeys.push(index)
  1880. }
  1881. })
  1882. if (isArray(obj)) {
  1883. lastEach(removeKeys, function (item, key) {
  1884. rest.push(obj[item])
  1885. obj.splice(item, 1)
  1886. })
  1887. } else {
  1888. rest = {}
  1889. arrayEach(removeKeys, function (key) {
  1890. rest[key] = obj[key]
  1891. helperDeleteProperty(obj, key)
  1892. })
  1893. }
  1894. return rest
  1895. }
  1896. return clear(obj)
  1897. }
  1898. return obj
  1899. }
  1900. /**
  1901. * 序号列表生成函数
  1902. *
  1903. * @param {Number} start 起始值
  1904. * @param {Number} stop 结束值
  1905. * @param {Number} step 自增值
  1906. * @return {Object}
  1907. */
  1908. function range (start, stop, step) {
  1909. var index, len
  1910. var result = []
  1911. var args = arguments
  1912. if (args.length < 2) {
  1913. stop = args[0]
  1914. start = 0
  1915. }
  1916. index = start >> 0
  1917. len = stop >> 0
  1918. if (index < stop) {
  1919. step = step >> 0 || 1
  1920. for (; index < len; index += step) {
  1921. result.push(index)
  1922. }
  1923. }
  1924. return result
  1925. }
  1926. /**
  1927. * 将一个或者多个对象值解构到目标对象
  1928. *
  1929. * @param {Object} destination 目标对象
  1930. * @param {...Object}
  1931. * @return {Boolean}
  1932. */
  1933. function destructuring (destination, sources) {
  1934. if (destination && sources) {
  1935. var rest = assign.apply(this, [{}].concat(slice(arguments, 1)))
  1936. var restKeys = keys(rest)
  1937. arrayEach(keys(destination), function (key) {
  1938. if (includes(restKeys, key)) {
  1939. destination[key] = rest[key]
  1940. }
  1941. })
  1942. }
  1943. return destination
  1944. }
  1945. function helperCreateGetObjects (name, getIndex) {
  1946. var proMethod = Object[name]
  1947. return function (obj) {
  1948. var result = []
  1949. if (obj) {
  1950. if (proMethod) {
  1951. return proMethod(obj)
  1952. }
  1953. each(obj, getIndex > 1 ? function (key) {
  1954. result.push(['' + key, obj[key]])
  1955. } : function () {
  1956. result.push(arguments[getIndex])
  1957. })
  1958. }
  1959. return result
  1960. }
  1961. }
  1962. function helperCreateIndexOf (name, callback) {
  1963. return function (obj, val) {
  1964. if (obj) {
  1965. if (typeof obj === 'string' || isArray(obj)) {
  1966. if (obj[name]) {
  1967. return obj[name](val)
  1968. }
  1969. return callback(obj, val)
  1970. }
  1971. for (var key in obj) {
  1972. if (hasOwnProp(obj, key)) {
  1973. if (val === obj[key]) {
  1974. return key
  1975. }
  1976. }
  1977. }
  1978. }
  1979. return -1
  1980. }
  1981. }
  1982. function helperCreateInInObjectString (type) {
  1983. return function (obj) {
  1984. return '[object ' + type + ']' === objectToString.call(obj)
  1985. }
  1986. }
  1987. /* eslint-disable valid-typeof */
  1988. function helperCreateInTypeof (type) {
  1989. return function (obj) {
  1990. return typeof obj === type
  1991. }
  1992. }
  1993. function helperCreateiterateIndexOf (callback) {
  1994. return function (obj, iterate, context) {
  1995. if (obj && isFunction(iterate)) {
  1996. if (isArray(obj) || isString(obj)) {
  1997. return callback(obj, iterate, context)
  1998. }
  1999. for (var key in obj) {
  2000. if (hasOwnProp(obj, key)) {
  2001. if (iterate.call(context, obj[key], key, obj)) {
  2002. return key
  2003. }
  2004. }
  2005. }
  2006. }
  2007. return -1
  2008. }
  2009. }
  2010. function helperCreatePickOmit (case1, case2) {
  2011. return function (obj, callback) {
  2012. var item, index
  2013. var rest = {}
  2014. var result = []
  2015. var context = this
  2016. var args = arguments
  2017. var len = args.length
  2018. if (!isFunction(callback)) {
  2019. for (index = 1; index < len; index++) {
  2020. item = args[index]
  2021. result.push.apply(result, isArray(item) ? item : [item])
  2022. }
  2023. callback = 0
  2024. }
  2025. each(obj, function (val, key) {
  2026. if ((callback ? callback.call(context, val, key, obj) : findIndexOf(result, function (name) {
  2027. return name === key
  2028. }) > -1) ? case1 : case2) {
  2029. rest[key] = val
  2030. }
  2031. })
  2032. return rest
  2033. }
  2034. }
  2035. function helperDefaultCompare (v1, v2) {
  2036. return v1 === v2
  2037. }
  2038. function helperDeleteProperty (obj, property) {
  2039. try {
  2040. delete obj[property]
  2041. } catch (e) {
  2042. obj[property] = undefined
  2043. }
  2044. }
  2045. function helperEqualCompare (val1, val2, compare, func, key, obj1, obj2) {
  2046. if (val1 === val2) {
  2047. return true
  2048. }
  2049. if (val1 && val2 && !isNumber(val1) && !isNumber(val2) && !isString(val1) && !isString(val2)) {
  2050. if (isRegExp(val1)) {
  2051. return compare('' + val1, '' + val2, key, obj1, obj2)
  2052. } if (isDate(val1) || isBoolean(val1)) {
  2053. return compare(+val1, +val2, key, obj1, obj2)
  2054. } else {
  2055. var result, val1Keys, val2Keys
  2056. var isObj1Arr = isArray(val1)
  2057. var isObj2Arr = isArray(val2)
  2058. if (isObj1Arr || isObj2Arr ? isObj1Arr && isObj2Arr : val1.constructor === val2.constructor) {
  2059. val1Keys = keys(val1)
  2060. val2Keys = keys(val2)
  2061. if (func) {
  2062. result = func(val1, val2, key)
  2063. }
  2064. if (val1Keys.length === val2Keys.length) {
  2065. return isUndefined(result) ? every(val1Keys, function (key, index) {
  2066. return key === val2Keys[index] && helperEqualCompare(val1[key], val2[val2Keys[index]], compare, func, isObj1Arr || isObj2Arr ? index : key, val1, val2)
  2067. }) : !!result
  2068. }
  2069. return false
  2070. }
  2071. }
  2072. }
  2073. return compare(val1, val2, key, obj1, obj2)
  2074. }
  2075. function helperGetHGSKeys (property) {
  2076. // 以最快的方式判断数组,可忽略准确性
  2077. return property ? (property.splice && property.join ? property : ('' + property).split('.')) : []
  2078. }
  2079. /**
  2080. * 获取一个指定范围内随机数
  2081. *
  2082. * @param {Number} minVal 最小值
  2083. * @param {Number} maxVal 最大值
  2084. * @return {Number}
  2085. */
  2086. function random (minVal, maxVal) {
  2087. return minVal >= maxVal ? minVal : ((minVal = minVal >> 0) + Math.round(Math.random() * ((maxVal || 9) - minVal)))
  2088. }
  2089. /**
  2090. * 获取最小值
  2091. *
  2092. * @param {Array} arr 数组
  2093. * @param {Function} iterate(item, index, obj) 回调
  2094. * @return {Number}
  2095. */
  2096. var min = helperCreateMinMax(function (rest, itemVal) {
  2097. return rest > itemVal
  2098. })
  2099. /**
  2100. * 获取最大值
  2101. *
  2102. * @param {Array} arr 数组
  2103. * @param {Function} iterate(item, index, obj) 回调
  2104. * @return {Number}
  2105. */
  2106. var max = helperCreateMinMax(function (rest, itemVal) {
  2107. return rest < itemVal
  2108. })
  2109. /**
  2110. * 千分位分隔符、小数点
  2111. *
  2112. * @param {String/Number} num 数值
  2113. * @param {CommafyOptions} options 参数
  2114. * @return {String}
  2115. */
  2116. function commafy (num, options) {
  2117. var opts = options || {}
  2118. var optDigits = opts.digits || opts.fixed
  2119. var isNum = isNumber(num)
  2120. var rest, result, isNegative, intStr, floatStr
  2121. if (isNum) {
  2122. rest = (opts.ceil ? ceil : (opts.floor ? floor : round))(num, optDigits)
  2123. result = toNumberString(optDigits ? toFixed(rest, optDigits) : rest).split('.')
  2124. intStr = result[0]
  2125. floatStr = result[1]
  2126. isNegative = intStr && rest < 0
  2127. if (isNegative) {
  2128. intStr = intStr.substring(1, intStr.length)
  2129. }
  2130. } else {
  2131. // 如果为字符串,仅用于分隔
  2132. rest = toValString(num).replace(/,/g, '')
  2133. result = rest ? [rest] : []
  2134. intStr = result[0]
  2135. }
  2136. if (result.length) {
  2137. return (isNegative ? '-' : '') + intStr.replace(new RegExp('(?=(?!(\\b))(.{' + (opts.spaceNumber || 3) + '})+$)', 'g'), (opts.separator || ',')) + (floatStr ? ('.' + floatStr) : '')
  2138. }
  2139. return rest
  2140. }
  2141. /**
  2142. * 将数值四舍五入
  2143. *
  2144. * @param {string|number} num 数值
  2145. * @param {number} digits 小数保留位数
  2146. * @return {number}
  2147. */
  2148. var round = helperCreateMathNumber('round')
  2149. /**
  2150. * 将数值向上舍入
  2151. *
  2152. * @param {string|number} num 数值
  2153. * @param {number} digits 小数保留位数
  2154. * @return {number}
  2155. */
  2156. var ceil = helperCreateMathNumber('ceil')
  2157. /**
  2158. * 将数值向下舍入
  2159. *
  2160. * @param {string|number} num 数值
  2161. * @param {number} digits 小数保留位数
  2162. * @return {number}
  2163. */
  2164. var floor = helperCreateMathNumber('floor')
  2165. /**
  2166. * 将数值四舍五入并格式化为固定小数位的字符串
  2167. *
  2168. * @param {string|number} num 数值
  2169. * @param {number} digits 小数保留位数
  2170. * @return {String}
  2171. */
  2172. function toFixed (num, digits) {
  2173. var str = toValString(round(num, digits))
  2174. var nums = str.split('.')
  2175. var intStr = nums[0]
  2176. var floatStr = nums[1] || ''
  2177. var digitOffsetIndex = digits - floatStr.length
  2178. if (digits) {
  2179. if (digitOffsetIndex > 0) {
  2180. return intStr + '.' + floatStr + helperStringRepeat('0', digitOffsetIndex)
  2181. }
  2182. return intStr + helperNumberOffsetPoint(floatStr, Math.abs(digitOffsetIndex))
  2183. }
  2184. return intStr
  2185. }
  2186. /**
  2187. * 和 Number.toFixed 类似,区别就是不会对小数进行四舍五入,结果返回字符串
  2188. *
  2189. * @param { String/Number } str 数值
  2190. * @return {String}
  2191. */
  2192. function toFixedString (str, digits) {
  2193. return toFixed(floor(str, digits), digits)
  2194. }
  2195. /**
  2196. * 和 Number.toFixed 类似,区别就是不会对小数进行四舍五入,结果返回数值
  2197. *
  2198. * @param { String/Number } str 数值
  2199. * @return {String}
  2200. */
  2201. function toFixedNumber (str, digits) {
  2202. return floor(str, digits)
  2203. }
  2204. /**
  2205. * 转数值
  2206. * @param { String/Number } str 数值
  2207. *
  2208. * @return {Number}
  2209. */
  2210. var toNumber = helperCreateToNumber(parseFloat)
  2211. /**
  2212. * 数值转字符串,科学计数转字符串
  2213. * @param { Number } num 数值
  2214. *
  2215. * @return {Number}
  2216. */
  2217. function toNumberString (num) {
  2218. var rest = '' + num
  2219. var scienceMatchs = rest.match(/^([-+]?)((\d+)|((\d+)?[.](\d+)?))e([-+]{1})([0-9]+)$/)
  2220. if (scienceMatchs) {
  2221. var isNegative = num < 0
  2222. var absFlag = isNegative ? '-' : ''
  2223. var intNumStr = scienceMatchs[3] || ''
  2224. var dIntNumStr = scienceMatchs[5] || ''
  2225. var dFloatNumStr = scienceMatchs[6] || ''
  2226. var sciencFlag = scienceMatchs[7]
  2227. var scienceNumStr = scienceMatchs[8]
  2228. var floatOffsetIndex = scienceNumStr - dFloatNumStr.length
  2229. var intOffsetIndex = scienceNumStr - intNumStr.length
  2230. var dIntOffsetIndex = scienceNumStr - dIntNumStr.length
  2231. if (sciencFlag === '+') {
  2232. if (intNumStr) {
  2233. return absFlag + intNumStr + helperStringRepeat('0', scienceNumStr)
  2234. }
  2235. if (floatOffsetIndex > 0) {
  2236. return absFlag + dIntNumStr + dFloatNumStr + helperStringRepeat('0', floatOffsetIndex)
  2237. }
  2238. return absFlag + dIntNumStr + helperNumberOffsetPoint(dFloatNumStr, scienceNumStr)
  2239. }
  2240. if (intNumStr) {
  2241. if (intOffsetIndex > 0) {
  2242. return absFlag + '0.' + helperStringRepeat('0', Math.abs(intOffsetIndex)) + intNumStr
  2243. }
  2244. return absFlag + helperNumberOffsetPoint(intNumStr, intOffsetIndex)
  2245. }
  2246. if (dIntOffsetIndex > 0) {
  2247. return absFlag + '0.' + helperStringRepeat('0', Math.abs(dIntOffsetIndex)) + dIntNumStr + dFloatNumStr
  2248. }
  2249. return absFlag + helperNumberOffsetPoint(dIntNumStr, dIntOffsetIndex) + dFloatNumStr
  2250. }
  2251. return rest
  2252. }
  2253. /**
  2254. * 转整数
  2255. * @param { String/Number } str 数值
  2256. *
  2257. * @return {Number}
  2258. */
  2259. var toInteger = helperCreateToNumber(staticParseInt)
  2260. /**
  2261. * 加法运算
  2262. *
  2263. * @param { Number } num1 被加数
  2264. * @param { Number } num2 加数
  2265. * @return {Number}
  2266. */
  2267. function add (num1, num2) {
  2268. return helperNumberAdd(toNumber(num1), toNumber(num2))
  2269. }
  2270. /**
  2271. * 减法运算
  2272. *
  2273. * @param { Number } num1 被减数
  2274. * @param { Number } num2 减数
  2275. * @return {Number}
  2276. */
  2277. function subtract (num1, num2) {
  2278. var subtrahend = toNumber(num1)
  2279. var minuend = toNumber(num2)
  2280. var str1 = toNumberString(subtrahend)
  2281. var str2 = toNumberString(minuend)
  2282. var digit1 = helperNumberDecimal(str1)
  2283. var digit2 = helperNumberDecimal(str2)
  2284. var ratio = Math.pow(10, Math.max(digit1, digit2))
  2285. var precision = (digit1 >= digit2) ? digit1 : digit2
  2286. return parseFloat(toFixed((subtrahend * ratio - minuend * ratio) / ratio, precision))
  2287. }
  2288. /**
  2289. * 乘法运算
  2290. *
  2291. * @param { Number } num1 数值1
  2292. * @param { Number } num2 数值2
  2293. * @return {Number}
  2294. */
  2295. function multiply (num1, num2) {
  2296. var multiplier = toNumber(num1)
  2297. var multiplicand = toNumber(num2)
  2298. var str1 = toNumberString(multiplier)
  2299. var str2 = toNumberString(multiplicand)
  2300. return parseInt(str1.replace('.', '')) * parseInt(str2.replace('.', '')) / Math.pow(10, helperNumberDecimal(str1) + helperNumberDecimal(str2))
  2301. }
  2302. /**
  2303. * 除法运算
  2304. *
  2305. * @param { Number } num1 数值1
  2306. * @param { Number } num2 数值2
  2307. * @return {Number}
  2308. */
  2309. function divide (num1, num2) {
  2310. return helperNumberDivide(toNumber(num1), toNumber(num2))
  2311. }
  2312. /**
  2313. * 求和函数,将数值相加
  2314. *
  2315. * @param {Array} array 数组
  2316. * @param {Function/String} iterate 方法或属性
  2317. * @param {Object} context 上下文
  2318. * @return {Number}
  2319. */
  2320. function sum (array, iterate, context) {
  2321. var result = 0
  2322. each(array, iterate ? isFunction(iterate) ? function () {
  2323. result = helperNumberAdd(result, iterate.apply(context, arguments))
  2324. } : function (val) {
  2325. result = helperNumberAdd(result, get(val, iterate))
  2326. } : function (val) {
  2327. result = helperNumberAdd(result, val)
  2328. })
  2329. return result
  2330. }
  2331. /**
  2332. * 求平均值函数
  2333. *
  2334. * @param {Array} array 数组
  2335. * @param {Function/String} iterate 方法或属性
  2336. * @param {Object} context 上下文
  2337. * @return {Number}
  2338. */
  2339. function mean (array, iterate, context) {
  2340. return helperNumberDivide(sum(array, iterate, context), getSize(array))
  2341. }
  2342. function helperCreateMathNumber (name) {
  2343. return function (num, digits) {
  2344. var rest = toNumber(num)
  2345. if (rest) {
  2346. digits = digits >> 0
  2347. var numStr = toNumberString(rest)
  2348. var nums = numStr.split('.')
  2349. var intStr = nums[0]
  2350. var floatStr = nums[1] || ''
  2351. rest = intStr + '.' + floatStr.substring(0, digits + 1)
  2352. if (digits >= floatStr.length) {
  2353. return toNumber(rest)
  2354. }
  2355. if (digits > 0) {
  2356. var ratio = Math.pow(10, digits)
  2357. return Math[name](rest * ratio) / ratio
  2358. }
  2359. return Math[name](rest)
  2360. }
  2361. return rest
  2362. }
  2363. }
  2364. function helperCreateMinMax (handle) {
  2365. return function (arr, iterate) {
  2366. if (arr && arr.length) {
  2367. var rest, itemIndex
  2368. arrayEach(arr, function (itemVal, index) {
  2369. if (iterate) {
  2370. itemVal = isFunction(iterate) ? iterate(itemVal, index, arr) : get(itemVal, iterate)
  2371. }
  2372. if (!eqNull(itemVal) && (eqNull(rest) || handle(rest, itemVal))) {
  2373. itemIndex = index
  2374. rest = itemVal
  2375. }
  2376. })
  2377. return arr[itemIndex]
  2378. }
  2379. return rest
  2380. }
  2381. }
  2382. function helperCreateToNumber (handle) {
  2383. return function (str) {
  2384. if (str) {
  2385. var num = handle(str)
  2386. if (!isNaN(num)) {
  2387. return num
  2388. }
  2389. }
  2390. return 0
  2391. }
  2392. }
  2393. function helperNumberAdd (addend, augend) {
  2394. var str1 = toNumberString(addend)
  2395. var str2 = toNumberString(augend)
  2396. var ratio = Math.pow(10, Math.max(helperNumberDecimal(str1), helperNumberDecimal(str2)))
  2397. return (multiply(addend, ratio) + multiply(augend, ratio)) / ratio
  2398. }
  2399. function helperNumberDecimal (numStr) {
  2400. return (numStr.split('.')[1] || '').length
  2401. }
  2402. function helperNumberDivide (divisor, dividend) {
  2403. var str1 = toNumberString(divisor)
  2404. var str2 = toNumberString(dividend)
  2405. var divisorDecimal = helperNumberDecimal(str1)
  2406. var dividendDecimal = helperNumberDecimal(str2)
  2407. var powY = dividendDecimal - divisorDecimal
  2408. var isMinus = powY < 0
  2409. var multiplicand = Math.pow(10, isMinus ? Math.abs(powY) : powY)
  2410. return multiply(str1.replace('.', '') / str2.replace('.', ''), isMinus ? 1 / multiplicand : multiplicand)
  2411. }
  2412. function helperNumberOffsetPoint (str, offsetIndex) {
  2413. return str.substring(0, offsetIndex) + '.' + str.substring(offsetIndex, str.length)
  2414. }
  2415. /**
  2416. * 返回当前时间戳
  2417. *
  2418. * @returns Number
  2419. */
  2420. var now = Date.now || function () {
  2421. return helperGetDateTime(helperNewDate())
  2422. }
  2423. /**
  2424. * 将日期格式化为时间戳
  2425. *
  2426. * @param {String/Number/Date} str 日期或数字
  2427. * @param {String} format 解析日期格式
  2428. * @returns Number
  2429. */
  2430. var timestamp = function (str, format) {
  2431. if (str) {
  2432. var date = toStringDate(str, format)
  2433. return isDate(date) ? helperGetDateTime(date) : date
  2434. }
  2435. return now()
  2436. }
  2437. /**
  2438. * 判断是否有效的Date对象
  2439. *
  2440. * @param {any} val 对象
  2441. * @return {boolean}
  2442. */
  2443. function isValidDate (val) {
  2444. return isDate(val) && !isNaN(helperGetDateTime(val))
  2445. }
  2446. /**
  2447. * 比较两个日期
  2448. *
  2449. * @param {Number/String/Date} date1 日期
  2450. * @param {Number/String/Date} date2 日期
  2451. * @param {String} format 对比格式
  2452. */
  2453. function isDateSame (date1, date2, format) {
  2454. if (date1 && date2) {
  2455. date1 = toDateString(date1, format)
  2456. return date1 !== 'Invalid Date' && date1 === toDateString(date2, format)
  2457. }
  2458. return false
  2459. }
  2460. var dateFormatRules = [
  2461. { rules: [['yyyy', 4]] },
  2462. { rules: [['MM', 2], ['M', 1]], offset: -1 },
  2463. { rules: [['dd', 2], ['d', 1]] },
  2464. { rules: [['HH', 2], ['H', 1]] },
  2465. { rules: [['mm', 2], ['m', 1]] },
  2466. { rules: [['ss', 2], ['s', 1]] },
  2467. { rules: [['SSS', 3], ['S', 1]] },
  2468. { rules: [['ZZ', 5], ['Z', 6], ['Z', 5], ['Z', 1]] }
  2469. ]
  2470. function parseStringDate (str, format) {
  2471. var arr, sIndex, fIndex, fLen, fItem, rules, rIndex, rLen, tempMatch
  2472. var dates = [0, 0, 1, 0, 0, 0, 0]
  2473. for (fIndex = 0, fLen = dateFormatRules.length; fIndex < fLen; fIndex++) {
  2474. fItem = dateFormatRules[fIndex]
  2475. for (rIndex = 0, rules = fItem.rules, rLen = rules.length; rIndex < rLen; rIndex++) {
  2476. arr = rules[rIndex]
  2477. sIndex = format.indexOf(arr[0])
  2478. if (sIndex > -1) {
  2479. tempMatch = str.substring(sIndex, sIndex + arr[1])
  2480. if (tempMatch && tempMatch.length === arr[1]) {
  2481. if (fItem.offset) {
  2482. tempMatch = staticParseInt(tempMatch) + fItem.offset
  2483. }
  2484. dates[fIndex] = tempMatch
  2485. break
  2486. }
  2487. }
  2488. if (rIndex === rLen - 1) {
  2489. return dates
  2490. }
  2491. }
  2492. }
  2493. return dates
  2494. }
  2495. /**
  2496. * 字符串转为日期
  2497. *
  2498. * @param {String/Number/Date} str 日期或数字
  2499. * @param {String} format 解析日期格式(yyyy年份、MM月份、dd天、hh(12)HH(24)小时、mm分钟、ss秒、SSS毫秒、Z时区)
  2500. * @return {String}
  2501. */
  2502. function toStringDate (str, format) {
  2503. var rest, isDType
  2504. if (str) {
  2505. isDType = isDate(str)
  2506. if (isDType || (!format && /^[0-9]{11,15}$/.test(str))) {
  2507. rest = new Date(isDType ? helperGetDateTime(str) : staticParseInt(str))
  2508. } else if (isString(str)) {
  2509. var tempMatch
  2510. var dates = parseStringDate(str, format || setupDefaults.formatDate)
  2511. var zStr = dates[7]
  2512. if (dates[0]) {
  2513. // 解析时区
  2514. if (zStr) {
  2515. // 如果为UTC 时间
  2516. if (zStr[0] === 'z' || zStr[0] === 'Z') {
  2517. rest = new Date(helperGetUTCDateTime(dates))
  2518. } else {
  2519. // 如果指定时区,时区转换
  2520. tempMatch = zStr.match(/([-+]{1})(\d{2}):?(\d{2})/)
  2521. if (tempMatch) {
  2522. rest = new Date(helperGetUTCDateTime(dates) - (tempMatch[1] === '-' ? -1 : 1) * staticParseInt(tempMatch[2]) * 3600000 + staticParseInt(tempMatch[3]) * 60000)
  2523. }
  2524. }
  2525. } else {
  2526. rest = new Date(dates[0], dates[1], dates[2], dates[3], dates[4], dates[5], dates[6])
  2527. }
  2528. }
  2529. }
  2530. }
  2531. return rest || new Date('')
  2532. }
  2533. function handleCustomTemplate (date, formats, match, value) {
  2534. var format = formats[match]
  2535. if (format) {
  2536. if (isFunction(format)) {
  2537. return format(value, match, date)
  2538. } else {
  2539. return format[value]
  2540. }
  2541. }
  2542. return value
  2543. }
  2544. function formatDayE (day) {
  2545. return day === 0 ? 7 : day
  2546. }
  2547. /**
  2548. * 日期格式化为字符串,转义符号 []
  2549. *
  2550. * @param {Date} date 日期或数字
  2551. * @param {String} format 输出日期格式(年份(yy|yyyy)、月份(M|MM自动补0)、天(d|dd自动补0)、12小时制(h|hh自动补0)、24小时制(H|HH自动补0)、分钟(m|mm自动补0)、秒(s|ss自动补0)、毫秒(S|SSS自动补0)、D当年的第几天、a/A上午下午、e/E星期几、w当年的第几周、W当月的第几周、q当年第几个季度、Z时区)
  2552. * @param {Object} options {formats: {q: ['日', '一', '二', '三', '四', '五', '六'], E: function (value, match, date) {return '三'}, }} 自定义格式化模板
  2553. * @return {String}
  2554. */
  2555. var dateFormatRE = /\[([^\]]+)]|y{2,4}|M{1,2}|d{1,2}|H{1,2}|h{1,2}|m{1,2}|s{1,2}|S{1,3}|Z{1,2}|W{1,2}|D{1,3}|[aAeEq]/g
  2556. function toDateString (date, format, options) {
  2557. if (date) {
  2558. date = toStringDate(date)
  2559. if (isValidDate(date)) {
  2560. var result = format || setupDefaults.formatString
  2561. var hours = date.getHours()
  2562. var apm = hours < 12 ? 'am' : 'pm'
  2563. var formats = assign({}, setupDefaults.formatStringMatchs, options ? options.formats : null)
  2564. var fy = function (match, length) {
  2565. return ('' + helperGetDateFullYear(date)).substr(4 - length)
  2566. }
  2567. var fM = function (match, length) {
  2568. return padStart(helperGetDateMonth(date) + 1, length, '0')
  2569. }
  2570. var fd = function (match, length) {
  2571. return padStart(date.getDate(), length, '0')
  2572. }
  2573. var fH = function (match, length) {
  2574. return padStart(hours, length, '0')
  2575. }
  2576. var fh = function (match, length) {
  2577. return padStart(hours <= 12 ? hours : hours - 12, length, '0')
  2578. }
  2579. var fm = function (match, length) {
  2580. return padStart(date.getMinutes(), length, '0')
  2581. }
  2582. var fs = function (match, length) {
  2583. return padStart(date.getSeconds(), length, '0')
  2584. }
  2585. var fS = function (match, length) {
  2586. return padStart(date.getMilliseconds(), length, '0')
  2587. }
  2588. var fZ = function (match, length) {
  2589. var zoneHours = date.getTimezoneOffset() / 60 * -1
  2590. return handleCustomTemplate(date, formats, match, (zoneHours >= 0 ? '+' : '-') + padStart(zoneHours, 2, '0') + (length === 1 ? ':' : '') + '00')
  2591. }
  2592. var fW = function (match, length) {
  2593. return padStart(handleCustomTemplate(date, formats, match, getYearWeek(date)), length, '0')
  2594. }
  2595. var fD = function (match, length) {
  2596. return padStart(handleCustomTemplate(date, formats, match, getYearDay(date)), length, '0')
  2597. }
  2598. var parseDates = {
  2599. yyyy: fy,
  2600. yy: fy,
  2601. MM: fM,
  2602. M: fM,
  2603. dd: fd,
  2604. d: fd,
  2605. HH: fH,
  2606. H: fH,
  2607. hh: fh,
  2608. h: fh,
  2609. mm: fm,
  2610. m: fm,
  2611. ss: fs,
  2612. s: fs,
  2613. SSS: fS,
  2614. S: fS,
  2615. ZZ: fZ,
  2616. Z: fZ,
  2617. WW: fW,
  2618. W: fW,
  2619. DDD: fD,
  2620. D: fD,
  2621. a: function (match) {
  2622. return handleCustomTemplate(date, formats, match, apm)
  2623. },
  2624. A: function (match) {
  2625. return handleCustomTemplate(date, formats, match, apm.toLocaleUpperCase())
  2626. },
  2627. e: function (match) {
  2628. return handleCustomTemplate(date, formats, match, date.getDay())
  2629. },
  2630. E: function (match) {
  2631. return handleCustomTemplate(date, formats, match, formatDayE(date.getDay()))
  2632. },
  2633. q: function (match) {
  2634. return handleCustomTemplate(date, formats, match, Math.floor((helperGetDateMonth(date) + 3) / 3))
  2635. }
  2636. }
  2637. return result.replace(dateFormatRE, function (match, skip) {
  2638. return skip || (parseDates[match] ? parseDates[match](match, match.length) : match)
  2639. })
  2640. }
  2641. return 'Invalid Date'
  2642. }
  2643. return ''
  2644. }
  2645. /**
  2646. * 返回前几年或后几年的日期
  2647. *
  2648. * @param {Date} date 日期或数字
  2649. * @param {Number} year 年(默认当前年)、前几个年(数值)、后几个年(数值)
  2650. * @param {Number/String} month 获取哪月(null默认当前年)、年初(first)、年末(last)、指定月份(0-11)
  2651. * @return {Date}
  2652. */
  2653. function getWhatYear (date, year, month) {
  2654. var number
  2655. date = toStringDate(date)
  2656. if (isValidDate(date)) {
  2657. if (year) {
  2658. number = year && !isNaN(year) ? year : 0
  2659. date.setFullYear(helperGetDateFullYear(date) + number)
  2660. }
  2661. if (month || !isNaN(month)) {
  2662. if (month === staticStrFirst) {
  2663. return new Date(helperGetDateFullYear(date), 0, 1)
  2664. } else if (month === staticStrLast) {
  2665. date.setMonth(11)
  2666. return getWhatMonth(date, 0, staticStrLast)
  2667. } else {
  2668. date.setMonth(month)
  2669. }
  2670. }
  2671. }
  2672. return date
  2673. }
  2674. /**
  2675. * 返回前几月或后几月的日期
  2676. *
  2677. * @param {Date} date 日期或数字
  2678. * @param {Number} month 月(默认当前月)、前几个月、后几个月
  2679. * @param {Number/String} day 获取哪天(null默认当前天)、月初(first)、月末(last)、指定天数(数值)
  2680. * @return {Date}
  2681. */
  2682. function getWhatMonth (date, month, day) {
  2683. var monthOffset = month && !isNaN(month) ? month : 0
  2684. date = toStringDate(date)
  2685. if (isValidDate(date)) {
  2686. if (day === staticStrFirst) {
  2687. return new Date(helperGetDateFullYear(date), helperGetDateMonth(date) + monthOffset, 1)
  2688. } else if (day === staticStrLast) {
  2689. return new Date(helperGetDateTime(getWhatMonth(date, monthOffset + 1, staticStrFirst)) - 1)
  2690. } else if (isNumber(day)) {
  2691. date.setDate(day)
  2692. }
  2693. if (monthOffset) {
  2694. date.setMonth(helperGetDateMonth(date) + monthOffset)
  2695. }
  2696. }
  2697. return date
  2698. }
  2699. /**
  2700. * 返回前几周或后几周的星期几
  2701. *
  2702. * @param {Date} date 日期
  2703. * @param {Number} week 周(默认当前周)、前几周、后几周
  2704. * @param {Number} day 星期天(默认0)、星期一(1)、星期二(2)、星期三(3)、星期四(4)、星期五(5)、星期六(6)
  2705. * @return {Date}
  2706. */
  2707. function getWhatWeek (date, week, day) {
  2708. var time, whatDayTime, currentDay, customDay
  2709. date = toStringDate(date)
  2710. if (isValidDate(date)) {
  2711. customDay = staticParseInt(/^[0-7]$/.test(day) ? day : date.getDay())
  2712. currentDay = date.getDay()
  2713. time = helperGetDateTime(date)
  2714. whatDayTime = time + ((customDay === 0 ? 7 : customDay) - (currentDay === 0 ? 7 : currentDay)) * staticDayTime
  2715. if (week && !isNaN(week)) {
  2716. whatDayTime += week * staticWeekTime
  2717. }
  2718. return new Date(whatDayTime)
  2719. }
  2720. return date
  2721. }
  2722. /**
  2723. * 返回前几天或后几天的日期
  2724. *
  2725. * @param {Date} date 日期或数字
  2726. * @param {Number} day 天(默认当天)、前几天、后几天
  2727. * @param {String} mode 获取时分秒(null默认当前时分秒)、日初(first)、日末(last)
  2728. * @return {Date}
  2729. */
  2730. function getWhatDay (date, day, mode) {
  2731. date = toStringDate(date)
  2732. if (isValidDate(date) && !isNaN(day)) {
  2733. date.setDate(date.getDate() + staticParseInt(day))
  2734. if (mode === staticStrFirst) {
  2735. return new Date(helperGetDateFullYear(date), helperGetDateMonth(date), date.getDate())
  2736. } else if (mode === staticStrLast) {
  2737. return new Date(helperGetDateTime(getWhatDay(date, 1, staticStrFirst)) - 1)
  2738. }
  2739. }
  2740. return date
  2741. }
  2742. /**
  2743. * 返回某个年份的第几天
  2744. *
  2745. * @param {Date} date 日期或数字
  2746. * @return {Number}
  2747. */
  2748. function getYearDay (date) {
  2749. date = toStringDate(date)
  2750. if (isValidDate(date)) {
  2751. return Math.floor((helperGetYMDTime(date) - helperGetYMDTime(getWhatYear(date, 0, staticStrFirst))) / staticDayTime) + 1
  2752. }
  2753. return NaN
  2754. }
  2755. /**
  2756. * 返回某个年份的第几周
  2757. *
  2758. * @param {Date} date 日期或数字
  2759. * @return {Number}
  2760. */
  2761. function getYearWeek (date) {
  2762. date = toStringDate(date)
  2763. if (isValidDate(date)) {
  2764. date.setHours(0, 0, 0, 0)
  2765. date.setDate(date.getDate() + 3 - (date.getDay() + 6) % 7)
  2766. var week = new Date(date.getFullYear(), 0, 4)
  2767. return Math.round(((date.getTime() - week.getTime()) / staticDayTime + (week.getDay() + 6) % 7 - 3) / 7) + 1
  2768. }
  2769. return NaN
  2770. }
  2771. /**
  2772. * 返回某个月的第几周
  2773. *
  2774. * @param {Date} date 日期或数字
  2775. * @return {Number}
  2776. */
  2777. function getMonthWeek (date) {
  2778. var monthFirst, monthFirstWeek
  2779. var currentDate = toStringDate(date)
  2780. if (isValidDate(currentDate)) {
  2781. monthFirst = getWhatMonth(currentDate, 0, staticStrFirst)
  2782. monthFirstWeek = getWhatWeek(monthFirst, 0, 1)
  2783. if (monthFirstWeek < monthFirst) {
  2784. monthFirstWeek = getWhatWeek(monthFirst, 1, 1)
  2785. }
  2786. if (currentDate >= monthFirstWeek) {
  2787. return Math.floor((helperGetYMDTime(currentDate) - helperGetYMDTime(monthFirstWeek)) / staticWeekTime) + 1
  2788. }
  2789. return getMonthWeek(getWhatWeek(currentDate, 0, 1))
  2790. }
  2791. return NaN
  2792. }
  2793. /**
  2794. * 返回某个年份的天数
  2795. *
  2796. * @param {Date} date 日期或数字
  2797. * @param {Number} year 年(默认当年)、前几个年、后几个年
  2798. * @return {Number}
  2799. */
  2800. function getDayOfYear (date, year) {
  2801. date = toStringDate(date)
  2802. if (isValidDate(date)) {
  2803. return isLeapYear(getWhatYear(date, year)) ? 366 : 365
  2804. }
  2805. return NaN
  2806. }
  2807. /**
  2808. * 返回某个月份的天数
  2809. *
  2810. * @param {Date} date 日期或数字
  2811. * @param {Number} month 月(默认当月)、前几个月、后几个月
  2812. * @return {Number}
  2813. */
  2814. function getDayOfMonth (date, month) {
  2815. date = toStringDate(date)
  2816. if (isValidDate(date)) {
  2817. return Math.floor((helperGetDateTime(getWhatMonth(date, month, staticStrLast)) - helperGetDateTime(getWhatMonth(date, month, staticStrFirst))) / staticDayTime) + 1
  2818. }
  2819. return NaN
  2820. }
  2821. /**
  2822. * 返回两个日期之间差距,如果结束日期小于开始日期done为fasle
  2823. *
  2824. * @param {Date} startDate 开始日期
  2825. * @param {Date} endDate 结束日期或当期日期
  2826. * @param {Date} rule 自定义计算规则
  2827. * @return {Object}
  2828. */
  2829. function getDateDiff (startDate, endDate, rules) {
  2830. var startTime, endTime, item, diffTime, rule, len, index
  2831. var result = { done: false, time: 0 }
  2832. startDate = toStringDate(startDate)
  2833. endDate = endDate ? toStringDate(endDate) : helperNewDate()
  2834. if (isValidDate(startDate) && isValidDate(endDate)) {
  2835. startTime = helperGetDateTime(startDate)
  2836. endTime = helperGetDateTime(endDate)
  2837. if (startTime < endTime) {
  2838. diffTime = result.time = endTime - startTime
  2839. rule = rules && rules.length > 0 ? rules : setupDefaults.dateDiffRules
  2840. result.done = true
  2841. for (index = 0, len = rule.length; index < len; index++) {
  2842. item = rule[index]
  2843. if (diffTime >= item[1]) {
  2844. if (index === len - 1) {
  2845. result[item[0]] = diffTime || 0
  2846. } else {
  2847. result[item[0]] = Math.floor(diffTime / item[1])
  2848. diffTime -= result[item[0]] * item[1]
  2849. }
  2850. } else {
  2851. result[item[0]] = 0
  2852. }
  2853. }
  2854. }
  2855. }
  2856. return result
  2857. }
  2858. function helperGetDateFullYear (date) {
  2859. return date.getFullYear()
  2860. }
  2861. function helperGetDateMonth (date) {
  2862. return date.getMonth()
  2863. }
  2864. function helperGetDateTime (date) {
  2865. return date.getTime()
  2866. }
  2867. function helperGetUTCDateTime (dates) {
  2868. return Date.UTC(dates[0], dates[1], dates[2], dates[3], dates[4], dates[5], dates[6])
  2869. }
  2870. function helperGetYMD (date) {
  2871. return new Date(helperGetDateFullYear(date), helperGetDateMonth(date), date.getDate())
  2872. }
  2873. function helperGetYMDTime (date) {
  2874. return helperGetDateTime(helperGetYMD(date))
  2875. }
  2876. function helperNewDate () {
  2877. return new Date()
  2878. }
  2879. /**
  2880. * 去除字符串左右两边的空格
  2881. *
  2882. * @param {String} str 字符串
  2883. * @return {String}
  2884. */
  2885. function trim (str) {
  2886. return str && str.trim ? str.trim() : trimRight(trimLeft(str))
  2887. }
  2888. /**
  2889. * 去除字符串左边的空格
  2890. *
  2891. * @param {String} str 字符串
  2892. * @return {String}
  2893. */
  2894. function trimLeft (str) {
  2895. return str && str.trimLeft ? str.trimLeft() : toValString(str).replace(/^[\s\uFEFF\xA0]+/g, '')
  2896. }
  2897. /**
  2898. * 去除字符串右边的空格
  2899. *
  2900. * @param {String} str 字符串
  2901. * @return {String}
  2902. */
  2903. function trimRight (str) {
  2904. return str && str.trimRight ? str.trimRight() : toValString(str).replace(/[\s\uFEFF\xA0]+$/g, '')
  2905. }
  2906. /**
  2907. * 转义HTML字符串,替换&, <, >, ", ', `字符
  2908. *
  2909. * @param {String} str 字符串
  2910. * @return {String}
  2911. */
  2912. var escape = helperFormatEscaper(staticEscapeMap)
  2913. var unescapeMap = {}
  2914. each(staticEscapeMap, function (item, key) {
  2915. unescapeMap[staticEscapeMap[key]] = key
  2916. })
  2917. /**
  2918. * 反转escape
  2919. *
  2920. * @param {String} str 字符串
  2921. * @return {String}
  2922. */
  2923. var unescape = helperFormatEscaper(unescapeMap)
  2924. var camelCacheMaps = {}
  2925. /**
  2926. * 将带字符串转成驼峰字符串,例如: project-name 转为 projectName
  2927. *
  2928. * @param {String} str 字符串
  2929. * @return {String}
  2930. */
  2931. function camelCase (str) {
  2932. str = toValString(str)
  2933. if (camelCacheMaps[str]) {
  2934. return camelCacheMaps[str]
  2935. }
  2936. var strLen = str.length
  2937. var rest = str.replace(/([-]+)/g, function (text, flag, index) {
  2938. return index && index + flag.length < strLen ? '-' : ''
  2939. })
  2940. strLen = rest.length
  2941. rest = rest.replace(/([A-Z]+)/g, function (text, upper, index) {
  2942. var upperLen = upper.length
  2943. upper = helperStringLowerCase(upper)
  2944. if (index) {
  2945. if (upperLen > 2 && index + upperLen < strLen) {
  2946. return helperStringUpperCase(helperStringSubstring(upper, 0, 1)) + helperStringSubstring(upper, 1, upperLen - 1) + helperStringUpperCase(helperStringSubstring(upper, upperLen - 1, upperLen))
  2947. }
  2948. return helperStringUpperCase(helperStringSubstring(upper, 0, 1)) + helperStringSubstring(upper, 1, upperLen)
  2949. } else {
  2950. if (upperLen > 1 && index + upperLen < strLen) {
  2951. return helperStringSubstring(upper, 0, upperLen - 1) + helperStringUpperCase(helperStringSubstring(upper, upperLen - 1, upperLen))
  2952. }
  2953. }
  2954. return upper
  2955. }).replace(/(-[a-zA-Z])/g, function (text, upper) {
  2956. return helperStringUpperCase(helperStringSubstring(upper, 1, upper.length))
  2957. })
  2958. camelCacheMaps[str] = rest
  2959. return rest
  2960. }
  2961. var kebabCacheMaps = {}
  2962. /**
  2963. * 将带驼峰字符串转成字符串,例如: projectName 转为 project-name
  2964. *
  2965. * @param {String} str 字符串
  2966. * @return {String}
  2967. */
  2968. function kebabCase (str) {
  2969. str = toValString(str)
  2970. if (kebabCacheMaps[str]) {
  2971. return kebabCacheMaps[str]
  2972. }
  2973. var rest = str.replace(/([a-z]?)([A-Z]+)([a-z]?)/g, function (text, prevLower, upper, nextLower, index) {
  2974. var upperLen = upper.length
  2975. if (upperLen > 1) {
  2976. if (prevLower) {
  2977. prevLower += '-'
  2978. }
  2979. if (nextLower) {
  2980. return (prevLower || '') + helperStringLowerCase(helperStringSubstring(upper, 0, upperLen - 1)) + '-' + helperStringLowerCase(helperStringSubstring(upper, upperLen - 1, upperLen)) + nextLower
  2981. }
  2982. }
  2983. return (prevLower || '') + (index ? '-' : '') + helperStringLowerCase(upper) + (nextLower || '')
  2984. })
  2985. rest = rest.replace(/([-]+)/g, function (text, flag, index) {
  2986. return index && index + flag.length < rest.length ? '-' : ''
  2987. })
  2988. kebabCacheMaps[str] = rest
  2989. return rest
  2990. }
  2991. /**
  2992. * 将字符串重复 n 次
  2993. *
  2994. * @param {String} str 字符串
  2995. * @param {Number} count 次数
  2996. * @return {String}
  2997. */
  2998. function repeat (str, count) {
  2999. return helperStringRepeat(toValString(str), count)
  3000. }
  3001. /**
  3002. * 用指定字符从前面开始补全字符串
  3003. *
  3004. * @param {String} str 字符串
  3005. * @param {Number} targetLength 结果长度
  3006. * @param {Number} padString 补全字符
  3007. * @return {String}
  3008. */
  3009. function padStart (str, targetLength, padString) {
  3010. var rest = toValString(str)
  3011. targetLength = targetLength >> 0
  3012. padString = isUndefined(padString) ? ' ' : '' + padString
  3013. if (rest.padStart) {
  3014. return rest.padStart(targetLength, padString)
  3015. }
  3016. if (targetLength > rest.length) {
  3017. targetLength -= rest.length
  3018. if (targetLength > padString.length) {
  3019. padString += helperStringRepeat(padString, targetLength / padString.length)
  3020. }
  3021. return padString.slice(0, targetLength) + rest
  3022. }
  3023. return rest
  3024. }
  3025. /**
  3026. * 用指定字符从后面开始补全字符串
  3027. *
  3028. * @param {String} str 字符串
  3029. * @param {Number} targetLength 结果长度
  3030. * @param {Number} padString 补全字符
  3031. * @return {String}
  3032. */
  3033. function padEnd (str, targetLength, padString) {
  3034. var rest = toValString(str)
  3035. targetLength = targetLength >> 0
  3036. padString = isUndefined(padString) ? ' ' : '' + padString
  3037. if (rest.padEnd) {
  3038. return rest.padEnd(targetLength, padString)
  3039. }
  3040. if (targetLength > rest.length) {
  3041. targetLength -= rest.length
  3042. if (targetLength > padString.length) {
  3043. padString += helperStringRepeat(padString, targetLength / padString.length)
  3044. }
  3045. return rest + padString.slice(0, targetLength)
  3046. }
  3047. return rest
  3048. }
  3049. /**
  3050. * 判断字符串是否在源字符串的头部
  3051. *
  3052. * @param {String} str 字符串
  3053. * @param {String/Number} val 值
  3054. * @param {Number} startIndex 开始索引
  3055. * @return {String}
  3056. */
  3057. function startsWith (str, val, startIndex) {
  3058. var rest = toValString(str)
  3059. return (arguments.length === 1 ? rest : rest.substring(startIndex)).indexOf(val) === 0
  3060. }
  3061. /**
  3062. * 判断字符串是否在源字符串的尾部
  3063. *
  3064. * @param {String} str 字符串
  3065. * @param {String/Number} val 值
  3066. * @param {Number} startIndex 开始索引
  3067. * @return {String}
  3068. */
  3069. function endsWith (str, val, startIndex) {
  3070. var rest = toValString(str)
  3071. var argsLen = arguments.length
  3072. return argsLen > 1 && (argsLen > 2 ? rest.substring(0, startIndex).indexOf(val) === startIndex - 1 : rest.indexOf(val) === rest.length - 1)
  3073. }
  3074. /**
  3075. * 解析动态字符串模板
  3076. * @param {atring} str 字符串模板
  3077. * @param {any | any[]} args 对象
  3078. * @param {any} options
  3079. */
  3080. function template (str, args, options) {
  3081. return toValString(str).replace((options || setupDefaults).tmplRE || /\{{2}([.\w[\]\s]+)\}{2}/g, function (match, key) {
  3082. return get(args, trim(key))
  3083. })
  3084. }
  3085. /**
  3086. * 字符串格式化占位符
  3087. * @param { string } str
  3088. * @param { object | any[] } obj
  3089. */
  3090. function toFormatString (str, obj) {
  3091. return template(str, obj, { tmplRE: /\{([.\w[\]\s]+)\}/g })
  3092. }
  3093. function toValString (obj) {
  3094. if (isNumber(obj)) {
  3095. return toNumberString(obj)
  3096. }
  3097. return '' + (eqNull(obj) ? '' : obj)
  3098. }
  3099. function helperFormatEscaper (dataMap) {
  3100. var replaceRegexp = new RegExp('(?:' + keys(dataMap).join('|') + ')', 'g')
  3101. return function (str) {
  3102. return toValString(str).replace(replaceRegexp, function (match) {
  3103. return dataMap[match]
  3104. })
  3105. }
  3106. }
  3107. function helperStringLowerCase (str) {
  3108. return str.toLowerCase()
  3109. }
  3110. function helperStringRepeat (str, count) {
  3111. if (str.repeat) {
  3112. return str.repeat(count)
  3113. }
  3114. var list = isNaN(count) ? [] : new Array(staticParseInt(count))
  3115. return list.join(str) + (list.length > 0 ? str : '')
  3116. }
  3117. function helperStringSubstring (str, start, end) {
  3118. return str.substring(start, end)
  3119. }
  3120. function helperStringUpperCase (str) {
  3121. return str.toUpperCase()
  3122. }
  3123. /**
  3124. * 一个空的方法,始终返回 undefined,可用于初始化值
  3125. */
  3126. function noop () {}
  3127. /**
  3128. * 返回一个获取对象属性的函数
  3129. *
  3130. * @param {String} name 属性名
  3131. * @param {Object} defs 空值
  3132. */
  3133. function property (name, defs) {
  3134. return function (obj) {
  3135. return isNull(obj) ? defs : obj[name]
  3136. }
  3137. }
  3138. /**
  3139. * 创建一个绑定上下文的函数
  3140. *
  3141. * @param {Function} callback 函数
  3142. * @param {Object} context 上下文
  3143. * @param {*} args 额外的参数
  3144. * @return {Object}
  3145. */
  3146. function bind (callback, context) {
  3147. var args = slice(arguments, 2)
  3148. return function () {
  3149. return callback.apply(context, slice(arguments).concat(args))
  3150. }
  3151. }
  3152. /**
  3153. * 创建一个只能调用一次的函数,只会返回第一次执行后的结果
  3154. *
  3155. * @param {Function} callback 函数
  3156. * @param {Object} context 上下文
  3157. * @param {*} args 额外的参数
  3158. * @return {Object}
  3159. */
  3160. function once (callback, context) {
  3161. var done = false
  3162. var rest = null
  3163. var args = slice(arguments, 2)
  3164. return function () {
  3165. if (done) {
  3166. return rest
  3167. }
  3168. rest = callback.apply(context, slice(arguments).concat(args))
  3169. done = true
  3170. return rest
  3171. }
  3172. }
  3173. /**
  3174. * 创建一个函数, 调用次数超过 count 次之后执行回调并将所有结果记住后返回
  3175. *
  3176. * @param {Number} count 调用次数
  3177. * @param {Function} callback 完成回调
  3178. * @return {Object}
  3179. */
  3180. function after (count, callback, context) {
  3181. var runCount = 0
  3182. var rests = []
  3183. return function () {
  3184. var args = arguments
  3185. runCount++
  3186. if (runCount <= count) {
  3187. rests.push(args[0])
  3188. }
  3189. if (runCount >= count) {
  3190. callback.apply(context, [rests].concat(slice(args)))
  3191. }
  3192. }
  3193. }
  3194. /**
  3195. * 创建一个函数, 调用次数不超过 count 次之前执行回调并将所有结果记住后返回
  3196. *
  3197. * @param {Number} count 调用次数
  3198. * @param {Function} callback 完成回调
  3199. * @return {Object}
  3200. */
  3201. function before (count, callback, context) {
  3202. var runCount = 0
  3203. var rests = []
  3204. context = context || this
  3205. return function () {
  3206. var args = arguments
  3207. runCount++
  3208. if (runCount < count) {
  3209. rests.push(args[0])
  3210. callback.apply(context, [rests].concat(slice(args)))
  3211. }
  3212. }
  3213. }
  3214. /**
  3215. * 节流函数;当被调用 n 毫秒后才会执行,如果在这时间内又被调用则至少每隔 n 秒毫秒调用一次该函数
  3216. *
  3217. * @param {Function} callback 回调
  3218. * @param {Number} wait 多少秒毫
  3219. * @param {Object} options 参数{leading: 是否在之前执行, trailing: 是否在之后执行}
  3220. * @return {Function}
  3221. */
  3222. function throttle (callback, wait, options) {
  3223. var args, context
  3224. var opts = options || {}
  3225. var runFlag = false
  3226. var timeout = 0
  3227. var optLeading = 'leading' in opts ? opts.leading : true
  3228. var optTrailing = 'trailing' in opts ? opts.trailing : false
  3229. var runFn = function () {
  3230. runFlag = true
  3231. callback.apply(context, args)
  3232. timeout = setTimeout(endFn, wait)
  3233. }
  3234. var endFn = function () {
  3235. timeout = 0
  3236. if (!runFlag && optTrailing === true) {
  3237. runFn()
  3238. }
  3239. }
  3240. var cancelFn = function () {
  3241. var rest = timeout !== 0
  3242. clearTimeout(timeout)
  3243. runFlag = false
  3244. timeout = 0
  3245. return rest
  3246. }
  3247. var throttled = function () {
  3248. args = arguments
  3249. context = this
  3250. runFlag = false
  3251. if (timeout === 0) {
  3252. if (optLeading === true) {
  3253. runFn()
  3254. } else if (optTrailing === true) {
  3255. timeout = setTimeout(endFn, wait)
  3256. }
  3257. }
  3258. }
  3259. throttled.cancel = cancelFn
  3260. return throttled
  3261. }
  3262. /**
  3263. * 函数去抖;当被调用 n 毫秒后才会执行,如果在这时间内又被调用则将重新计算执行时间
  3264. *
  3265. * @param {Function} callback 回调
  3266. * @param {Number} wait 多少秒毫
  3267. * @param {Object} options 参数{leading: 是否在之前执行, trailing: 是否在之后执行}
  3268. * @return {Function}
  3269. */
  3270. function debounce (callback, wait, options) {
  3271. var args, context
  3272. var opts = options || {}
  3273. var runFlag = false
  3274. var timeout = 0
  3275. var isLeading = typeof options === 'boolean'
  3276. var optLeading = 'leading' in opts ? opts.leading : isLeading
  3277. var optTrailing = 'trailing' in opts ? opts.trailing : !isLeading
  3278. var runFn = function () {
  3279. runFlag = true
  3280. timeout = 0
  3281. callback.apply(context, args)
  3282. }
  3283. var endFn = function () {
  3284. if (optLeading === true) {
  3285. timeout = 0
  3286. }
  3287. if (!runFlag && optTrailing === true) {
  3288. runFn()
  3289. }
  3290. }
  3291. var cancelFn = function () {
  3292. var rest = timeout !== 0
  3293. clearTimeout(timeout)
  3294. timeout = 0
  3295. return rest
  3296. }
  3297. var debounced = function () {
  3298. runFlag = false
  3299. args = arguments
  3300. context = this
  3301. if (timeout === 0) {
  3302. if (optLeading === true) {
  3303. runFn()
  3304. }
  3305. } else {
  3306. clearTimeout(timeout)
  3307. }
  3308. timeout = setTimeout(endFn, wait)
  3309. }
  3310. debounced.cancel = cancelFn
  3311. return debounced
  3312. }
  3313. /**
  3314. * 该方法和 setTimeout 一样的效果,区别就是支持上下文和额外参数
  3315. *
  3316. * @param {Function} callback 函数
  3317. * @param {Number} wait 延迟毫秒
  3318. * @param {*} args 额外的参数
  3319. * @return {Number}
  3320. */
  3321. function delay (callback, wait) {
  3322. var args = slice(arguments, 2)
  3323. var context = this
  3324. return setTimeout(function () {
  3325. callback.apply(context, args)
  3326. }, wait)
  3327. }
  3328. function parseURLQuery (uri) {
  3329. return unserialize(uri.split('?')[1] || '')
  3330. }
  3331. function parseUrl (url) {
  3332. var hashs, portText, searchs, parsed
  3333. var href = '' + url
  3334. if (href.indexOf('//') === 0) {
  3335. href = (staticLocation ? staticLocation.protocol : '') + href
  3336. } else if (href.indexOf('/') === 0) {
  3337. href = helperGetLocatOrigin() + href
  3338. }
  3339. searchs = href.replace(/#.*/, '').match(/(\?.*)/)
  3340. parsed = {
  3341. href: href,
  3342. hash: '',
  3343. host: '',
  3344. hostname: '',
  3345. protocol: '',
  3346. port: '',
  3347. search: searchs && searchs[1] && searchs[1].length > 1 ? searchs[1] : ''
  3348. }
  3349. parsed.path = href.replace(/^([a-z0-9.+-]*:)\/\//, function (text, protocol) {
  3350. parsed.protocol = protocol
  3351. return ''
  3352. }).replace(/^([a-z0-9.+-]*)(:\d+)?\/?/, function (text, hostname, port) {
  3353. portText = port || ''
  3354. parsed.port = portText.replace(':', '')
  3355. parsed.hostname = hostname
  3356. parsed.host = hostname + portText
  3357. return '/'
  3358. }).replace(/(#.*)/, function (text, hash) {
  3359. parsed.hash = hash.length > 1 ? hash : ''
  3360. return ''
  3361. })
  3362. hashs = parsed.hash.match(/#((.*)\?|(.*))/)
  3363. parsed.pathname = parsed.path.replace(/(\?|#.*).*/, '')
  3364. parsed.origin = parsed.protocol + '//' + parsed.host
  3365. parsed.hashKey = hashs ? (hashs[2] || hashs[1] || '') : ''
  3366. parsed.hashQuery = parseURLQuery(parsed.hash)
  3367. parsed.searchQuery = parseURLQuery(parsed.search)
  3368. return parsed
  3369. }
  3370. function stringifyParams (resultVal, resultKey, isArr) {
  3371. var _arr
  3372. var result = []
  3373. each(resultVal, function (item, key) {
  3374. _arr = isArray(item)
  3375. if (isPlainObject(item) || _arr) {
  3376. result = result.concat(stringifyParams(item, resultKey + '[' + key + ']', _arr))
  3377. } else {
  3378. result.push(staticEncodeURIComponent(resultKey + '[' + (isArr ? '' : key) + ']') + '=' + staticEncodeURIComponent(isNull(item) ? '' : item))
  3379. }
  3380. })
  3381. return result
  3382. }
  3383. /**
  3384. * 序列化查询参数
  3385. *
  3386. * @param {Object} query 查询参数
  3387. */
  3388. function serialize (query) {
  3389. var _arr
  3390. var params = []
  3391. each(query, function (item, key) {
  3392. if (!isUndefined(item)) {
  3393. _arr = isArray(item)
  3394. if (isPlainObject(item) || _arr) {
  3395. params = params.concat(stringifyParams(item, key, _arr))
  3396. } else {
  3397. params.push(staticEncodeURIComponent(key) + '=' + staticEncodeURIComponent(isNull(item) ? '' : item))
  3398. }
  3399. }
  3400. })
  3401. return params.join('&').replace(/%20/g, '+')
  3402. }
  3403. /**
  3404. * 反序列化查询参数
  3405. *
  3406. * @param {String} query 字符串
  3407. */
  3408. function unserialize (str) {
  3409. var items
  3410. var result = {}
  3411. if (str && isString(str)) {
  3412. arrayEach(str.split('&'), function (param) {
  3413. items = param.split('=')
  3414. result[staticDecodeURIComponent(items[0])] = staticDecodeURIComponent(items[1] || '')
  3415. })
  3416. }
  3417. return result
  3418. }
  3419. function getBaseURL () {
  3420. if (staticLocation) {
  3421. var pathname = staticLocation.pathname
  3422. var lastIndex = lastIndexOf(pathname, '/') + 1
  3423. return helperGetLocatOrigin() + (lastIndex === pathname.length ? pathname : pathname.substring(0, lastIndex))
  3424. }
  3425. return ''
  3426. }
  3427. /**
  3428. * 获取地址栏信息
  3429. *
  3430. * @return Object
  3431. */
  3432. function locat () {
  3433. return staticLocation ? parseUrl(staticLocation.href) : {}
  3434. }
  3435. /* eslint-disable valid-typeof */
  3436. function isBrowseStorage (storage) {
  3437. try {
  3438. var testKey = '__xe_t'
  3439. storage.setItem(testKey, 1)
  3440. storage.removeItem(testKey)
  3441. return true
  3442. } catch (e) {
  3443. return false
  3444. }
  3445. }
  3446. function isBrowseType (type) {
  3447. return navigator.userAgent.indexOf(type) > -1
  3448. }
  3449. /**
  3450. * 获取浏览器内核
  3451. * @return Object
  3452. */
  3453. function browse () {
  3454. var $body, isChrome, isEdge
  3455. var isMobile = false
  3456. var result = {
  3457. isNode: false,
  3458. isMobile: isMobile,
  3459. isPC: false,
  3460. isDoc: !!staticDocument
  3461. }
  3462. if (!staticWindow && typeof process !== staticStrUndefined) {
  3463. result.isNode = true
  3464. } else {
  3465. isEdge = isBrowseType('Edge')
  3466. isChrome = isBrowseType('Chrome')
  3467. isMobile = /(Android|webOS|iPhone|iPad|iPod|SymbianOS|BlackBerry|Windows Phone)/.test(navigator.userAgent)
  3468. if (result.isDoc) {
  3469. $body = staticDocument.body || staticDocument.documentElement
  3470. arrayEach(['webkit', 'khtml', 'moz', 'ms', 'o'], function (core) {
  3471. result['-' + core] = !!$body[core + 'MatchesSelector']
  3472. })
  3473. }
  3474. assign(result, {
  3475. edge: isEdge,
  3476. firefox: isBrowseType('Firefox'),
  3477. msie: !isEdge && result['-ms'],
  3478. safari: !isChrome && !isEdge && isBrowseType('Safari'),
  3479. isMobile: isMobile,
  3480. isPC: !isMobile,
  3481. isLocalStorage: isBrowseStorage(staticWindow.localStorage),
  3482. isSessionStorage: isBrowseStorage(staticWindow.sessionStorage)
  3483. })
  3484. }
  3485. return result
  3486. }
  3487. function toCookieUnitTime (unit, expires) {
  3488. var num = parseFloat(expires)
  3489. var nowdate = helperNewDate()
  3490. var time = helperGetDateTime(nowdate)
  3491. switch (unit) {
  3492. case 'y': return helperGetDateTime(getWhatYear(nowdate, num))
  3493. case 'M': return helperGetDateTime(getWhatMonth(nowdate, num))
  3494. case 'd': return helperGetDateTime(getWhatDay(nowdate, num))
  3495. case 'h':
  3496. case 'H': return time + num * 60 * 60 * 1000
  3497. case 'm': return time + num * 60 * 1000
  3498. case 's': return time + num * 1000
  3499. }
  3500. return time
  3501. }
  3502. function toCookieUTCString (date) {
  3503. return (isDate(date) ? date : new Date(date)).toUTCString()
  3504. }
  3505. /**
  3506. * cookie操作函数
  3507. * @param {String/Array/Object} name 键/数组/对象
  3508. * @param {String} value 值
  3509. * @param {Object} options 参数
  3510. * @param {String} name: 键
  3511. * @param {Object} value: 值
  3512. * @param {String} path: 路径
  3513. * @param {String} domain: 作用域
  3514. * @param {Boolean} secure: 设置为安全的,只能用https协议
  3515. * @param {Number} expires: 过期时间,可以指定日期或者字符串,默认天
  3516. */
  3517. function cookie (name, value, options) {
  3518. if (staticDocument) {
  3519. var opts, expires, values, result, cookies, keyIndex
  3520. var inserts = []
  3521. var args = arguments
  3522. if (isArray(name)) {
  3523. inserts = name
  3524. } else if (args.length > 1) {
  3525. inserts = [assign({ name: name, value: value }, options)]
  3526. } else if (isObject(name)) {
  3527. inserts = [name]
  3528. }
  3529. if (inserts.length > 0) {
  3530. arrayEach(inserts, function (obj) {
  3531. opts = assign({}, setupDefaults.cookies, obj)
  3532. values = []
  3533. if (opts.name) {
  3534. expires = opts.expires
  3535. values.push(staticEncodeURIComponent(opts.name) + '=' + staticEncodeURIComponent(isObject(opts.value) ? JSON.stringify(opts.value) : opts.value))
  3536. if (expires) {
  3537. if (isNaN(expires)) {
  3538. // UTCString || Unit
  3539. expires = expires.replace(/^([0-9]+)(y|M|d|H|h|m|s)$/, function (text, num, unit) {
  3540. return toCookieUTCString(toCookieUnitTime(unit, num))
  3541. })
  3542. } else if (/^[0-9]{11,13}$/.test(expires) || isDate(expires)) {
  3543. // Date || now
  3544. expires = toCookieUTCString(expires)
  3545. } else {
  3546. // day
  3547. expires = toCookieUTCString(toCookieUnitTime('d', expires))
  3548. }
  3549. opts.expires = expires
  3550. }
  3551. arrayEach(['expires', 'path', 'domain', 'secure'], function (key) {
  3552. if (!isUndefined(opts[key])) {
  3553. values.push(opts[key] && key === 'secure' ? key : (key + '=' + opts[key]))
  3554. }
  3555. })
  3556. }
  3557. staticDocument.cookie = values.join('; ')
  3558. })
  3559. return true
  3560. } else {
  3561. result = {}
  3562. cookies = staticDocument.cookie
  3563. if (cookies) {
  3564. arrayEach(cookies.split('; '), function (val) {
  3565. keyIndex = val.indexOf('=')
  3566. result[staticDecodeURIComponent(val.substring(0, keyIndex))] = staticDecodeURIComponent(val.substring(keyIndex + 1) || '')
  3567. })
  3568. }
  3569. return args.length === 1 ? result[name] : result
  3570. }
  3571. }
  3572. return false
  3573. }
  3574. function hasCookieItem (key) {
  3575. return includes(cookieKeys(), key)
  3576. }
  3577. function getCookieItem (name, key) {
  3578. return cookie(name, key)
  3579. }
  3580. function setCookieItem (name, key, options) {
  3581. cookie(name, key, options)
  3582. return cookie
  3583. }
  3584. function removeCookieItem (name, options) {
  3585. cookie(name, 0, assign({ expires: -1 }, setupDefaults.cookies, options))
  3586. }
  3587. function cookieKeys () {
  3588. return keys(cookie())
  3589. }
  3590. assign(cookie, {
  3591. _c: false,
  3592. isKey: hasCookieItem,
  3593. has: hasCookieItem,
  3594. set: setCookieItem,
  3595. setItem: setCookieItem,
  3596. get: getCookieItem,
  3597. getItem: cookie,
  3598. remove: removeCookieItem,
  3599. removeItem: removeCookieItem,
  3600. keys: cookieKeys,
  3601. getJSON: cookie
  3602. })
  3603. function helperGetLocatOrigin () {
  3604. return staticLocation ? (staticLocation.origin || (staticLocation.protocol + '//' + staticLocation.host)) : ''
  3605. }
  3606. // 核心
  3607. // 对象相关的方法
  3608. // 数组相关的方法
  3609. // 基础方法
  3610. // 数值相关方法
  3611. // 日期相关的方法
  3612. // 字符串相关的方法
  3613. // 函数相关的方法
  3614. // 地址相关的方法
  3615. // 浏览器相关的方法
  3616. assign(XEUtils, {
  3617. // object
  3618. assign: assign,
  3619. extend: extend,
  3620. objectEach: objectEach,
  3621. lastObjectEach: lastObjectEach,
  3622. objectMap: objectMap,
  3623. merge: merge,
  3624. // array
  3625. uniq: uniq,
  3626. union: union,
  3627. sortBy: sortBy,
  3628. orderBy: orderBy,
  3629. shuffle: shuffle,
  3630. sample: sample,
  3631. some: some,
  3632. every: every,
  3633. slice: slice,
  3634. filter: filter,
  3635. find: find,
  3636. findLast: findLast,
  3637. findKey: findKey,
  3638. includes: includes,
  3639. arrayIndexOf: arrayIndexOf,
  3640. arrayLastIndexOf: arrayLastIndexOf,
  3641. map: map,
  3642. reduce: reduce,
  3643. copyWithin: copyWithin,
  3644. chunk: chunk,
  3645. zip: zip,
  3646. unzip: unzip,
  3647. zipObject: zipObject,
  3648. flatten: flatten,
  3649. toArray: toArray,
  3650. includeArrays: includeArrays,
  3651. pluck: pluck,
  3652. invoke: invoke,
  3653. invokeMap: invokeMap,
  3654. arrayEach: arrayEach,
  3655. lastArrayEach: lastArrayEach,
  3656. toArrayTree: toArrayTree,
  3657. toTreeArray: toTreeArray,
  3658. findTree: findTree,
  3659. eachTree: eachTree,
  3660. mapTree: mapTree,
  3661. filterTree: filterTree,
  3662. searchTree: searchTree,
  3663. // base
  3664. hasOwnProp: hasOwnProp,
  3665. eqNull: eqNull,
  3666. isNaN: isNumberNaN,
  3667. isFinite: isNumberFinite,
  3668. isUndefined: isUndefined,
  3669. isArray: isArray,
  3670. isFloat: isFloat,
  3671. isInteger: isInteger,
  3672. isFunction: isFunction,
  3673. isBoolean: isBoolean,
  3674. isString: isString,
  3675. isNumber: isNumber,
  3676. isRegExp: isRegExp,
  3677. isObject: isObject,
  3678. isPlainObject: isPlainObject,
  3679. isDate: isDate,
  3680. isError: isError,
  3681. isTypeError: isTypeError,
  3682. isEmpty: isEmpty,
  3683. isNull: isNull,
  3684. isSymbol: isSymbol,
  3685. isArguments: isArguments,
  3686. isElement: isElement,
  3687. isDocument: isDocument,
  3688. isWindow: isWindow,
  3689. isFormData: isFormData,
  3690. isMap: isMap,
  3691. isWeakMap: isWeakMap,
  3692. isSet: isSet,
  3693. isWeakSet: isWeakSet,
  3694. isLeapYear: isLeapYear,
  3695. isMatch: isMatch,
  3696. isEqual: isEqual,
  3697. isEqualWith: isEqualWith,
  3698. getType: getType,
  3699. uniqueId: uniqueId,
  3700. getSize: getSize,
  3701. indexOf: indexOf,
  3702. lastIndexOf: lastIndexOf,
  3703. findIndexOf: findIndexOf,
  3704. findLastIndexOf: findLastIndexOf,
  3705. toStringJSON: toStringJSON,
  3706. toJSONString: toJSONString,
  3707. keys: keys,
  3708. values: values,
  3709. entries: entries,
  3710. pick: pick,
  3711. omit: omit,
  3712. first: first,
  3713. last: last,
  3714. each: each,
  3715. forOf: forOf,
  3716. lastForOf: lastForOf,
  3717. lastEach: lastEach,
  3718. has: has,
  3719. get: get,
  3720. set: set,
  3721. groupBy: groupBy,
  3722. countBy: countBy,
  3723. clone: clone,
  3724. clear: clear,
  3725. remove: remove,
  3726. range: range,
  3727. destructuring: destructuring,
  3728. // number
  3729. random: random,
  3730. min: min,
  3731. max: max,
  3732. commafy: commafy,
  3733. round: round,
  3734. ceil: ceil,
  3735. floor: floor,
  3736. toFixed: toFixed,
  3737. toFixedString: toFixedString,
  3738. toFixedNumber: toFixedNumber,
  3739. toNumber: toNumber,
  3740. toNumberString: toNumberString,
  3741. toInteger: toInteger,
  3742. add: add,
  3743. subtract: subtract,
  3744. multiply: multiply,
  3745. divide: divide,
  3746. sum: sum,
  3747. mean: mean,
  3748. // date
  3749. now: now,
  3750. timestamp: timestamp,
  3751. isValidDate: isValidDate,
  3752. isDateSame: isDateSame,
  3753. toStringDate: toStringDate,
  3754. toDateString: toDateString,
  3755. getWhatYear: getWhatYear,
  3756. getWhatMonth: getWhatMonth,
  3757. getWhatWeek: getWhatWeek,
  3758. getWhatDay: getWhatDay,
  3759. getYearDay: getYearDay,
  3760. getYearWeek: getYearWeek,
  3761. getMonthWeek: getMonthWeek,
  3762. getDayOfYear: getDayOfYear,
  3763. getDayOfMonth: getDayOfMonth,
  3764. getDateDiff: getDateDiff,
  3765. // string
  3766. trim: trim,
  3767. trimLeft: trimLeft,
  3768. trimRight: trimRight,
  3769. escape: escape,
  3770. unescape: unescape,
  3771. camelCase: camelCase,
  3772. kebabCase: kebabCase,
  3773. repeat: repeat,
  3774. padStart: padStart,
  3775. padEnd: padEnd,
  3776. startsWith: startsWith,
  3777. endsWith: endsWith,
  3778. template: template,
  3779. toFormatString: toFormatString,
  3780. toString: toValString,
  3781. // function
  3782. noop: noop,
  3783. property: property,
  3784. bind: bind,
  3785. once: once,
  3786. after: after,
  3787. before: before,
  3788. throttle: throttle,
  3789. debounce: debounce,
  3790. delay: delay,
  3791. // url
  3792. unserialize: unserialize,
  3793. serialize: serialize,
  3794. parseUrl: parseUrl,
  3795. // web
  3796. getBaseURL: getBaseURL,
  3797. locat: locat,
  3798. browse: browse,
  3799. cookie: cookie
  3800. })
  3801. return XEUtils
  3802. }))