wsemi 1.9.21 → 1.9.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (524) hide show
  1. package/README.md +1 -1
  2. package/dist/wsemi.umd.js +6 -6
  3. package/dist/wsemi.umd.js.map +1 -1
  4. package/docs/-_class.mjs.html +1 -1
  5. package/docs/-_const.mjs.html +1 -1
  6. package/docs/-_detector.mjs.html +1 -1
  7. package/docs/-_errToStr.mjs.html +1 -1
  8. package/docs/-_execThrownMsg.mjs.html +1 -1
  9. package/docs/-_isRealError.mjs.html +1 -1
  10. package/docs/-_optNum.mjs.html +1 -1
  11. package/docs/-_pmMarkHandled.mjs.html +1 -1
  12. package/docs/-_pmReadItems.mjs.html +1 -1
  13. package/docs/-_pmSettleByState.mjs.html +1 -1
  14. package/docs/-_realErrorToStr.mjs.html +1 -1
  15. package/docs/-_toResultError.mjs.html +1 -1
  16. package/docs/ab2blob.mjs.html +1 -1
  17. package/docs/ab2u8arr.mjs.html +1 -1
  18. package/docs/addExcelWorksheetFromData.mjs.html +1 -1
  19. package/docs/addMonth.mjs.html +1 -1
  20. package/docs/aes2str.mjs.html +1 -1
  21. package/docs/alive.mjs.html +1 -1
  22. package/docs/arr2dt.mjs.html +1 -1
  23. package/docs/arrAccum.mjs.html +1 -1
  24. package/docs/arrAdd.mjs.html +1 -1
  25. package/docs/arrAt.mjs.html +1 -1
  26. package/docs/arrDiff.mjs.html +1 -1
  27. package/docs/arrFilterByKeywords.mjs.html +1 -1
  28. package/docs/arrFilterByNum.mjs.html +1 -1
  29. package/docs/arrFilterByPnum.mjs.html +1 -1
  30. package/docs/arrFilterByPnumAndToLog.mjs.html +1 -1
  31. package/docs/arrFind.mjs.html +1 -1
  32. package/docs/arrGroupByMaxmin.mjs.html +1 -1
  33. package/docs/arrHas.mjs.html +1 -1
  34. package/docs/arrInsert.mjs.html +1 -1
  35. package/docs/arrLookupByMaxmin.mjs.html +1 -1
  36. package/docs/arrMax.mjs.html +1 -1
  37. package/docs/arrMin.mjs.html +1 -1
  38. package/docs/arrMulti.mjs.html +1 -1
  39. package/docs/arrNorm.mjs.html +1 -1
  40. package/docs/arrProduct.mjs.html +1 -1
  41. package/docs/arrPull.mjs.html +1 -1
  42. package/docs/arrPullAt.mjs.html +1 -1
  43. package/docs/arrReduce.mjs.html +1 -1
  44. package/docs/arrReverse.mjs.html +1 -1
  45. package/docs/arrSep.mjs.html +1 -1
  46. package/docs/arrSort.mjs.html +1 -1
  47. package/docs/asind.mjs.html +1 -1
  48. package/docs/atan2d.mjs.html +1 -1
  49. package/docs/atand.mjs.html +1 -1
  50. package/docs/attstr.mjs.html +1 -1
  51. package/docs/b642obj.mjs.html +1 -1
  52. package/docs/b642str.mjs.html +1 -1
  53. package/docs/b642u16arr.mjs.html +1 -1
  54. package/docs/b642u8arr.mjs.html +1 -1
  55. package/docs/binstr.mjs.html +1 -1
  56. package/docs/blob2ab.mjs.html +1 -1
  57. package/docs/blob2b64.mjs.html +1 -1
  58. package/docs/blob2str.mjs.html +1 -1
  59. package/docs/blob2u8arr.mjs.html +1 -1
  60. package/docs/blobs2b64s.mjs.html +1 -1
  61. package/docs/blobs2u8arrs.mjs.html +1 -1
  62. package/docs/bodyLog.mjs.html +1 -1
  63. package/docs/browserView.mjs.html +1 -1
  64. package/docs/browserViewFromBlob.mjs.html +1 -1
  65. package/docs/browserViewFromText.mjs.html +1 -1
  66. package/docs/browserViewFromU8arr.mjs.html +1 -1
  67. package/docs/bs2u8arr.mjs.html +1 -1
  68. package/docs/bufRead.mjs.html +1 -1
  69. package/docs/bufReadDbl.mjs.html +1 -1
  70. package/docs/bufWrite.mjs.html +1 -1
  71. package/docs/bufWriteDbl.mjs.html +1 -1
  72. package/docs/cache.mjs.html +1 -1
  73. package/docs/cacheBd.mjs.html +1 -1
  74. package/docs/cacheSt.mjs.html +1 -1
  75. package/docs/cbol.mjs.html +1 -1
  76. package/docs/cdbl.mjs.html +1 -1
  77. package/docs/ceil.mjs.html +1 -1
  78. package/docs/cfilesize.mjs.html +1 -1
  79. package/docs/cfinancial.mjs.html +1 -1
  80. package/docs/cint.mjs.html +1 -1
  81. package/docs/clearXSS.mjs.html +263 -25
  82. package/docs/clearXSSDyn.mjs.html +1 -1
  83. package/docs/color.mjs.html +1 -1
  84. package/docs/composeToTree.mjs.html +1 -1
  85. package/docs/convertToTree.mjs.html +1 -1
  86. package/docs/copyStrToClipboard.mjs.html +1 -1
  87. package/docs/cosd.mjs.html +1 -1
  88. package/docs/cotd.mjs.html +1 -1
  89. package/docs/createExcelWorkbook.mjs.html +1 -1
  90. package/docs/cscd.mjs.html +1 -1
  91. package/docs/cstr.mjs.html +1 -1
  92. package/docs/cvOrmFind.mjs.html +1 -1
  93. package/docs/day2cht.mjs.html +1 -1
  94. package/docs/debounce.mjs.html +1 -1
  95. package/docs/delay.mjs.html +1 -1
  96. package/docs/detectXSS.mjs.html +1 -1
  97. package/docs/detectXSSDyn.mjs.html +1 -1
  98. package/docs/dig.mjs.html +1 -1
  99. package/docs/digExp.mjs.html +1 -1
  100. package/docs/domAlert.mjs.html +1 -1
  101. package/docs/domAppend.mjs.html +1 -1
  102. package/docs/domCancelEvent.mjs.html +1 -1
  103. package/docs/domCompareText.mjs.html +1 -1
  104. package/docs/domConvertToPic.mjs.html +1 -1
  105. package/docs/domConvertToPicDyn.mjs.html +1 -1
  106. package/docs/domDetect.mjs.html +1 -1
  107. package/docs/domDrag.mjs.html +1 -1
  108. package/docs/domDragBarAndScroll.mjs.html +1 -1
  109. package/docs/domDragPointer.mjs.html +1 -1
  110. package/docs/domDragPreview.mjs.html +1 -1
  111. package/docs/domDropFiles.mjs.html +1 -1
  112. package/docs/domElementsFromPoint.mjs.html +1 -1
  113. package/docs/domFadeIn.mjs.html +1 -1
  114. package/docs/domFadeOut.mjs.html +1 -1
  115. package/docs/domFind.mjs.html +1 -1
  116. package/docs/domFinds.mjs.html +1 -1
  117. package/docs/domGetAttr.mjs.html +1 -1
  118. package/docs/domGetBoudRect.mjs.html +1 -1
  119. package/docs/domGetBoudRectRefSelf.mjs.html +1 -1
  120. package/docs/domGetFileAccept.mjs.html +1 -1
  121. package/docs/domGetFiles.mjs.html +1 -1
  122. package/docs/domGetParents.mjs.html +1 -1
  123. package/docs/domGetPointFromEvent.mjs.html +1 -1
  124. package/docs/domGetScrollableParent.mjs.html +1 -1
  125. package/docs/domGetWindowSize.mjs.html +1 -1
  126. package/docs/domIsClientXYIn.mjs.html +1 -1
  127. package/docs/domIsFocused.mjs.html +1 -1
  128. package/docs/domIsRendered.mjs.html +1 -1
  129. package/docs/domIsStable.mjs.html +1 -1
  130. package/docs/domIsVisible.mjs.html +1 -1
  131. package/docs/domPrepend.mjs.html +1 -1
  132. package/docs/domRemove.mjs.html +1 -1
  133. package/docs/domRenderMarkdownMind.mjs.html +1 -1
  134. package/docs/domRenderMarkdownMindDyn.mjs.html +1 -1
  135. package/docs/domRipple.mjs.html +1 -1
  136. package/docs/domScrollIntoView.mjs.html +1 -1
  137. package/docs/domScrollTo.mjs.html +1 -1
  138. package/docs/domSetAttr.mjs.html +1 -1
  139. package/docs/domShowImages.mjs.html +1 -1
  140. package/docs/domShowImagesDyn.mjs.html +1 -1
  141. package/docs/domShowInputAndGetFiles.mjs.html +1 -1
  142. package/docs/domShowInputAndGetFilesU8Arrs.mjs.html +1 -1
  143. package/docs/domShowInputDatatime.mjs.html +1 -1
  144. package/docs/domTooltip.mjs.html +1 -1
  145. package/docs/domTriggerEvent.mjs.html +1 -1
  146. package/docs/domVirtualCreate.mjs.html +1 -1
  147. package/docs/domVirtualCreateQueue.mjs.html +1 -1
  148. package/docs/downloadExcelFileFromData.mjs.html +1 -1
  149. package/docs/downloadExcelFileFromDataDyn.mjs.html +1 -1
  150. package/docs/downloadFileFromB64.mjs.html +1 -1
  151. package/docs/downloadFileFromBlob.mjs.html +1 -1
  152. package/docs/downloadFileFromText.mjs.html +1 -1
  153. package/docs/downloadFileFromU8Arr.mjs.html +1 -1
  154. package/docs/dtmapping.mjs.html +1 -1
  155. package/docs/dtpick.mjs.html +1 -1
  156. package/docs/estimateTicks.mjs.html +1 -1
  157. package/docs/evEmit.mjs.html +1 -1
  158. package/docs/evEmitDelay.mjs.html +1 -1
  159. package/docs/evem.mjs.html +1 -1
  160. package/docs/examples/ex-blob2b64.html +1 -1
  161. package/docs/examples/ex-clearXSS.html +1 -1
  162. package/docs/examples/ex-clearXSSDyn.html +1 -1
  163. package/docs/examples/ex-colorConverter.html +1 -1
  164. package/docs/examples/ex-detectXSS.html +1 -1
  165. package/docs/examples/ex-detectXSSDyn.html +1 -1
  166. package/docs/examples/ex-domCompareText.html +1 -1
  167. package/docs/examples/ex-domConvertToPic.html +1 -1
  168. package/docs/examples/ex-domDrag.html +1 -1
  169. package/docs/examples/ex-domDropFiles.html +1 -1
  170. package/docs/examples/ex-domIsVisible.html +1 -1
  171. package/docs/examples/ex-domRenderMarkdownMind.html +1 -1
  172. package/docs/examples/ex-domRenderMarkdownMindDyn.html +1 -1
  173. package/docs/examples/ex-domRipple.html +1 -1
  174. package/docs/examples/ex-domScrollIntoView.html +1 -1
  175. package/docs/examples/ex-domScrollTo.html +1 -1
  176. package/docs/examples/ex-domShowImages.html +1 -1
  177. package/docs/examples/ex-domShowImagesDyn.html +1 -1
  178. package/docs/examples/ex-domShowInputAndGetFiles.html +1 -1
  179. package/docs/examples/ex-domTooltip.html +1 -1
  180. package/docs/examples/ex-getFileHash.html +1 -1
  181. package/docs/examples/ex-getUserAgent.html +1 -1
  182. package/docs/examples/ex-getUserAgentDyn.html +1 -1
  183. package/docs/examples/ex-html2str.html +1 -1
  184. package/docs/examples/ex-obj2u8arr-u8arr2obj.html +1 -1
  185. package/docs/examples/ex-openLink.html +1 -1
  186. package/docs/examples/ex-str2aes-aes2str.html +1 -1
  187. package/docs/examples/ex-str2b64-b642str.html +1 -1
  188. package/docs/examples/ex-strFindFuzz.html +1 -1
  189. package/docs/examples/ex-timeTZ2expire-timeTZ2past.html +1 -1
  190. package/docs/examples/ex-xlsx.html +1 -1
  191. package/docs/execCli.mjs.html +1 -1
  192. package/docs/execCliCore.mjs.html +1 -1
  193. package/docs/execCliJsonRpc.mjs.html +1 -1
  194. package/docs/execCliSession.mjs.html +1 -1
  195. package/docs/execJsCode.mjs.html +1 -1
  196. package/docs/execProcess.mjs.html +1 -1
  197. package/docs/execProcessKillPid.mjs.html +1 -1
  198. package/docs/filepathToTree.mjs.html +1 -1
  199. package/docs/files2data.mjs.html +1 -1
  200. package/docs/flattenToConn.mjs.html +12 -8
  201. package/docs/flattenTree.mjs.html +9 -9
  202. package/docs/floor.mjs.html +1 -1
  203. package/docs/fsBuildReadStreamText.mjs.html +1 -1
  204. package/docs/fsBuildWriteStreamText.mjs.html +1 -1
  205. package/docs/fsCleanFolder.mjs.html +1 -1
  206. package/docs/fsCleanFolderCore.mjs.html +1 -1
  207. package/docs/fsCopyFile.mjs.html +1 -1
  208. package/docs/fsCopyFileCore.mjs.html +1 -1
  209. package/docs/fsCopyFolder.mjs.html +1 -1
  210. package/docs/fsCopyFolderCore.mjs.html +1 -1
  211. package/docs/fsCreateFile.mjs.html +1 -1
  212. package/docs/fsCreateFileCore.mjs.html +1 -1
  213. package/docs/fsCreateFolder.mjs.html +1 -1
  214. package/docs/fsCreateFolderCore.mjs.html +1 -1
  215. package/docs/fsDeleteFile.mjs.html +1 -1
  216. package/docs/fsDeleteFileCore.mjs.html +1 -1
  217. package/docs/fsDeleteFileSafe.mjs.html +1 -1
  218. package/docs/fsDeleteFileSafeCore.mjs.html +1 -1
  219. package/docs/fsDeleteFolder.mjs.html +1 -1
  220. package/docs/fsDeleteFolderCore.mjs.html +1 -1
  221. package/docs/fsDeleteFolderSafe.mjs.html +1 -1
  222. package/docs/fsDeleteFolderSafeCore.mjs.html +1 -1
  223. package/docs/fsDownloadFile.mjs.html +1 -1
  224. package/docs/fsDownloadFileCore.mjs.html +1 -1
  225. package/docs/fsEvem.mjs.html +1 -1
  226. package/docs/fsExists.mjs.html +1 -1
  227. package/docs/fsExistsCore.mjs.html +1 -1
  228. package/docs/fsGetFileBasicHash.mjs.html +1 -1
  229. package/docs/fsGetFileBasicHashCore.mjs.html +1 -1
  230. package/docs/fsGetFileHash.mjs.html +1 -1
  231. package/docs/fsGetFileHashCore.mjs.html +1 -1
  232. package/docs/fsGetFileXxHash.mjs.html +1 -1
  233. package/docs/fsGetFileXxHashCore.mjs.html +1 -1
  234. package/docs/fsGetFilesInFolder.mjs.html +1 -1
  235. package/docs/fsGetFilesInFolderCore.mjs.html +1 -1
  236. package/docs/fsGetFilesWithHashInFolder.mjs.html +1 -1
  237. package/docs/fsGetFilesWithHashInFolderCore.mjs.html +1 -1
  238. package/docs/fsGetFolderBasicHash.mjs.html +1 -1
  239. package/docs/fsGetFolderBasicHashCore.mjs.html +1 -1
  240. package/docs/fsGetFoldersInFolder.mjs.html +1 -1
  241. package/docs/fsGetFoldersInFolderCore.mjs.html +1 -1
  242. package/docs/fsIsFile.mjs.html +1 -1
  243. package/docs/fsIsFileCore.mjs.html +1 -1
  244. package/docs/fsIsFolder.mjs.html +1 -1
  245. package/docs/fsIsFolderCore.mjs.html +1 -1
  246. package/docs/fsMergeFiles.mjs.html +1 -1
  247. package/docs/fsMergeFilesCore.mjs.html +1 -1
  248. package/docs/fsReadJson.mjs.html +1 -1
  249. package/docs/fsReadText.mjs.html +1 -1
  250. package/docs/fsReadTextCore.mjs.html +1 -1
  251. package/docs/fsRenameFile.mjs.html +1 -1
  252. package/docs/fsRenameFileCore.mjs.html +1 -1
  253. package/docs/fsRenameFolder.mjs.html +1 -1
  254. package/docs/fsRenameFolderCore.mjs.html +1 -1
  255. package/docs/fsSrlog.mjs.html +1 -1
  256. package/docs/fsSyncFolder.mjs.html +1 -1
  257. package/docs/fsSyncFolderCore.mjs.html +1 -1
  258. package/docs/fsTask.mjs.html +14 -13
  259. package/docs/fsTaskCp.mjs.html +1 -1
  260. package/docs/fsTreeFolder.mjs.html +1 -1
  261. package/docs/fsTreeFolderCore.mjs.html +1 -1
  262. package/docs/fsTreeFolderWithHash.mjs.html +1 -1
  263. package/docs/fsTreeFolderWithHashCore.mjs.html +1 -1
  264. package/docs/fsWatchFile.mjs.html +1 -1
  265. package/docs/fsWatchFolder.mjs.html +1 -1
  266. package/docs/fsWriteJson.mjs.html +1 -1
  267. package/docs/fsWriteText.mjs.html +1 -1
  268. package/docs/fsWriteTextCore.mjs.html +1 -1
  269. package/docs/genGradientColor.mjs.html +1 -1
  270. package/docs/genID.mjs.html +1 -1
  271. package/docs/genIDSeq.mjs.html +1 -1
  272. package/docs/genPm.mjs.html +1 -1
  273. package/docs/getBufferSize.mjs.html +1 -1
  274. package/docs/getClearPathName.mjs.html +1 -1
  275. package/docs/getCsvStrFromData.mjs.html +1 -1
  276. package/docs/getDataFromExcelFileU8Arr.mjs.html +1 -1
  277. package/docs/getDataFromExcelFileU8ArrDyn.mjs.html +1 -1
  278. package/docs/getEnv.mjs.html +1 -1
  279. package/docs/getErrorMessage.mjs.html +1 -1
  280. package/docs/getExcelU8ArrFromData.mjs.html +1 -1
  281. package/docs/getExcelU8ArrFromWorkbook.mjs.html +1 -1
  282. package/docs/getExcelWorkbookFromData.mjs.html +1 -1
  283. package/docs/getExcelWorkbookFromWorksheet.mjs.html +1 -1
  284. package/docs/getExcelWorksheetFromData.mjs.html +1 -1
  285. package/docs/getFileAccept.mjs.html +3 -4
  286. package/docs/getFileBasicHash.mjs.html +1 -1
  287. package/docs/getFileHash.mjs.html +1 -1
  288. package/docs/getFileName.mjs.html +1 -1
  289. package/docs/getFileNameExt.mjs.html +1 -1
  290. package/docs/getFileTrueName.mjs.html +1 -1
  291. package/docs/getFileType.mjs.html +150 -5
  292. package/docs/getFileXxHash.mjs.html +1 -1
  293. package/docs/getGlobal.mjs.html +1 -1
  294. package/docs/getObjSize.mjs.html +1 -1
  295. package/docs/getPathParent.mjs.html +1 -1
  296. package/docs/getTimeBetween.mjs.html +1 -1
  297. package/docs/getTimeFromUnit.mjs.html +1 -1
  298. package/docs/getTimeHp.mjs.html +1 -1
  299. package/docs/getTimeObject.mjs.html +1 -1
  300. package/docs/getTimeRange.mjs.html +1 -1
  301. package/docs/getUserAgent.mjs.html +1 -1
  302. package/docs/getUserAgentDyn.mjs.html +1 -1
  303. package/docs/getltdtkeys.mjs.html +7 -6
  304. package/docs/global.html +1 -1
  305. package/docs/haskey.mjs.html +1 -1
  306. package/docs/html2str.mjs.html +1 -1
  307. package/docs/htmlDecode.mjs.html +1 -1
  308. package/docs/htmlEncode.mjs.html +1 -1
  309. package/docs/importResources.mjs.html +1 -1
  310. package/docs/index.html +1 -1
  311. package/docs/interp1.mjs.html +1 -1
  312. package/docs/isDate.mjs.html +1 -1
  313. package/docs/isDev.mjs.html +1 -1
  314. package/docs/isEle.mjs.html +1 -1
  315. package/docs/isEleExistByID.mjs.html +1 -1
  316. package/docs/isEmail.mjs.html +1 -1
  317. package/docs/isErr.mjs.html +1 -1
  318. package/docs/isIE.mjs.html +1 -1
  319. package/docs/isNarrow.mjs.html +1 -1
  320. package/docs/isStrHasCapital.mjs.html +1 -1
  321. package/docs/isStrHasLetter.mjs.html +1 -1
  322. package/docs/isStrHasLowerCase.mjs.html +1 -1
  323. package/docs/isStrHasNumber.mjs.html +1 -1
  324. package/docs/isStrHasSpace.mjs.html +1 -1
  325. package/docs/isStrHasSymbol.mjs.html +1 -1
  326. package/docs/isUserIdentify.mjs.html +1 -1
  327. package/docs/isUserName.mjs.html +1 -1
  328. package/docs/isUserPw.mjs.html +1 -1
  329. package/docs/isWindow.mjs.html +1 -1
  330. package/docs/isab.mjs.html +1 -1
  331. package/docs/isarr.mjs.html +1 -1
  332. package/docs/isarr0.mjs.html +1 -1
  333. package/docs/isarr1.mjs.html +1 -1
  334. package/docs/isbigint.mjs.html +1 -1
  335. package/docs/isblob.mjs.html +1 -1
  336. package/docs/isbol.mjs.html +1 -1
  337. package/docs/isday.mjs.html +1 -1
  338. package/docs/isearr.mjs.html +1 -1
  339. package/docs/iseobj.mjs.html +1 -1
  340. package/docs/iser.mjs.html +1 -1
  341. package/docs/isernot.mjs.html +1 -1
  342. package/docs/isestr.mjs.html +1 -1
  343. package/docs/isfile.mjs.html +1 -1
  344. package/docs/isfun.mjs.html +1 -1
  345. package/docs/isint.mjs.html +1 -1
  346. package/docs/ismonth.mjs.html +1 -1
  347. package/docs/isn0int.mjs.html +1 -1
  348. package/docs/isn0num.mjs.html +1 -1
  349. package/docs/isnan.mjs.html +1 -1
  350. package/docs/isnbr.mjs.html +1 -1
  351. package/docs/isnint.mjs.html +1 -1
  352. package/docs/isnnum.mjs.html +1 -1
  353. package/docs/isnull.mjs.html +1 -1
  354. package/docs/isnum.mjs.html +1 -1
  355. package/docs/isobj.mjs.html +1 -1
  356. package/docs/isobj0.mjs.html +1 -1
  357. package/docs/isp0int.mjs.html +1 -1
  358. package/docs/isp0num.mjs.html +1 -1
  359. package/docs/ispint.mjs.html +1 -1
  360. package/docs/ispm.mjs.html +1 -1
  361. package/docs/ispnum.mjs.html +1 -1
  362. package/docs/isstr.mjs.html +1 -1
  363. package/docs/isstr0.mjs.html +1 -1
  364. package/docs/istime.mjs.html +1 -1
  365. package/docs/istimeTZ.mjs.html +1 -1
  366. package/docs/istimems.mjs.html +1 -1
  367. package/docs/istimemsTZ.mjs.html +1 -1
  368. package/docs/isu16arr.mjs.html +1 -1
  369. package/docs/isu8arr.mjs.html +1 -1
  370. package/docs/isundefined.mjs.html +1 -1
  371. package/docs/j2o.mjs.html +1 -1
  372. package/docs/judge.mjs.html +1 -1
  373. package/docs/keysmat2ltdt.mjs.html +1 -1
  374. package/docs/ltdt2vrtsable.mjs.html +1 -1
  375. package/docs/ltdtDiff.mjs.html +1 -1
  376. package/docs/ltdtDiffByKey.mjs.html +1 -1
  377. package/docs/ltdtkeys2mat.mjs.html +1 -1
  378. package/docs/ltdtkeysheads2mat.mjs.html +1 -1
  379. package/docs/ltdtmapping.mjs.html +1 -1
  380. package/docs/ltdtmerge.mjs.html +1 -1
  381. package/docs/ltdtpick.mjs.html +1 -1
  382. package/docs/ltdtpull.mjs.html +1 -1
  383. package/docs/mat2ltdt.mjs.html +1 -1
  384. package/docs/matConcat.mjs.html +1 -1
  385. package/docs/matDiff.mjs.html +1 -1
  386. package/docs/matat.mjs.html +1 -1
  387. package/docs/now2str.mjs.html +1 -1
  388. package/docs/now2strp.mjs.html +1 -1
  389. package/docs/nowDay2str.mjs.html +1 -1
  390. package/docs/nowms2str.mjs.html +1 -1
  391. package/docs/nowms2strp.mjs.html +1 -1
  392. package/docs/o2j.mjs.html +1 -1
  393. package/docs/obj2b64.mjs.html +1 -1
  394. package/docs/obj2pb64.mjs.html +1 -1
  395. package/docs/obj2str.mjs.html +1 -1
  396. package/docs/obj2stru8arr.mjs.html +1 -1
  397. package/docs/obj2u8arr.mjs.html +1 -1
  398. package/docs/objSortBy.mjs.html +1 -1
  399. package/docs/objSortByKeys.mjs.html +1 -1
  400. package/docs/oo.mjs.html +1 -1
  401. package/docs/openLink.mjs.html +1 -1
  402. package/docs/pb642obj.mjs.html +1 -1
  403. package/docs/pmChain.mjs.html +1 -1
  404. package/docs/pmConvertResolve.mjs.html +1 -1
  405. package/docs/pmDebounce.mjs.html +1 -1
  406. package/docs/pmHook.mjs.html +1 -1
  407. package/docs/pmHookReject.mjs.html +1 -1
  408. package/docs/pmIni.mjs.html +1 -1
  409. package/docs/pmInvResolve.mjs.html +1 -1
  410. package/docs/pmKeyMutex.mjs.html +1 -1
  411. package/docs/pmMap.mjs.html +1 -1
  412. package/docs/pmQueue.mjs.html +1 -1
  413. package/docs/pmSeries.mjs.html +1 -1
  414. package/docs/pmThrottle.mjs.html +1 -1
  415. package/docs/pmTimeout.mjs.html +1 -1
  416. package/docs/preciseNum.mjs.html +1 -1
  417. package/docs/pseudoRandom.mjs.html +1 -1
  418. package/docs/pseudoRandomIntRange.mjs.html +1 -1
  419. package/docs/pseudoRandomIntsNdpRange.mjs.html +1 -1
  420. package/docs/pseudoRandomIntsRange.mjs.html +1 -1
  421. package/docs/pseudoRandomRange.mjs.html +1 -1
  422. package/docs/pseudoRandomsRange.mjs.html +1 -1
  423. package/docs/queue.mjs.html +1 -1
  424. package/docs/random.mjs.html +1 -1
  425. package/docs/randomIntRange.mjs.html +1 -1
  426. package/docs/randomIntsNdpRange.mjs.html +1 -1
  427. package/docs/randomIntsRange.mjs.html +1 -1
  428. package/docs/randomRange.mjs.html +1 -1
  429. package/docs/randomsRange.mjs.html +1 -1
  430. package/docs/rang.mjs.html +1 -1
  431. package/docs/rep.mjs.html +1 -1
  432. package/docs/repObj.mjs.html +1 -1
  433. package/docs/replace.mjs.html +1 -1
  434. package/docs/replaceObj.mjs.html +1 -1
  435. package/docs/replacePlus.mjs.html +1 -1
  436. package/docs/round.mjs.html +1 -1
  437. package/docs/secd.mjs.html +1 -1
  438. package/docs/sep.mjs.html +1 -1
  439. package/docs/sepInt.mjs.html +1 -1
  440. package/docs/setIntervalHp.mjs.html +1 -1
  441. package/docs/setTimeoutHp.mjs.html +1 -1
  442. package/docs/sind.mjs.html +1 -1
  443. package/docs/split.mjs.html +1 -1
  444. package/docs/str2aes.mjs.html +1 -1
  445. package/docs/str2b64.mjs.html +1 -1
  446. package/docs/str2hint.mjs.html +1 -1
  447. package/docs/str2md5.mjs.html +1 -1
  448. package/docs/str2obj.mjs.html +1 -1
  449. package/docs/str2sha.mjs.html +1 -1
  450. package/docs/str2sha512.mjs.html +1 -1
  451. package/docs/str2u8arr.mjs.html +1 -1
  452. package/docs/strCompare.mjs.html +1 -1
  453. package/docs/strCompareForVersion.mjs.html +1 -1
  454. package/docs/strDiff.mjs.html +1 -1
  455. package/docs/strDiffToHtml.mjs.html +1 -1
  456. package/docs/strFindFuzz.mjs.html +1 -1
  457. package/docs/strFindSimilar.mjs.html +1 -1
  458. package/docs/strTruncate.mjs.html +1 -1
  459. package/docs/strdelleft.mjs.html +1 -1
  460. package/docs/strdelright.mjs.html +1 -1
  461. package/docs/strleft.mjs.html +1 -1
  462. package/docs/strmid.mjs.html +1 -1
  463. package/docs/strright.mjs.html +1 -1
  464. package/docs/stru8arr2obj.mjs.html +1 -1
  465. package/docs/tand.mjs.html +1 -1
  466. package/docs/time2day.mjs.html +1 -1
  467. package/docs/time2hour.mjs.html +1 -1
  468. package/docs/time2min.mjs.html +1 -1
  469. package/docs/timeTZ2day.mjs.html +1 -1
  470. package/docs/timeTZ2expire.mjs.html +1 -1
  471. package/docs/timeTZ2hour.mjs.html +1 -1
  472. package/docs/timeTZ2min.mjs.html +1 -1
  473. package/docs/timeTZ2past.mjs.html +1 -1
  474. package/docs/timems2day.mjs.html +1 -1
  475. package/docs/timems2hour.mjs.html +1 -1
  476. package/docs/timems2min.mjs.html +1 -1
  477. package/docs/timems2time.mjs.html +1 -1
  478. package/docs/timemsTZ2day.mjs.html +1 -1
  479. package/docs/timemsTZ2expire.mjs.html +1 -1
  480. package/docs/timemsTZ2hour.mjs.html +1 -1
  481. package/docs/timemsTZ2min.mjs.html +1 -1
  482. package/docs/timemsTZ2past.mjs.html +1 -1
  483. package/docs/timemsTZ2time.mjs.html +1 -1
  484. package/docs/treeObj.mjs.html +7 -7
  485. package/docs/treeToFilepath.mjs.html +1 -1
  486. package/docs/trim.mjs.html +1 -1
  487. package/docs/u16arr2b64.mjs.html +1 -1
  488. package/docs/u16arr2u8arr.mjs.html +1 -1
  489. package/docs/u8arr2ab.mjs.html +1 -1
  490. package/docs/u8arr2b64.mjs.html +1 -1
  491. package/docs/u8arr2blob.mjs.html +1 -1
  492. package/docs/u8arr2bs.mjs.html +1 -1
  493. package/docs/u8arr2obj.mjs.html +17 -3
  494. package/docs/u8arr2str.mjs.html +1 -1
  495. package/docs/u8arr2u16arr.mjs.html +1 -1
  496. package/docs/urlParse.mjs.html +1 -1
  497. package/docs/verifyValue.mjs.html +1 -1
  498. package/docs/waitFun.mjs.html +1 -1
  499. package/docs/wsemi.html +49 -20
  500. package/package.json +1 -1
  501. package/src/clearXSS.mjs +262 -24
  502. package/src/flattenToConn.mjs +11 -7
  503. package/src/flattenTree.mjs +8 -8
  504. package/src/fsTask.mjs +13 -12
  505. package/src/getFileAccept.mjs +2 -3
  506. package/src/getFileType.mjs +149 -4
  507. package/src/getltdtkeys.mjs +6 -5
  508. package/src/treeObj.mjs +6 -6
  509. package/src/u8arr2obj.mjs +16 -2
  510. package/test/clearXSS.test.mjs +1276 -1
  511. package/test/domGetFileAccept.test.mjs +79 -11
  512. package/test/flattenToConn.test.mjs +83 -0
  513. package/test/flattenTree.test.mjs +49 -0
  514. package/test/fsTask.test.mjs +144 -0
  515. package/test/getFileAccept.test.mjs +83 -0
  516. package/test/getFileType.test.mjs +200 -29
  517. package/test/getltdtkeys.test.mjs +71 -0
  518. package/test/tools/clearXssWalkRunner.mjs +202 -0
  519. package/test/tools/getFileTypeBase.mjs +189 -0
  520. package/test/treeObj.test.mjs +119 -0
  521. package/test/u8arr2obj.test.mjs +107 -2
  522. package/toolfp/dist/wsemip.umd.js +1 -1
  523. package/toolparfor/dist/wpf.umd.js +1 -1
  524. package/toolparfor/dist/wpf_pmSeries.umd.js +1 -1
