wsemi 1.9.21 → 1.9.23

package/test/tools/getFileTypeBase.mjs

@@ -0,0 +1,189 @@
+//修前(wsemi 1.9.22, a29cb722b)之 getFileType 全表原樣，供 R-FILETYPE-01 鎖定既有項目之順序與內容不變，勿隨 src 同步修改
+export default [
+    { name: 'pic', group: 'image', acp: 'image/*', exec: 'imageviwer' },
+    { name: 'xml', group: 'data', acp: 'text/xml', exec: 'textviwer' },
+    { name: 'htm', group: 'docums', acp: 'text/html', exec: 'browser' },
+    { name: 'html', group: 'docums', acp: 'text/html', exec: 'browser' },
+    { name: 'json', group: 'data', acp: 'application/json', exec: 'textviwer' },
+    { name: 'geojson', group: 'data', acp: 'application/geo+json', exec: 'textviwer' },
+    { name: 'txt', group: 'data', acp: 'text/plain', exec: 'textviwer' },
+    { name: 'csv', group: 'data', acp: 'text/csv', exec: 'excel' },
+    { name: 'dat', group: 'data', acp: 'application/octet-stream', exec: 'binaryviwer' },
+    { name: '7z', group: 'compress', acp: 'application/x-7z-compressed', exec: 'compressor' },
+    { name: 'bzip', group: 'compress', acp: 'application/x-bzip', exec: '7z' },
+    { name: 'bzip2', group: 'compress', acp: 'application/x-bzip2', exec: 'compressor' },
+    { name: 'bz2', group: 'compress', acp: 'application/x-bzip2', exec: 'compressor' },
+    { name: 'ace', group: 'compress', acp: 'application/x-ace-compressed', exec: 'compressor' },
+    { name: 'Z', group: 'compress', acp: 'application/x-compress', exec: 'compressor' },
+    { name: 'lzh', group: 'compress', acp: 'application/x-lzh-compressed', exec: 'compressor' },
+    { name: 'lz', group: 'compress', acp: 'application/x-lzip', exec: 'compressor' },
+    { name: 'rar', group: 'compress', acp: 'application/x-rar-compressed', exec: 'compressor' },
+    { name: 'tar', group: 'compress', acp: 'application/x-tar', exec: 'compressor' },
+    { name: 'ar', group: 'compress', acp: 'application/x-unix-archive', exec: 'compressor' },
+    { name: 'zip', group: 'compress', acp: 'application/zip', exec: 'compressor' },
+    { name: 'gz', group: 'compress', acp: 'application/gzip', exec: 'compressor' },
+    { name: 'avro', group: '', acp: 'application/avro', exec: '' },
+    { name: 'dcm', group: '', acp: 'application/dicom', exec: '' },
+    { name: 'eps', group: '', acp: 'application/eps', exec: '' },
+    { name: 'epub', group: '', acp: 'application/epub+zip', exec: '' },
+    { name: 'class', group: '', acp: 'application/java-vm', exec: '' },
+    { name: 'mxf', group: '', acp: 'application/mxf', exec: '' },
+    { name: 'ogx', group: '', acp: 'application/ogg', exec: '' },
+    { name: 'pdf', group: 'docums', acp: 'application/pdf', exec: 'acrobat' },
+    { name: 'pgp', group: '', acp: 'application/pgp-encrypted', exec: '' },
+    { name: 'ps', group: '', acp: 'application/postscript', exec: '' },
+    { name: 'ai', group: '', acp: 'application/postscript', exec: '' },
+    { name: 'rtf', group: 'docums', acp: 'application/rtf', exec: 'word' },
+    { name: 'icc', group: '', acp: 'application/vnd.iccprofile', exec: '' },
+    { name: 'asf', group: '', acp: 'application/vnd.ms-asf', exec: '', msg: 'asf的acp可能為application/vnd.ms-asf或audio/x-ms-asf或video/x-ms-asf' },
+    { name: 'cab', group: '', acp: 'application/vnd.ms-cab-compressed', exec: '' },
+    { name: 'eot', group: '', acp: 'application/vnd.ms-fontobject', exec: '' },
+    { name: 'chm', group: '', acp: 'application/vnd.ms-htmlhelp', exec: '' },
+    { name: 'pst', group: '', acp: 'application/vnd.ms-outlook', exec: '' },
+    { name: 'odp', group: 'docums', acp: 'application/vnd.oasis.opendocument.presentation', exec: 'powerpoint' },
+    { name: 'ods', group: 'docums', acp: 'application/vnd.oasis.opendocument.spreadsheet', exec: 'excel' },
+    { name: 'odt', group: 'docums', acp: 'application/vnd.oasis.opendocument.text', exec: 'word' },
+    { name: 'ppt', group: 'docums', acp: 'application/vnd.ms-powerpoint', exec: 'powerpoint' },
+    { name: 'pptx', group: 'docums', acp: 'application/vnd.openxmlformats-officedocument.presentationml.presentation', exec: 'powerpoint' },
+    { name: 'xls', group: 'docums', acp: 'application/vnd.ms-excel', exec: 'excel' },
+    { name: 'xlsx', group: 'docums', acp: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', exec: 'excel' },
+    { name: 'doc', group: 'docums', acp: 'application/msword', exec: 'word' },
+    { name: 'docx', group: 'docums', acp: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', exec: 'word' },
+    { name: 'skp', group: '', acp: 'application/vnd.sketchup.skp', exec: '' },
+    { name: 'pcap', group: '', acp: 'application/vnd.tcpdump.pcap', exec: '' },
+    { name: 'wasm', group: '', acp: 'application/wasm', exec: '' },
+    { name: 'arrow', group: '', acp: 'application/x-apache-arrow', exec: '' },
+    { name: 'dmg', group: '', acp: 'application/x-apple-diskimage', exec: '' },
+    { name: 'arj', group: '', acp: 'application/x-arj', exec: '' },
+    { name: 'asar', group: '', acp: 'application/x-asar', exec: '' },
+    { name: 'blend', group: '', acp: 'application/x-blender', exec: 'blender' },
+    { name: 'cfb', group: '', acp: 'application/x-cfb', exec: '' },
+    { name: 'cpio', group: '', acp: 'application/x-cpio', exec: '' },
+    { name: 'deb', group: '', acp: 'application/x-deb', exec: '' },
+    { name: 'elf', group: '', acp: 'application/x-elf', exec: '' },
+    { name: 'shp', group: '', acp: 'application/x-esri-shape', exec: '' },
+    { name: 'crx', group: '', acp: 'application/x-google-chrome-extension', exec: '' },
+    { name: 'indd', group: '', acp: 'application/x-indesign', exec: '' },
+    { name: 'macho', group: '', acp: 'application/x-mach-binary', exec: '' },
+    { name: 'mie', group: '', acp: 'application/x-mie', exec: '' },
+    { name: 'mobi', group: '', acp: 'application/x-mobipocket-ebook', exec: '' },
+    { name: 'exe', group: '', acp: 'application/x-msdownload', exec: '' },
+    { name: 'nes', group: '', acp: 'application/x-nintendo-nes-rom', exec: '' },
+    { name: 'parquet', group: '', acp: 'application/x-parquet', exec: '' },
+    { name: 'rpm', group: '', acp: 'application/x-rpm', exec: '' },
+    { name: 'swf', group: '', acp: 'application/x-shockwave-flash', exec: '' },
+    { name: 'sqlite', group: '', acp: 'application/x-sqlite3', exec: '' },
+    { name: 'xpi', group: '', acp: 'application/x-xpinstall', exec: '' },
+    { name: 'xz', group: '', acp: 'application/x-xz', exec: '' },
+    { name: 'alias', group: '', acp: 'application/x.apple.alias', exec: '' },
+    { name: 'fbx', group: '', acp: 'application/x.autodesk.fbx', exec: '' },
+    { name: 'lnk', group: '', acp: 'application/x.ms.shortcut', exec: '' },
+    { name: 'zst', group: '', acp: 'application/zstd', exec: '' },
+    { name: 'aac', group: 'audio', acp: 'audio/aac', exec: 'audioplayer' },
+    { name: 'aif', group: 'audio', acp: 'audio/aiff', exec: 'audioplayer' },
+    { name: 'amr', group: 'audio', acp: 'audio/amr', exec: 'audioplayer' },
+    { name: 'ape', group: 'audio', acp: 'audio/ape', exec: 'audioplayer' },
+    { name: 'mid', group: 'audio', acp: 'audio/midi', exec: 'audioplayer' },
+    { name: 'm4b', group: 'audio', acp: 'audio/mp4', exec: 'audioplayer' },
+    { name: 'f4a', group: 'audio', acp: 'audio/mp4', exec: 'audioplayer' },
+    { name: 'f4b', group: 'audio', acp: 'audio/mp4', exec: 'audioplayer' },
+    { name: 'mp3', group: 'audio', acp: 'audio/mpeg', exec: 'audioplayer' },
+    { name: 'mp2', group: 'audio', acp: 'audio/mpeg', exec: 'audioplayer' },
+    { name: 'mp1', group: 'audio', acp: 'audio/mpeg', exec: 'audioplayer' },
+    { name: 'oga', group: 'audio', acp: 'audio/ogg', exec: 'audioplayer' },
+    { name: 'spx', group: 'audio', acp: 'audio/ogg', exec: 'audioplayer' },
+    { name: 'ogg', group: 'audio', acp: 'audio/ogg', exec: 'audioplayer' },
+    { name: 'opus', group: 'audio', acp: 'audio/opus', exec: 'audioplayer' },
+    { name: 'qcp', group: 'audio', acp: 'audio/qcelp', exec: 'audioplayer' },
+    { name: 'ac3', group: 'audio', acp: 'audio/vnd.dolby.dd-raw', exec: 'audioplayer' },
+    { name: 'wav', group: 'audio', acp: 'audio/wav', exec: 'audioplayer' },
+    { name: 'wv', group: 'audio', acp: 'audio/wavpack', exec: 'audioplayer' },
+    { name: 'dsf', group: 'audio', acp: 'audio/x-dsf', exec: 'audioplayer' },
+    { name: 'flac', group: 'audio', acp: 'audio/x-flac', exec: 'audioplayer' },
+    { name: 'it', group: 'audio', acp: 'audio/x-it', exec: 'audioplayer' },
+    { name: 'm4a', group: 'audio', acp: 'audio/x-m4a', exec: 'audioplayer' },
+    { name: 'mpc', group: 'audio', acp: 'audio/x-musepack', exec: 'audioplayer' },
+    { name: 's3m', group: 'audio', acp: 'audio/x-s3m', exec: 'audioplayer' },
+    { name: 'voc', group: 'audio', acp: 'audio/x-voc', exec: 'audioplayer' },
+    { name: 'xm', group: 'audio', acp: 'audio/x-xm', exec: 'audioplayer' },
+    { name: 'otf', group: '', acp: 'font/otf', exec: '' },
+    { name: 'ttf', group: '', acp: 'font/ttf', exec: '' },
+    { name: 'woff', group: '', acp: 'font/woff', exec: '' },
+    { name: 'woff2', group: '', acp: 'font/woff2', exec: '' },
+    { name: 'apng', group: 'image', acp: 'image/apng', exec: 'imageviwer' },
+    { name: 'avif', group: 'image', acp: 'image/avif', exec: 'imageviwer' },
+    { name: 'bmp', group: 'image', acp: 'image/bmp', exec: 'imageviwer' },
+    { name: 'bpg', group: 'image', acp: 'image/bpg', exec: 'imageviwer' },
+    { name: 'flif', group: 'image', acp: 'image/flif', exec: 'imageviwer' },
+    { name: 'gif', group: 'image', acp: 'image/gif', exec: 'imageviwer' },
+    { name: 'heic', group: 'image', acp: 'image/heif', exec: 'imageviwer' },
+    { name: 'icns', group: 'image', acp: 'image/icns', exec: 'imageviwer' },
+    { name: 'j2c', group: 'image', acp: 'image/j2c', exec: 'imageviwer' },
+    { name: 'jls', group: 'image', acp: 'image/jls', exec: 'imageviwer' },
+    { name: 'jp2', group: 'image', acp: 'image/jp2', exec: 'imageviwer' },
+    { name: 'jpg', group: 'image', acp: 'image/jpeg', exec: 'imageviwer' },
+    { name: 'jpm', group: 'image', acp: 'image/jpm', exec: 'imageviwer' },
+    { name: 'jpx', group: 'image', acp: 'image/jpx', exec: 'imageviwer' },
+    { name: 'jxl', group: 'image', acp: 'image/jxl', exec: 'imageviwer' },
+    { name: 'ktx', group: 'image', acp: 'image/ktx', exec: 'imageviwer' },
+    { name: 'mj2', group: 'image', acp: 'image/mj2', exec: 'imageviwer' },
+    { name: 'png', group: 'image', acp: 'image/png', exec: 'imageviwer' },
+    { name: 'tif', group: 'image', acp: 'image/tiff', exec: 'imageviwer' },
+    { name: 'psd', group: 'image', acp: 'image/vnd.adobe.photoshop', exec: 'imageviwer' },
+    { name: 'dwg', group: 'image', acp: 'image/vnd.dwg', exec: 'imageviwer' },
+    { name: 'jxr', group: 'image', acp: 'image/vnd.ms-photo', exec: 'imageviwer' },
+    { name: 'webp', group: 'image', acp: 'image/webp', exec: 'imageviwer' },
+    { name: 'dng', group: 'image', acp: 'image/x-adobe-dng', exec: 'imageviwer' },
+    { name: 'cr2', group: 'image', acp: 'image/x-canon-cr2', exec: 'imageviwer' },
+    { name: 'cr3', group: 'image', acp: 'image/x-canon-cr3', exec: 'imageviwer' },
+    { name: 'raf', group: 'image', acp: 'image/x-fujifilm-raf', exec: 'imageviwer' },
+    { name: 'ico', group: 'image', acp: 'image/x-icon', exec: 'imageviwer' },
+    { name: 'cur', group: 'image', acp: 'image/x-icon', exec: 'imageviwer' },
+    { name: 'nef', group: 'image', acp: 'image/x-nikon-nef', exec: 'imageviwer' },
+    { name: 'orf', group: 'image', acp: 'image/x-olympus-orf', exec: 'imageviwer' },
+    { name: 'rw2', group: 'image', acp: 'image/x-panasonic-rw2', exec: 'imageviwer' },
+    { name: 'arw', group: 'image', acp: 'image/x-sony-arw', exec: 'imageviwer' },
+    { name: 'xcf', group: 'image', acp: 'image/x-xcf', exec: 'imageviwer' },
+    { name: '3mf', group: '', acp: 'model/3mf', exec: '' },
+    { name: 'glb', group: '', acp: 'model/gltf-binary', exec: '' },
+    { name: 'stl', group: '', acp: 'model/stl', exec: '' },
+    { name: 'vtp', group: '', acp: 'model/vtp', exec: '' },
+    { name: 'vtk', group: '', acp: 'model/vtk', exec: '' },
+    { name: 'vtu', group: '', acp: 'model/vtu', exec: '' },
+    { name: 'vti', group: '', acp: 'model/vti', exec: '' },
+    { name: 'vts', group: '', acp: 'model/vts', exec: '' },
+    { name: 'vtr', group: '', acp: 'model/vtr', exec: '' },
+    { name: 'ics', group: '', acp: 'text/calendar', exec: '' },
+    { name: 'vcf', group: '', acp: 'text/vcard', exec: '' },
+    { name: '3gp', group: 'video', acp: 'video/3gpp', exec: 'videoplayer' },
+    { name: '3g2', group: 'video', acp: 'video/3gpp2', exec: 'videoplayer' },
+    { name: 'm2p', group: 'video', acp: 'video/MP2P', exec: 'videoplayer' },
+    { name: 'vob', group: 'video', acp: 'video/MP2P', exec: 'videoplayer' },
+    { name: 'sub', group: 'video', acp: 'video/MP2P', exec: 'videoplayer', msg: '與字幕檔衝突' },
+    { name: 'mts', group: 'video', acp: 'video/mp2t', exec: 'videoplayer' },
+    { name: 'm4p', group: 'video', acp: 'video/mp4', exec: 'videoplayer' },
+    { name: 'f4v', group: 'video', acp: 'video/mp4', exec: 'videoplayer' },
+    { name: 'f4p', group: 'video', acp: 'video/mp4', exec: 'videoplayer' },
+    { name: 'mp4', group: 'video', acp: 'video/mp4', exec: 'videoplayer' },
+    { name: 'mpg', group: 'video', acp: 'video/mpeg', exec: 'videoplayer', msg: 'mpg可能為mpeg或video/MP1S或video/MP2S' },
+    { name: 'ogv', group: 'video', acp: 'video/ogg', exec: 'videoplayer' },
+    { name: 'ogm', group: 'video', acp: 'video/ogg', exec: 'videoplayer' },
+    { name: 'mov', group: 'video', acp: 'video/quicktime', exec: 'videoplayer' },
+    { name: 'avi', group: 'video', acp: 'video/vnd.avi', exec: 'videoplayer' },
+    { name: 'webm', group: 'video', acp: 'video/webm', exec: 'videoplayer' },
+    { name: 'flv', group: 'video', acp: 'video/x-flv', exec: 'videoplayer' },
+    { name: 'm4v', group: 'video', acp: 'video/x-m4v', exec: 'videoplayer' },
+    { name: 'mkv', group: 'video', acp: 'video/x-matroska', exec: 'videoplayer' },
+]
+
+
+//R-FILETYPE-01 規則 5: 修前至今既有項目唯一允許之差異(依 name 對應欄位新值)，上方基準表不得改動
+export const changes = {
+    heic: { acp: 'image/heic' },
+}
+
+
+//基準表套用 changes 後之既有項目期望值
+export function applyChanges(rows) {
+    return rows.map((r) => ({ ...r, ...(Object.prototype.hasOwnProperty.call(changes, r.name) ? changes[r.name] : null) }))
+}

package/test/treeObj.test.mjs

@@ -2,6 +2,125 @@ import assert from 'assert'
 import treeObj from '../src/treeObj.mjs'
 
 
+describe(`treeObj 偽稱Array之物件視為物件(R-OBJ-ITER-01 候選10)`, function() {
+
+    //以Symbol.toStringTag偽稱'Array'之物件(isarr為真而非真陣列), 可寫與不可寫兩種標籤
+    let mkFake = (len, writable) => {
+        let o = { a: 'kept', length: len }
+        if (writable) {
+            o[Symbol.toStringTag] = 'Array'
+        }
+        else {
+            Object.defineProperty(o, Symbol.toStringTag, { value: 'Array' })
+        }
+        return o
+    }
+    let ident = (v) => v
+
+    for (let writable of [true, false]) {
+        let tag = writable ? 'writable' : 'non-writable'
+        for (let len of [0, 2, 1000]) {
+            it(`should keep the keys of a nested object faking Array (${tag} tag, length ${len}) and not turn it into an index array`, function() {
+                let r = treeObj({ child: mkFake(len, writable) }, ident)
+                assert.ok(!Array.isArray(r.child))
+                assert.strict.deepStrictEqual(Object.keys(r.child), ['a', 'length'])
+                assert.strict.strictEqual(r.child.a, 'kept')
+                assert.strict.strictEqual(r.child.length, len)
+            })
+        }
+
+        it(`should call the hook for the keys of an object faking Array (${tag} tag) with the path, as for a plain object`, function() {
+            let m = []
+            treeObj({ child: mkFake(2, writable) }, (value, key, nk) => {
+                m.push({ value, key, nk })
+                return value
+            })
+            let mm = []
+            treeObj({ child: { a: 'kept', length: 2 } }, (value, key, nk) => {
+                mm.push({ value, key, nk })
+                return value
+            })
+            //第0筆為child本身(其value為物件, 比對鍵與路徑), 其後為a與length
+            assert.strict.deepStrictEqual(m.map((v) => [v.key, v.nk]), mm.map((v) => [v.key, v.nk]))
+            assert.strict.deepStrictEqual(m.slice(1).map((v) => v.value), ['kept', 2])
+        })
+
+        it(`should handle an object faking Array (${tag} tag) at the root as an object`, function() {
+            let r = treeObj(mkFake(2, writable), ident)
+            assert.ok(!Array.isArray(r))
+            assert.strict.deepStrictEqual(Object.keys(r), ['a', 'length'])
+            assert.strict.strictEqual(r.length, 2)
+        })
+    }
+
+    it(`should keep Symbol keys of an object faking Array with force`, function() {
+        let sym = Symbol('s')
+        let o = mkFake(1, false)
+        o[sym] = 'sv'
+        let r = treeObj({ child: o }, ident, { force: true })
+        assert.strict.strictEqual(r.child[sym], 'sv')
+        assert.strict.strictEqual(r.child.a, 'kept')
+    })
+
+    it(`should still turn real arrays (including Array subclasses and holes) into arrays by index`, function() {
+        class Arr2 extends Array {}
+        let r = treeObj({ a: [1, [2, 3]], b: Arr2.from([4, 5]), c: [, 6] }, ident) // eslint-disable-line no-sparse-arrays
+        assert.ok(Array.isArray(r.a) && Array.isArray(r.a[1]) && Array.isArray(r.b) && Array.isArray(r.c))
+        assert.strict.deepStrictEqual(r.a, [1, [2, 3]])
+        assert.strict.deepStrictEqual([...r.b], [4, 5])
+        assert.strict.deepStrictEqual(r.c, [undefined, 6])
+    })
+
+    it(`should visit the non-enumerable string keys of an object faking Array like those of a plain object (own property names)`, function() {
+        let mk = (fake) => {
+            let o = { a: 1 }
+            Object.defineProperty(o, 'h', { value: 2, enumerable: false })
+            if (fake) {
+                Object.defineProperty(o, Symbol.toStringTag, { value: 'Array' })
+            }
+            return o
+        }
+        let keysOf = (o) => {
+            let m = []
+            treeObj({ child: o }, (value, key) => {
+                m.push(key)
+                return value
+            })
+            return m
+        }
+        assert.strict.deepStrictEqual(keysOf(mk(false)), ['child', 'a', 'h'])
+        assert.strict.deepStrictEqual(keysOf(mk(true)), ['child', 'a', 'h'])
+    })
+
+    for (let tag of ['Foo', 'Object', 'Arguments']) {
+        it(`should still traverse a real array with another Symbol.toStringTag (${tag}) by index, nested and at the root`, function() {
+            let mk = () => Object.defineProperty([1, 2], Symbol.toStringTag, { value: tag })
+            let m = []
+            let r = treeObj({ child: mk() }, (value, key, nk) => {
+                m.push([key, nk.length])
+                return value
+            })
+            assert.ok(Array.isArray(r.child))
+            assert.strict.deepStrictEqual(r.child, [1, 2])
+            assert.strict.deepStrictEqual(m, [['child', 0], [0, 1], [1, 1]])
+            let m2 = []
+            let r2 = treeObj(mk(), (value, key) => {
+                m2.push(key)
+                return value
+            })
+            assert.ok(Array.isArray(r2))
+            assert.strict.deepStrictEqual(r2, [1, 2])
+            assert.strict.deepStrictEqual(m2, [0, 1])
+        })
+    }
+
+    it(`should treat an object with a numeric length key as an ordinary object`, function() {
+        let r = treeObj({ child: { a: 'kept', length: 2 } }, ident)
+        assert.strict.deepStrictEqual(r, { child: { a: 'kept', length: 2 } })
+    })
+
+})
+
 describe(`treeObj`, function() {
     let data = {
         a: 123,

package/test/u8arr2obj.test.mjs

@@ -220,13 +220,21 @@ describe(`u8arr2obj`, function() {
         assert.strict.deepStrictEqual(r.msg.indexOf('TypeError') === 0, true, `msg 應為型別錯誤, got ${r.msg}`)
     })
 
-    it(`should return { state: 'error', msg: <SyntaxError> } when input a corrupted packet with returnWithStateAndMsg`, function() {
-        let r = u8arr2obj(new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8, 9]), { returnWithStateAndMsg: true })
+    it(`should return { state: 'error', msg: <SyntaxError> } when input a packet whose header block is not valid JSON with returnWithStateAndMsg`, function() {
+        //標頭長度為合法之3, 其後3位元組'abc'不是合法JSON(分塊資訊須為JSON陣列)
+        let bad = new Uint8Array([0x40, 0x08, 0, 0, 0, 0, 0, 0, 97, 98, 99])
+        let r = u8arr2obj(bad, { returnWithStateAndMsg: true })
         assert.strict.deepStrictEqual(Object.keys(r).sort(), ['msg', 'state'])
         assert.strict.deepStrictEqual(r.state, 'error')
         assert.strict.deepStrictEqual(r.msg.indexOf('SyntaxError') === 0, true, `msg 應為解析錯誤, got ${r.msg}`)
     })
 
+    it(`should return { state: 'error', msg: 'invalid pks, head length …' } when the head length is not a non-negative integer with returnWithStateAndMsg (R-OBJ-ITER-01 規則6)`, function() {
+        //標頭前8位元組以大端double讀取: [1..8]為極小非整數, 修前由JSON.parse失敗(SyntaxError)擋下, 現於分割前即拒收
+        let r = u8arr2obj(new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8, 9]), { returnWithStateAndMsg: true })
+        assert.strict.deepStrictEqual(r, { state: 'error', msg: 'invalid pks, head length must be a non-negative integer not exceeding the packet' })
+    })
+
     it(`should return { state: 'error', msg: 'stru8arr2obj: <SyntaxError>' } when the inner stru8arr2obj fails with returnWithStateAndMsg`, function() {
         //內部呼叫之錯誤須前置來源函數名, 供辨識是哪一步出錯
         let bad = obj2u8arr({ a: 1 })
@@ -288,6 +296,103 @@ describe(`u8arr2obj 非Error拋出值(R-CODEC-ERR-01之2)`, function() {
 
 })
 
+describe(`u8arr2obj 標頭長度lenHead須為非負整數且不逾封包(R-OBJ-ITER-01 規則6)`, function() {
+
+    //標頭前8位元組為大端double: 分塊資訊區之位元組數; 來自封包(不可信), 小數與負數經slice被靜默截斷或自尾端算而得同一分割(非正規編碼), 須拒收
+    let INV = 'invalid pks, head length must be a non-negative integer not exceeding the packet'
+    let packet = obj2u8arr({ a: 1, b: new Uint8Array([7, 8, 9]) })
+    let good = new DataView(packet.buffer, packet.byteOffset, 8).getFloat64(0, false)
+    let others = packet.length - 8
+    let withHead = (v) => {
+        let q = packet.slice()
+        new DataView(q.buffer, q.byteOffset, 8).setFloat64(0, v, false)
+        return q
+    }
+
+    it(`should decode the canonical packet (precondition: the head length is a positive integer inside the packet)`, function() {
+        assert.ok(Number.isInteger(good) && good > 0 && good < others, `good=${good} others=${others}`)
+        let r = u8arr2obj(packet, { returnWithStateAndMsg: true })
+        assert.strict.deepStrictEqual(r.state, 'success')
+        assert.strict.deepStrictEqual(r.msg.a, 1)
+        assert.strict.deepStrictEqual([...r.msg.b], [7, 8, 9])
+    })
+
+    let rejects = [
+        ['a fraction (head length + 0.5)', good + 0.5],
+        ['a fraction (head length + 0.99)', good + 0.99],
+        ['a negative number counted from the end that would give the same split', -(others - good)],
+        ['-1', -1],
+        ['NaN', NaN],
+        ['Infinity', Infinity],
+        ['-Infinity', -Infinity],
+        ['a number above the packet size (size + 1)', others + 1],
+        ['2^53', 2 ** 53],
+        ['1e308', 1e308],
+    ]
+    for (let [name, v] of rejects) {
+        it(`should reject ${name} before splitting the packet: strict mode gives { state: 'error', msg: INV }, loose mode gives {}`, function() {
+            assert.strict.deepStrictEqual(u8arr2obj(withHead(v), { returnWithStateAndMsg: true }), { state: 'error', msg: INV })
+            assert.strict.deepStrictEqual(u8arr2obj(withHead(v)), {})
+        })
+    }
+
+    //整數且不逾封包者通過標頭檢查, 後續由JSON解析或分塊資訊檢查失敗(不是INV)
+    let passesHeadCheck = [
+        ['0', 0],
+        ['-0', -0],
+        ['head length - 1', good - 1],
+        ['head length + 1', good + 1],
+        ['the packet size (all is header)', others],
+    ]
+    for (let [name, v] of passesHeadCheck) {
+        it(`should pass the head length check for ${name} and fail later as a corrupted packet, not by the head length rule`, function() {
+            let r = u8arr2obj(withHead(v), { returnWithStateAndMsg: true })
+            assert.strict.deepStrictEqual(r.state, 'error')
+            assert.ok(r.msg !== INV, `msg=${r.msg}`)
+        })
+    }
+
+    for (let n of [0, 1, 3, 7]) {
+        it(`should reject a packet shorter than the 8-byte head (${n} bytes) by the head length rule`, function() {
+            let r = u8arr2obj(new Uint8Array(n).fill(1), { returnWithStateAndMsg: true })
+            assert.strict.deepStrictEqual(r, { state: 'error', msg: INV })
+        })
+    }
+
+    it(`should reject an invalid head length before slicing the head block (only the head and the rest are sliced)`, function() {
+        //來自封包之長度須先驗證才可用於切分; 以計次之Uint8Array子類別確認拒收時只切了標頭8位元組與其餘兩次
+        let n = 0
+        class CountU8 extends Uint8Array {
+            slice(...a) {
+                n++
+                return new CountU8(super.slice(...a))
+            }
+        }
+        let u = new CountU8(withHead(good + 0.5))
+        n = 0
+        assert.strict.deepStrictEqual(u8arr2obj(u, { returnWithStateAndMsg: true }), { state: 'error', msg: INV })
+        assert.strict.strictEqual(n, 2)
+        n = 0
+        let ok = u8arr2obj(new CountU8(packet), { returnWithStateAndMsg: true })
+        assert.strict.strictEqual(ok.state, 'success')
+        assert.ok(n >= 4, `n=${n}`)
+    })
+
+    it(`should decode the same packet when the head length is an exact integer written in the other valid ways (handmade packet with head length 3)`, function() {
+        let enc = new TextEncoder()
+        let body = enc.encode('[7]{"a":1}')
+        let q = new Uint8Array(8 + body.length)
+        q.set(body, 8)
+        new DataView(q.buffer, 0, 8).setFloat64(0, 3, false)
+        assert.strict.deepStrictEqual(u8arr2obj(q, { returnWithStateAndMsg: true }), { state: 'success', msg: { a: 1 } })
+        new DataView(q.buffer, 0, 8).setFloat64(0, 3.9, false)
+        assert.strict.deepStrictEqual(u8arr2obj(q, { returnWithStateAndMsg: true }), { state: 'error', msg: INV })
+        new DataView(q.buffer, 0, 8).setFloat64(0, -7, false)
+        assert.strict.deepStrictEqual(u8arr2obj(q, { returnWithStateAndMsg: true }), { state: 'error', msg: INV })
+    })
+
+})
+
 describe(`u8arr2obj 使用端物件之迭代(R-OBJ-ITER-01)`, function() {
 
     //封包來自網路/檔案, 標頭內之分塊資訊不可信(規則6): 須為真陣列、各項為非負有限整數、總量不逾封包資料區, 否則失敗回報, 不依其內容迭代或配置記憶體

package/toolfp/dist/wsemip.umd.js

@@ -1,5 +1,5 @@
 /*!
- * wsemip v1.9.21
+ * wsemip v1.9.23
  * (c) 2018-2021 yuda-lyu(semisphere)
  * Released under the MIT License.
  */

package/toolparfor/dist/wpf.umd.js

@@ -1,5 +1,5 @@
 /*!
- * wpf v1.9.21
+ * wpf v1.9.23
  * (c) 2018-2021 yuda-lyu(semisphere)
  * Released under the MIT License.
  */

package/toolparfor/dist/wpf_pmSeries.umd.js

@@ -1,5 +1,5 @@
 /*!
- * wpf_pmSeries v1.9.21
+ * wpf_pmSeries v1.9.23
  * (c) 2018-2021 yuda-lyu(semisphere)
  * Released under the MIT License.
  */