@@ -1,11 +1,79 @@
1
- import assert from 'assert'
2
- //import domGetFileAccept from '../src/domGetFileAccept.mjs'
3
-
4
-
5
- describe(`domGetFileAccept`, function() {
6
-
7
- it(`need test in browser`, function() {
8
- assert.strict.deepStrictEqual(1, 1)
9
- })
10
-
11
- })
1
+ import assert from 'assert'
2
+ import domGetFileAccept from '../src/domGetFileAccept.mjs'
3
+ import base, { applyChanges } from './tools/getFileTypeBase.mjs'
4
+
5
+
6
+ describe(`domGetFileAccept`, function() {
7
+
8
+ it(`need test in browser`, function() {
9
+ assert.strict.deepStrictEqual(1, 1)
10
+ })
11
+
12
+ })
13
+
14
+
15
+ //R-FILETYPE-01: 以修前基準表(獨立於 src)推得修前之 accept 片段, 驗證表擴充後(集合)只增不減
16
+ describe(`domGetFileAccept 隨 getFileType 表擴充只增不減(R-FILETYPE-01)`, function() {
17
+
18
+ //oldRaw: 修前原樣; oldOf: 套用規則 5(heic 之 acp 為 image/heic)後之既有項目片段, 新增片段附於其後
19
+ let uniq = (arr) => [...new Set(arr)]
20
+ let rowsNow = applyChanges(base)
21
+ let oldRaw = (group) => uniq(base.filter((v) => v.group === group).map((v) => v.acp))
22
+ let oldOf = (group) => uniq(rowsNow.filter((v) => v.group === group).map((v) => v.acp))
23
+ let toks = (s) => (s === '' ? [] : s.split(','))
24
+
25
+ //image/heif 原由 heic 帶入, heic 改 image/heic 後改由新增之 heif 列帶入(位於新增片段中)
26
+ let addImage = ['image/svg+xml', 'image/heif', 'image/vnd.dxf']
27
+ let addData = [
28
+ 'text/markdown',
29
+ 'application/yaml',
30
+ 'text/tab-separated-values',
31
+ 'application/vnd.google-earth.kml+xml',
32
+ 'application/gpx+xml',
33
+ ]
34
+
35
+ it(`'*' 與非字串/非陣列維持 '*'`, function() {
36
+ assert.strict.deepStrictEqual(domGetFileAccept('*'), '*')
37
+ assert.strict.deepStrictEqual(domGetFileAccept(), '*')
38
+ assert.strict.deepStrictEqual(domGetFileAccept(123), '*')
39
+ })
40
+
41
+ it(`'docums' 與 'compress' 與修前完全相同`, function() {
42
+ assert.strict.deepStrictEqual(domGetFileAccept('docums'), oldOf('docums').join(','))
43
+ assert.strict.deepStrictEqual(domGetFileAccept('compress'), oldOf('compress').join(','))
44
+ })
45
+
46
+ it(`'image': 既有片段與順序不變(heic 為 image/heic), 其後附加 ${addImage.join(',')}; 集合為修前之超集`, function() {
47
+ let r = toks(domGetFileAccept('image'))
48
+ assert.strict.deepStrictEqual(r, [...oldOf('image'), ...addImage])
49
+ assert.strict.deepStrictEqual(oldRaw('image').every((v) => r.includes(v)), true)
50
+ assert.strict.deepStrictEqual(r.includes('image/heic'), true)
51
+ assert.strict.deepStrictEqual(r.indexOf('image/heic') < r.indexOf('image/svg+xml'), true)
52
+ })
53
+
54
+ it(`'data': 修前片段與順序不變, 其後附加 ${addData.length} 項`, function() {
55
+ let r = toks(domGetFileAccept('data'))
56
+ assert.strict.deepStrictEqual(r, [...oldOf('data'), ...addData])
57
+ })
58
+
59
+ it(`'common': 修前片段與相對順序不變, 新增片段恰為 image 與 data 之附加項`, function() {
60
+ let old = [...oldOf('docums'), ...oldOf('compress'), ...oldOf('image'), ...oldOf('data')]
61
+ let oldR = [...oldRaw('docums'), ...oldRaw('compress'), ...oldRaw('image'), ...oldRaw('data')]
62
+ let r = toks(domGetFileAccept('common'))
63
+ assert.strict.deepStrictEqual(r.filter((v) => old.includes(v)), old)
64
+ assert.strict.deepStrictEqual(r.filter((v) => !old.includes(v)), [...addImage, ...addData])
65
+ assert.strict.deepStrictEqual(oldR.every((v) => r.includes(v)), true)
66
+ })
67
+
68
+ it(`以副檔名為 kind: 新增副檔名由 '' 改為對應 acp, 既有副檔名不變`, function() {
69
+ assert.strict.deepStrictEqual(domGetFileAccept(['jpg']), 'image/jpeg')
70
+ assert.strict.deepStrictEqual(domGetFileAccept(['jpeg']), 'image/jpeg')
71
+ assert.strict.deepStrictEqual(domGetFileAccept(['svg']), 'image/svg+xml')
72
+ assert.strict.deepStrictEqual(domGetFileAccept(['jpg', 'svg']), 'image/jpeg,image/svg+xml')
73
+ assert.strict.deepStrictEqual(domGetFileAccept(['md']), 'text/markdown')
74
+ assert.strict.deepStrictEqual(domGetFileAccept(['heic']), 'image/heic')
75
+ assert.strict.deepStrictEqual(domGetFileAccept(['heif']), 'image/heif')
76
+ assert.strict.deepStrictEqual(domGetFileAccept(['Z']), 'application/x-compress')
77
+ })
78
+
79
+ })
@@ -2,6 +2,89 @@ import assert from 'assert'
2
2
  import flattenToConn from '../src/flattenToConn.mjs'
3
3
 
4
4
 
5
+ describe(`flattenToConn 偽稱Array之物件視為物件(R-OBJ-ITER-01 候選10)`, function() {
6
+
7
+ //以Symbol.toStringTag偽稱'Array'之物件(isarr為真而非真陣列), 可寫與不可寫兩種標籤
8
+ let mkFake = (len, writable) => {
9
+ let o = { a: 'kept', length: len }
10
+ if (writable) {
11
+ o[Symbol.toStringTag] = 'Array'
12
+ }
13
+ else {
14
+ Object.defineProperty(o, Symbol.toStringTag, { value: 'Array' })
15
+ }
16
+ return o
17
+ }
18
+
19
+ //flattenToConn以force走訪, 含Symbol鍵(treeObj取自有屬性名稱與自有Symbol), 偽標籤本身之Symbol鍵亦成一節點; 此處只比對字串鍵之節點
20
+ let strNodes = (r) => r.filter((v) => !/Symbol\(/.test(String(v.id)))
21
+
22
+ for (let writable of [true, false]) {
23
+ let tag = writable ? 'writable' : 'non-writable'
24
+
25
+ it(`should give the same nodes for a nested object faking Array (${tag} tag, length 2) as for the plain object with the same keys`, function() {
26
+ let r = strNodes(flattenToConn({ child: mkFake(2, writable) }))
27
+ let e = flattenToConn({ child: { a: 'kept', length: 2 } })
28
+ assert.strict.deepStrictEqual(r, e)
29
+ assert.strict.strictEqual(r[0].type, 'object')
30
+ assert.strict.strictEqual(r[0].numOfChilren, 2)
31
+ assert.strict.deepStrictEqual(r.map((v) => v.id), ['child', 'child-a', 'child-length'])
32
+ })
33
+
34
+ it(`should give the same nodes for a nested object faking Array (${tag} tag, length 0) as for the plain object with the same keys`, function() {
35
+ let r = strNodes(flattenToConn({ child: mkFake(0, writable) }))
36
+ let e = flattenToConn({ child: { a: 'kept', length: 0 } })
37
+ assert.strict.deepStrictEqual(r, e)
38
+ assert.strict.strictEqual(r[0].type, 'object')
39
+ })
40
+
41
+ it(`should give the same nodes for an object faking Array (${tag} tag, length 2) at the root as for the plain object with the same keys`, function() {
42
+ let r = strNodes(flattenToConn(mkFake(2, writable)))
43
+ let e = flattenToConn({ a: 'kept', length: 2 })
44
+ assert.strict.deepStrictEqual(r, e)
45
+ assert.strict.deepStrictEqual(r.map((v) => v.id), ['a', 'length'])
46
+ })
47
+ }
48
+
49
+ for (let writable of [true, false]) {
50
+ for (let len of [0, 2, 1000]) {
51
+ it(`should count the string keys as the children of an object faking Array (${writable ? 'writable' : 'non-writable'} tag, length ${len}), not the length value`, function() {
52
+ //R-OBJ-ITER-01: length為一般鍵, numOfChilren為自有鍵數(a與length共2), 與length之值無關
53
+ let o = { a: 'kept', length: len }
54
+ if (writable) {
55
+ o[Symbol.toStringTag] = 'Array'
56
+ }
57
+ else {
58
+ Object.defineProperty(o, Symbol.toStringTag, { value: 'Array' })
59
+ }
60
+ let r = flattenToConn({ child: o })
61
+ assert.strict.strictEqual(r[0].id, 'child')
62
+ assert.strict.strictEqual(r[0].type, 'object')
63
+ assert.strict.strictEqual(r[0].numOfChilren, 2)
64
+ })
65
+ }
66
+ }
67
+
68
+ for (let tag of ['Foo', 'Object', 'Arguments']) {
69
+ it(`should give array nodes for a real array with another Symbol.toStringTag (${tag}), like an ordinary array`, function() {
70
+ let a = Object.defineProperty([1, 2], Symbol.toStringTag, { value: tag })
71
+ let r = flattenToConn({ list: a })
72
+ let e = flattenToConn({ list: [1, 2] })
73
+ assert.strict.deepStrictEqual(r, e)
74
+ assert.strict.strictEqual(r[0].type, 'array')
75
+ assert.strict.deepStrictEqual(r.map((v) => v.id), ['list', 'list-0', 'list-1'])
76
+ })
77
+ }
78
+
79
+ it(`should still give array nodes for real arrays`, function() {
80
+ let r = flattenToConn({ list: [1, [2]] })
81
+ assert.strict.strictEqual(r[0].type, 'array')
82
+ assert.strict.strictEqual(r[0].numOfChilren, 2)
83
+ assert.strict.strictEqual(r.find((v) => v.id === 'list-1').type, 'array')
84
+ })
85
+
86
+ })
87
+
5
88
  describe(`flattenToConn`, function() {
6
89
 
7
90
  let obj = {
@@ -2,6 +2,55 @@ import assert from 'assert'
2
2
  import flattenTree from '../src/flattenTree.mjs'
3
3
 
4
4
 
5
+ describe(`flattenTree 偽稱Array之根節點視為物件(R-OBJ-ITER-01 候選10)`, function() {
6
+
7
+ //以Symbol.toStringTag偽稱'Array'之根節點(isarr為真而非真陣列): 結果須同無標籤之相同鍵物件(標籤不可寫者不展開進節點)
8
+ let mkFake = (writable, len = 2) => {
9
+ let o = { id: 1, length: len, children: [{ id: 2, data: 'x' }] }
10
+ if (writable) {
11
+ o[Symbol.toStringTag] = 'Array'
12
+ }
13
+ else {
14
+ Object.defineProperty(o, Symbol.toStringTag, { value: 'Array' })
15
+ }
16
+ return o
17
+ }
18
+
19
+ for (let writable of [true, false]) {
20
+ let tag = writable ? 'writable' : 'non-writable'
21
+ for (let len of [2, 0]) {
22
+ it(`should flatten a root object faking Array (${tag} tag, length ${len}) like the plain object with the same keys`, function() {
23
+ //根為物件時回傳根節點本身(含level與nk); length為0時不得被當成空陣列而回傳[]
24
+ let pick = (n) => ({ id: n.id, length: n.length, level: n.level, nk: n.nk, children: n.children })
25
+ let r = flattenTree(mkFake(writable, len))
26
+ let e = flattenTree({ id: 1, length: len, children: [{ id: 2, data: 'x' }] })
27
+ assert.strict.deepStrictEqual(pick(r), pick(e))
28
+ assert.strict.deepStrictEqual(pick(e), { id: 1, length: len, level: 0, nk: [0], children: [{ id: 2, data: 'x' }] })
29
+ })
30
+ }
31
+ }
32
+
33
+ for (let tag of ['Foo', 'Object']) {
34
+ it(`should flatten a real array root with another Symbol.toStringTag (${tag}) like an ordinary array`, function() {
35
+ let a = Object.defineProperty([{ id: 1, children: [{ id: 2 }] }], Symbol.toStringTag, { value: tag })
36
+ assert.strict.deepStrictEqual(flattenTree(a).map((v) => v.id), [1, 2])
37
+ })
38
+ }
39
+
40
+ it(`should return [] for an object faking Array without own string keys, like an empty object`, function() {
41
+ assert.strict.deepStrictEqual(flattenTree({ [Symbol.toStringTag]: 'Array' }), [])
42
+ assert.strict.deepStrictEqual(flattenTree(Object.defineProperty({}, Symbol.toStringTag, { value: 'Array' })), [])
43
+ assert.strict.deepStrictEqual(flattenTree({}), [])
44
+ })
45
+
46
+ it(`should still flatten a real array root and return [] for empty array and empty object`, function() {
47
+ assert.strict.deepStrictEqual(flattenTree([{ id: 1, children: [{ id: 2 }] }]).map((v) => v.id), [1, 2])
48
+ assert.strict.deepStrictEqual(flattenTree([]), [])
49
+ assert.strict.deepStrictEqual(flattenTree({}), [])
50
+ })
51
+
52
+ })
53
+
5
54
  describe(`flattenTree`, function() {
6
55
 
7
56
  let obj = {
@@ -3,8 +3,152 @@ import assert from 'assert'
3
3
  import fsDeleteFile from '../src/fsDeleteFile.mjs'
4
4
  import fsCreateFolder from '../src/fsCreateFolder.mjs'
5
5
  import fsDeleteFolder from '../src/fsDeleteFolder.mjs'
6
+ import { fileURLToPath } from 'url'
7
+ import { dirname, join } from 'path'
6
8
  import fsTask from '../src/fsTask.mjs'
7
9
 
10
+ let __dirname = dirname(fileURLToPath(import.meta.url))
11
+
12
+
13
+ describe(`fsTask 檔案來源之紀錄須為一般物件(R-OBJ-ITER-01 候選9)`, function() {
14
+
15
+ //fpHash.json、fpResult.json 讀自檔案(可能被竄改或損毀), 須視為一般物件之字典: length 為一般鍵, 非一般物件者視為無紀錄
16
+ let root = join(__dirname, '_tmp', 'fsTaskRecord')
17
+ let wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
18
+ let item = (p) => [{ type: 'file', path: p }]
19
+
20
+ //測試自建自刪(只刪本案資料夾, 不刪 test/_tmp 根目錄)
21
+ after(function() {
22
+ fs.rmSync(root, { recursive: true, force: true })
23
+ assert.strict.strictEqual(fs.existsSync(root), false)
24
+ })
25
+
26
+ //mk, 建立案例資料夾: watch 為監看夾(可預放檔案), _tkfs 為儲存夾(可預寫紀錄檔原文)
27
+ let mk = (name, { hash = null, result = null, files = {} } = {}) => {
28
+ let base = join(root, name)
29
+ fs.rmSync(base, { recursive: true, force: true })
30
+ let fd = join(base, 'watch')
31
+ let st = join(base, '_tkfs')
32
+ fs.mkdirSync(fd, { recursive: true })
33
+ fs.mkdirSync(st, { recursive: true })
34
+ for (let [fn, c] of Object.entries(files)) {
35
+ fs.writeFileSync(join(fd, fn), c, 'utf8')
36
+ }
37
+ if (hash !== null) {
38
+ fs.writeFileSync(join(st, 'fpHash.json'), hash, 'utf8')
39
+ }
40
+ if (result !== null) {
41
+ fs.writeFileSync(join(st, 'fpResult.json'), result, 'utf8')
42
+ }
43
+ return { fd, st }
44
+ }
45
+
46
+ //watch, 以 40 ms 輪詢 ms 毫秒, 收集 change 事件並立即 resolve 其 pm
47
+ let watch = async (c, ms = 400) => {
48
+ let events = []
49
+ let ev = fsTask(c.fd, { fdStorage: c.st, timeInterval: 40 })
50
+ ev.on('change', (msg) => {
51
+ events.push({ type: msg.type, fp: msg.fp, fn: msg.fn, hash: msg.hash })
52
+ msg.pm.resolve()
53
+ })
54
+ try {
55
+ await wait(ms)
56
+ }
57
+ finally {
58
+ ev.clear()
59
+ }
60
+ return events
61
+ }
62
+
63
+ let readJson = (c, fn) => JSON.parse(fs.readFileSync(join(c.st, fn), 'utf8'))
64
+ let sortBy = (arr) => [...arr].sort((a, b) => (a.fp < b.fp ? -1 : 1))
65
+
66
+ it(`should treat a length key of fpHash.json as an ordinary path: one del event per recorded key and none repeated`, async function() {
67
+ //修前: 整個字典依 length 當類陣列迭代, 每個輪詢週期重複派發 { type: 'del', fp: '0', fn: '0', hash: '' }
68
+ let c = mk('hash-length', { hash: '{"length":1,"a":"h"}' })
69
+ let events = await watch(c, 500)
70
+ assert.strict.deepStrictEqual(sortBy(events), [
71
+ { type: 'del', fp: 'a', fn: 'a', hash: 'h' },
72
+ { type: 'del', fp: 'length', fn: 'length', hash: 1 },
73
+ ])
74
+ assert.strict.deepStrictEqual(readJson(c, 'fpHash.json'), {})
75
+ })
76
+
77
+ it(`should dispatch one del event for a recorded path and update the record (control without length)`, async function() {
78
+ let c = mk('hash-control', { hash: '{"a":"h"}' })
79
+ let events = await watch(c, 400)
80
+ assert.strict.deepStrictEqual(events, [{ type: 'del', fp: 'a', fn: 'a', hash: 'h' }])
81
+ assert.strict.deepStrictEqual(readJson(c, 'fpHash.json'), {})
82
+ })
83
+
84
+ it(`should dispatch add once for a watched file named length`, async function() {
85
+ let c = mk('hash-file-length', { files: { length: 'abc' } })
86
+ let events = await watch(c, 400)
87
+ assert.strict.deepStrictEqual(events.map((v) => [v.type, v.fn]), [['add', 'length']])
88
+ assert.strict.deepStrictEqual(Object.keys(readJson(c, 'fpHash.json')), [events[0].fp])
89
+ })
90
+
91
+ let notObjs = ['["a","b"]', '"abc"', '123', 'null', 'true', '{bad', '']
92
+ for (let content of notObjs) {
93
+ it(`should treat fpHash.json as no record when it is not a plain object (${JSON.stringify(content)}): no event for an empty folder`, async function() {
94
+ let c = mk('hash-notobj', { hash: content })
95
+ let events = await watch(c, 300)
96
+ assert.strict.deepStrictEqual(events, [])
97
+ })
98
+
99
+ it(`should dispatch add once for a new file and record it when fpHash.json is not a plain object (${JSON.stringify(content)})`, async function() {
100
+ let c = mk('hash-notobj-file', { hash: content, files: { 'f.txt': 'abc' } })
101
+ let events = await watch(c, 400)
102
+ assert.strict.deepStrictEqual(events.map((v) => [v.type, v.fn]), [['add', 'f.txt']])
103
+ assert.strict.deepStrictEqual(Object.keys(readJson(c, 'fpHash.json')), [events[0].fp])
104
+ })
105
+ }
106
+
107
+ it(`should keep other results and the length key when fpResult.json has a length key and a result is taken`, function() {
108
+ //修前: each 依 length 當類陣列迭代, 其他結果全被清空, 檔案寫成 {}
109
+ let c = mk('result-length', { result: JSON.stringify({ 'length': 0, 'a|h': item('x'), 'b|h': item('y') }) })
110
+ let ev = fsTask(c.fd, { fdStorage: c.st, timeInterval: 100000 })
111
+ try {
112
+ assert.strict.deepStrictEqual(ev.getAndEliminateResult('a', 'h'), item('x'))
113
+ }
114
+ finally {
115
+ ev.clear()
116
+ }
117
+ assert.strict.deepStrictEqual(readJson(c, 'fpResult.json'), { 'length': 0, 'b|h': item('y') })
118
+ })
119
+
120
+ it(`should keep other results when a result is taken (control without length)`, function() {
121
+ let c = mk('result-control', { result: JSON.stringify({ 'a|h': item('x'), 'b|h': item('y') }) })
122
+ let ev = fsTask(c.fd, { fdStorage: c.st, timeInterval: 100000 })
123
+ try {
124
+ assert.strict.deepStrictEqual(ev.getAndEliminateResult('a', 'h'), item('x'))
125
+ }
126
+ finally {
127
+ ev.clear()
128
+ }
129
+ assert.strict.deepStrictEqual(readJson(c, 'fpResult.json'), { 'b|h': item('y') })
130
+ })
131
+
132
+ for (let content of notObjs) {
133
+ it(`should treat fpResult.json as no record when it is not a plain object (${JSON.stringify(content)}): setResult does not throw and results can be taken`, function() {
134
+ //修前: 字串/數字/null/布林使 setResult 拋 TypeError, 字串被展開寫成 {"0":"a",...}
135
+ let c = mk('result-notobj', { result: content })
136
+ let ev = fsTask(c.fd, { fdStorage: c.st, timeInterval: 100000 })
137
+ try {
138
+ assert.strict.deepStrictEqual(ev.getAndEliminateResult('x', 'y'), [])
139
+ assert.strict.deepStrictEqual(readJson(c, 'fpResult.json'), {})
140
+ ev.setResult('f', 'h', item('p'))
141
+ assert.strict.deepStrictEqual(readJson(c, 'fpResult.json'), { 'f|h': item('p') })
142
+ assert.strict.deepStrictEqual(ev.getAndEliminateResult('f', 'h'), item('p'))
143
+ assert.strict.deepStrictEqual(readJson(c, 'fpResult.json'), {})
144
+ }
145
+ finally {
146
+ ev.clear()
147
+ }
148
+ })
149
+ }
150
+
151
+ })
8
152
 
9
153
  describe(`fsTask`, function() {
10
154
 
@@ -1,5 +1,7 @@
1
1
  import assert from 'assert'
2
2
  import getFileAccept from '../src/getFileAccept.mjs'
3
+ import getFileType from '../src/getFileType.mjs'
4
+ import base, { applyChanges } from './tools/getFileTypeBase.mjs'
3
5
 
4
6
 
5
7
  describe(`getFileAccept`, function() {
@@ -33,3 +35,84 @@ describe(`getFileAccept`, function() {
33
35
  })
34
36
 
35
37
  })
38
+
39
+
40
+ describe(`getFileAccept 隨 getFileType 表擴充(R-FILETYPE-01)`, function() {
41
+
42
+ it(`getFileAccept() 與 getFileType() 為同一份全表, 前 ${base.length} 列為修前原樣(唯一差異 heic 之 acp)`, function() {
43
+ assert.strict.strictEqual(getFileAccept(), getFileType())
44
+ assert.strict.deepStrictEqual(getFileAccept().slice(0, base.length), applyChanges(base))
45
+ })
46
+
47
+ it(`依 acp 群組化: 既有成員順序不變, 新增成員附於其後`, function() {
48
+ let r = getFileAccept('acp')
49
+ assert.strict.deepStrictEqual(r['image/jpeg'].map((v) => v.name), ['jpg', 'jpeg', 'jpe', 'jfif'])
50
+ assert.strict.deepStrictEqual(r['image/tiff'].map((v) => v.name), ['tif', 'tiff'])
51
+ assert.strict.deepStrictEqual(r['text/plain'].map((v) => v.name), ['txt', 'log', 'ini'])
52
+ assert.strict.deepStrictEqual(r['image/heic'].map((v) => v.name), ['heic'])
53
+ assert.strict.deepStrictEqual(r['image/heif'].map((v) => v.name), ['heif'])
54
+ assert.strict.deepStrictEqual(r['image/svg+xml'].map((v) => v.name), ['svg'])
55
+ assert.strict.deepStrictEqual(r['text/markdown'].map((v) => v.name), ['md', 'markdown'])
56
+ assert.strict.deepStrictEqual(r['application/yaml'].map((v) => v.name), ['yaml', 'yml'])
57
+ })
58
+
59
+ it(`依 name 群組化: 每個鍵恰一列, 表內大寫鍵 Z 維持原樣`, function() {
60
+ let r = getFileAccept('name')
61
+ assert.strict.deepStrictEqual(Object.keys(r).length, getFileAccept().length)
62
+ assert.strict.deepStrictEqual(r['Z'].length, 1)
63
+ })
64
+
65
+ })
66
+
67
+
68
+ describe(`getFileAccept 分組鍵以自有屬性判斷(R-FILETYPE-01 規則 6)`, function() {
69
+
70
+ //Object.prototype 之成員名(不含 __proto__, 其由規則 1 禁止作為表內值)
71
+ let protoNames = ['constructor', 'toString', 'valueOf', 'hasOwnProperty', 'isPrototypeOf', 'propertyIsEnumerable', 'toLocaleString']
72
+
73
+ //於 getFileType() 回傳之表尾暫時加列(getFileAccept 取同一份表), 結束必還原
74
+ function withRows(rows, fun) {
75
+ let tbl = getFileType()
76
+ let n0 = tbl.length
77
+ tbl.push(...rows)
78
+ try {
79
+ return fun()
80
+ }
81
+ finally {
82
+ tbl.splice(n0)
83
+ }
84
+ }
85
+
86
+ for (let by of ['name', 'acp', 'group', 'exec']) {
87
+ it(`${by} 之值為 Object.prototype 成員名: 不拋錯, 各值為自有鍵且成員為該值之列`, function() {
88
+ let mk = (v, i) => ({ name: `zz${i}`, group: 'g', acp: 'a/b', exec: '', [by]: v })
89
+ let rows = [...protoNames.map(mk), mk('constructor', 99)]
90
+ let r = withRows(rows, () => getFileAccept(by))
91
+ for (let v of protoNames) {
92
+ assert.strict.deepStrictEqual(Object.prototype.hasOwnProperty.call(r, v), true, v)
93
+ assert.strict.deepStrictEqual(Array.isArray(r[v]), true, v)
94
+ let expected = rows.filter((x) => x[by] === v)
95
+ assert.strict.deepStrictEqual(r[v], expected, v)
96
+ }
97
+ assert.strict.deepStrictEqual(r['constructor'].length, 2)
98
+ })
99
+ }
100
+
101
+ it(`回傳物件之原型仍為 Object.prototype, 分組值皆為陣列`, function() {
102
+ for (let by of ['name', 'acp', 'group', 'exec']) {
103
+ let r = getFileAccept(by)
104
+ assert.strict.strictEqual(Object.getPrototypeOf(r), Object.prototype)
105
+ for (let k of Object.keys(r)) {
106
+ assert.strict.deepStrictEqual(Array.isArray(r[k]), true, `${by} ${k}`)
107
+ }
108
+ }
109
+ })
110
+
111
+ it(`暫時加列後已還原, 表長度與修前加新增項相同`, function() {
112
+ let n = getFileType().length
113
+ withRows([{ name: 'zz', group: 'g', acp: 'a/b', exec: '' }], () => null)
114
+ assert.strict.deepStrictEqual(getFileType().length, n)
115
+ assert.strict.deepStrictEqual(n, base.length + 21)
116
+ })
117
+
118
+ })