wsemi

Members

(static) execCliCore

Description:

• execCli系列函數之共用核心, 提供可獨立使用之函數: buildSpawnArgs(將命令轉為Windows安全之spawn參數)與buildSpawnEnv(建立子進程環境變數)

  Unit Test: Github

Source:

• execCliCore.mjs, line 433

Example

//need test in nodejs

let { buildSpawnArgs, buildSpawnEnv } = execCliCore

//buildSpawnArgs, Windows下npm全域命令(.cmd)會被解析為以node執行其JS入口
let sp = buildSpawnArgs('node', ['-e', 'console.log(1)'])
console.log(sp)
// => { file: 'C:\\...\\node.exe', args: [ '-e', 'console.log(1)' ], opt: {} } (Windows)
// => { file: 'node', args: [ '-e', 'console.log(1)' ], opt: {} } (非Windows)

//spawn
import { spawn } from 'child_process'
let proc = spawn(sp.file, sp.args, { stdio: 'pipe', windowsHide: true, ...sp.opt })

//buildSpawnEnv, 以process.env為底併入額外變數, 不動本進程
let env = buildSpawnEnv({ API_KEY: 'abc' })
console.log(env.API_KEY, env.PYTHONIOENCODING, process.env.API_KEY)
// => abc utf-8 undefined

Methods

(static) ab2blob(ab, optopt) → {Blob|Object}

Description:

• ArrayBuffer資料轉Blob資料

  Unit Test: Github

Source:

• ab2blob.mjs, line 28

Example

need test in browser

let ab = (new Uint8Array([66, 97, 115])).buffer
let bb = ab2blob(ab)
console.log(bb)
// => Blob {size: 3, type: ""}

console.log(ab2blob('abc', { returnWithStateAndMsg: true }))
// => { state: 'error', msg: 'invalid ab' }

Parameters:

Returns:

Type

Blob | Object

(static) ab2u8arr(ab, optopt) → {Unit8Array|Object}

Description:

• ArrayBuffer轉Unit8Array

  Unit Test: Github

Source:

• ab2u8arr.mjs, line 23

Example

let ab = (new Uint8Array([66, 97, 115])).buffer
console.log(ab2u8arr(ab))
// => new Uint8Array([66, 97, 115])

Parameters:

Returns:

Type

Unit8Array | Object

(static) addExcelWorksheetFromData(wb, data, sheetNameopt) → {Object}

Description:

• 由數據陣列轉成為Excel的Worksheet物件並添加至Workbook物件

  Workbook物件格式為{ sheets: [{ name, rows }] }(見createExcelWorkbook)，數據陣列可為二維陣列(mat)或物件陣列(ltdt)，見getExcelWorksheetFromData

  Unit Test: Github

Source:

• addExcelWorksheetFromData.mjs, line 36

Example

let data = [
    ['a', '123', 456],
    [null, 'abc123', '', 111.222333],
]

let wb = createExcelWorkbook()
console.log(wb)
// => { sheets: [] }

wb = addExcelWorksheetFromData(wb, data, 'tester')
console.log(JSON.stringify(wb))
// => {"sheets":[{"rows":[["a","123",456],[null,"abc123","",111.222333]],"name":"tester"}]}

Parameters:

Returns:

Type

Object

(static) addMonth(g, n) → {String}

Description:

• 輸入年月並增加/減少月份數量

  Unit Test: Github

Source:

• addMonth.mjs, line 23

Example

console.log(addMonth('2019-01', 2))
// => '2019-03'

console.log(addMonth('2018-12', -1))
// => '2018-11'

Parameters:

Returns:

Type

String

(static) aes2str(str, key, base64opt, optopt) → {String|Object}

Description:

• AES字串轉一般字串 為str2aes之解密函數，使用AES-128-CBC解密，字串採用PKCS#7填充 str與base64須與加密時str2aes所用之設定相同，否則解不出原文而回傳空字串

  Unit Test: Github

Source:

• aes2str.mjs, line 34

Example

let str = '53616c7465645f5f47214797ac01bc03cceb69ebced4948501ab94ca9644a6dfd277456aead4432cb9c9d74c38c42c79'
let key = '1234567890abcdefghijk'
console.log(aes2str(str, key))
// => 'test中文abcdefghijklmn'

Parameters:

Returns:

Type

String | Object

(static) alive(timeAliveopt, timeDetectopt) → {Object}

Description:

• 偵測單元是否在線

  Unit Test: Github

Source:

• alive.mjs, line 120

Example

async function topAsync() {

    function test1() {
        return new Promise((resolve, reject) => {
            let ms = []

            let oAL = alive({ timeAlive: 1500 })
            let t = Date.now()

            let a = { data: 123 }
            let b = { data: '34.56' }

            setTimeout(() => {
                console.log(parseInt((Date.now() - t)) + 'ms', 'trigger a1')
                oAL.trigger('a', a)
            }, 500)

            setTimeout(() => {
                console.log(parseInt((Date.now() - t)) + 'ms', 'trigger a2')
                oAL.trigger('a', a)
            }, 1900)

            setTimeout(() => {
                console.log(parseInt((Date.now() - t)) + 'ms', 'trigger b1')
                oAL.trigger('b', b)
            }, 1000)

            setTimeout(() => {
                console.log(parseInt((Date.now() - t)) + 'ms', 'trigger b2')
                oAL.trigger('b', b)
            }, 3000)

            oAL.on('message', function({ eventName, key, data, now }) {
                console.log(parseInt((Date.now() - t)) + 'ms', { eventName, key, data, now })
                ms.push(eventName + '|' + key)
            })

            setTimeout(() => {
                resolve(ms)
            }, 5000)

        })
    }
    console.log('test1')
    let r1 = await test1()
    console.log(JSON.stringify(r1))
    // test1
    // 503ms trigger a1
    // 508ms { eventName: 'enter', key: 'a', data: { data: 123 }, now: 1 }
    // 1001ms trigger b1
    // 1003ms { eventName: 'enter', key: 'b', data: { data: '34.56' }, now: 2 }
    // 1901ms trigger a2
    // 2523ms { eventName: 'leave', key: 'b', data: { data: '34.56' }, now: 1 }
    // 3002ms trigger b2
    // 3004ms { eventName: 'enter', key: 'b', data: { data: '34.56' }, now: 2 }
    // 3430ms { eventName: 'leave', key: 'a', data: { data: 123 }, now: 1 }
    // 4544ms { eventName: 'leave', key: 'b', data: { data: '34.56' }, now: 0 }
    // ["enter|a","enter|b","leave|b","enter|b","leave|a","leave|b"]

    function test2() {
        return new Promise((resolve, reject) => {
            let ms = []

            let oAL = alive({ timeAlive: 1500 })

            oAL.on('message', function({ eventName, key }) {
                ms.push(eventName + '|' + key)
            })

            oAL.trigger('a', { data: 123 })

            setTimeout(() => {
                oAL.trigger('b', { data: '34.56' })
                let r = oAL.clear() //b剛trigger尚未發出enter, 故只回傳a, 且b之enter不再發出
                ms.push('clear|' + r.map((v) => v.key).join(','))
            }, 500)

            setTimeout(() => {
                resolve(ms)
            }, 2500)

        })
    }
    console.log('test2')
    let r2 = await test2()
    console.log(JSON.stringify(r2))
    // test2
    // ["enter|a","clear|a"]

}
topAsync().catch(() => {})

Parameters:

Returns:

Type

Object

(static) arr2dt(keys, valuesopt) → {Object}

Description:

• 結合keys與values成為物件

  Unit Test: Github

Source:

• arr2dt.mjs, line 39

Example

console.log(arr2dt(['a', 'b']))
// => { 'a': '', 'b': '' }

console.log(arr2dt(['a', 'b'], 'xyz'))
// => { a: 'xyz', b: 'xyz' }

console.log(arr2dt(['a', 'b'], null))
// => { a: null, b: null }

console.log(arr2dt(['a', 'b'], [12.3, '456a']))
// => { 'a': 12.3, 'b': '456a' }

console.log(arr2dt(['a', 'b'], [null, '456a']))
// => { 'a': null, 'b': '456a' }

console.log(arr2dt(['a', 'b'], [12.3]))
// => {}

console.log(arr2dt(['a', 'b'], {}))
// => { a: {}, b: {} }

Parameters:

Returns:

Type

Object

(static) arrAccum(vec) → {Array}

Description:

• 回傳累加後陣列

  Unit Test: Github

Source:

• arrAccum.mjs, line 20

Example

console.log(arrAccum([1, 2, 3, 4]))
// => [1, 3, 6, 10]

Parameters:

Returns:

Type

Array

(static) arrAdd(arguments) → {Array}

Description:

• 各陣列內元素相加，可輸入n個同長度陣列，若需輸入之陣列長度不同則回傳空陣列

  Unit Test: Github

Source:

• arrAdd.mjs, line 64

Example

let v1 = [1, 2, 3, 4]
let v2 = [0.1, 0.1, 0.1, 0.1]
let v3 = [11, 22, 33, 44]

console.log(arrAdd(v1, v2))
// => [ 1.1, 2.1, 3.1, 4.1 ]

console.log(arrAdd(v1, v2, v3))
// => [ 12.1, 24.1, 36.1, 48.1 ]

Parameters:

Returns:

Type

Array

(static) arrAt(vall, istart, iendopt) → {Array}

Description:

• 由vall陣列提取指定欄位(或欄位範圍)之資料 若istart與iend有效, 提取istart~iend欄位 若僅istart有效, 提取istart欄位

  Unit Test: Github

Source:

• arrAt.mjs, line 29

Example

console.log(arrAt([1, 2, 3, '4', 5, 'abc'], 1))
// => [2]

console.log(arrAt([1, 2, 3, '4', 5, 'abc'], 1, 4))
// => [2, 3, '4', 5]

Parameters:

Returns:

Type

Array

(static) arrDiff(strOld, strNew, optopt) → {Object}

Description:

• 比對新舊陣列差異處

  Unit Test: Github

Source:

• arrDiff.mjs, line 512

Example

let r
let arrOld
let arrNew

if (true) {
    arrOld = [-0.529408622, 0.839882385, 0.663059856, 0.49047221, 123, 0.395763265, 0.866151835]
    arrNew = [-0.529408622, 0.1839882385, 0.663059856, 0.49047221, 0.395763265, 45.6, 0.866151835]
    r = arrDiff(arrOld, arrNew) //因第[5](0.395763265)元素會往前到[4]去, diff會偵測到並視為前面刪除(123)而後面加入(45.6), 故解析後長度會由7變成8
    console.log(r)
    // => {
    //   diff: [
    //     { count: 1, added: false, removed: false, value: '-0.529408622\n' },
    //     { count: 1, added: false, removed: true, value: '0.839882385\n' },
    //     { count: 1, added: true, removed: false, value: '0.1839882385\n' },
    //     {
    //       count: 2,
    //       added: false,
    //       removed: false,
    //       value: '0.663059856\n0.49047221\n'
    //     },
    //     { count: 1, added: false, removed: true, value: '123\n' },
    //     { count: 1, added: false, removed: false, value: '0.395763265\n' },
    //     { count: 1, added: true, removed: false, value: '45.6\n' },
    //     { count: 1, added: false, removed: false, value: '0.866151835\n' }
    //   ],
    //   dfs: [
    //     { p: '', k: 0, vo: '-0.529408622', vn: '' },
    //     { p: 'modify', k: 1, vo: '0.839882385', vn: '0.1839882385' },
    //     { p: '', k: 2, vo: '0.663059856', vn: '' },
    //     { p: '', k: 3, vo: '0.49047221', vn: '' },
    //     { p: 'remove', k: 4, vo: '123', vn: '' },
    //     { p: '', k: 5, vo: '0.395763265', vn: '' },
    //     { p: 'add', k: 6, vo: '45.6', vn: '' },
    //     { p: '', k: 7, vo: '0.866151835', vn: '' }
    //   ]
    // }
}

if (true) {
    arrOld = [
        [1, 0.974848293, 0.791303871, 0.716898185, 0.506002098, 0.137888903, 0.626724085],
        [2, -0.529408622, 0.839882385, 0.663059856, 0.49047221, 123, 0.395763265, 0.866151835],
        [3, -0.10320217, 0.475514539, 0.969205779, 0.711250309, 0.153847069, 0.410092395],
        [4, -0.121479865, 0.486179086, 0.481023842, 0.467410582, 0.42602231, 0.849701641],
        [5, 0.757346003, 0.697242433, 0.67532802, 0.174644416, 0.045652267, 0.397104668],
        [6, 0.663032731, 0.259252779, 0.566177431, 0.679637706, 0.377814487, 0.400248119],
        [7, 0.72721374, 0.263793391, 0.167895215, 0.794808602, 0.107070584, 0.011822872],
        [8, 0.247416664, 0.360426795, 0.014346373, 0.000469616, 0.4082693, 0.913806611],
        [9, 0.345880037, 0.167996664, 0.711054429, 0.363177921, 0.206849994, 0.636855344],
        [10, 0.576739457, 0.324665077, 0.973218005, 0.883927423, 0.176906125, 0.20087887],
        [11, 1.2],
        [12, 23.5],
        [13, 0.504421248, 0.984003751, 0.32549507, 0.987090751, 0.192745589, 0.735133561],
        [14, 0.273214614, 0.083431884, 0.565146092, 0.935388666, 0.637675154, 0.523815661],
    ]
    arrNew = [
        [1, 0.974848293, 0.791303871, 0.716898185, 0.506002098, 0.137888903, 0.626724085],
        [2, -0.529408622, 0.1839882385, 0.663059856, 0.49047221, 0.395763265, 45.6, 0.866151835],
        [3, -0.10320217, 0.475514539, 0.969205779, 0.711250309, 0.153847069, 0.410092395],
        [4, -0.121479865, 0.486179086, 0.481023842, 0.467410582, 0.42602231, 0.849701641],
        [5, 0.757346003, 0.697242433, 0.67532802, 0.174644416, 0.045652267, 0.397104668],
        [7, 0.72721374, 0.263793391, 0.167895215, 0.794808602, 0.107070584, 0.011822872],
        [8, 0.247416664, 0.360426795, 0.014346373, 0.000469616, 0.4082693, 0.913806611],
        [9, 0.345880037, 0.167996664, 0.711054429, 0.363173478, 0.636855344],
        [10, 0.576739457, 0.324665077, 0.973218005, 0.883927423, 0.176906125, 0.20087887],
        [13, 0.504421248, 0.984003751, 0.32549507, 0.987090751, 0.192745589, 0.735133561],
        [14, 0.273214614, 0.083431884, 0.565146092, 0.935388666, 0.637675154, 0.523815661],
        ['n1', 0.944492151, 0.89950443, 0.182709318, 0.892820757, 0.709746901, 0.097385354],
        ['n2', 0.769805921, 0.061355308, 0.314826137, 0.855857651, 0.653550539, 0.772500773],
        ['n3', 0.158739038, 0.085078711, 0.844664253, 0.21630142, 0.912931341, 0.735138313],
    ]
    r = arrDiff(arrOld, arrNew, { mode: 'matrix' })
    console.log('diff', r.diff)
    // => diff [
    //   {
    //     count: 1,
    //     added: false,
    //     removed: false,
    //     value: '0∶1⟋1∶0.974848293⟋2∶0.791303871⟋3∶0.716898185⟋4∶0.506002098⟋5∶0.137888903⟋6∶0.626724085⟋\n'
    //   },
    //   {
    //     count: 1,
    //     added: false,
    //     removed: true,
    //     value: '0∶2⟋1∶-0.529408622⟋2∶0.839882385⟋3∶0.663059856⟋4∶0.49047221⟋5∶123⟋6∶0.395763265⟋7∶0.866151835⟋\n'
    //   },
    //   {
    //     count: 1,
    //     added: true,
    //     removed: false,
    //     value: '0∶2⟋1∶-0.529408622⟋2∶0.1839882385⟋3∶0.663059856⟋4∶0.49047221⟋5∶0.395763265⟋6∶45.6⟋7∶0.866151835⟋\n'
    //   },
    //   {
    //     count: 3,
    //     added: false,
    //     removed: false,
    //     value: '0∶3⟋1∶-0.10320217⟋2∶0.475514539⟋3∶0.969205779⟋4∶0.711250309⟋5∶0.153847069⟋6∶0.410092395⟋\n' +
    //       '0∶4⟋1∶-0.121479865⟋2∶0.486179086⟋3∶0.481023842⟋4∶0.467410582⟋5∶0.42602231⟋6∶0.849701641⟋\n' +
    //       '0∶5⟋1∶0.757346003⟋2∶0.697242433⟋3∶0.67532802⟋4∶0.174644416⟋5∶0.045652267⟋6∶0.397104668⟋\n'
    //   },
    //   {
    //     count: 1,
    //     added: false,
    //     removed: true,
    //     value: '0∶6⟋1∶0.663032731⟋2∶0.259252779⟋3∶0.566177431⟋4∶0.679637706⟋5∶0.377814487⟋6∶0.400248119⟋\n'
    //   },
    //   {
    //     count: 2,
    //     added: false,
    //     removed: false,
    //     value: '0∶7⟋1∶0.72721374⟋2∶0.263793391⟋3∶0.167895215⟋4∶0.794808602⟋5∶0.107070584⟋6∶0.011822872⟋\n' +
    //       '0∶8⟋1∶0.247416664⟋2∶0.360426795⟋3∶0.014346373⟋4∶0.000469616⟋5∶0.4082693⟋6∶0.913806611⟋\n'
    //   },
    //   {
    //     count: 1,
    //     added: false,
    //     removed: true,
    //     value: '0∶9⟋1∶0.345880037⟋2∶0.167996664⟋3∶0.711054429⟋4∶0.363177921⟋5∶0.206849994⟋6∶0.636855344⟋\n'
    //   },
    //   {
    //     count: 1,
    //     added: true,
    //     removed: false,
    //     value: '0∶9⟋1∶0.345880037⟋2∶0.167996664⟋3∶0.711054429⟋4∶0.363173478⟋5∶0.636855344⟋\n'
    //   },
    //   {
    //     count: 1,
    //     added: false,
    //     removed: false,
    //     value: '0∶10⟋1∶0.576739457⟋2∶0.324665077⟋3∶0.973218005⟋4∶0.883927423⟋5∶0.176906125⟋6∶0.20087887⟋\n'
    //   },
    //   {
    //     count: 2,
    //     added: false,
    //     removed: true,
    //     value: '0∶11⟋1∶1.2⟋\n0∶12⟋1∶23.5⟋\n'
    //   },
    //   {
    //     count: 2,
    //     added: false,
    //     removed: false,
    //     value: '0∶13⟋1∶0.504421248⟋2∶0.984003751⟋3∶0.32549507⟋4∶0.987090751⟋5∶0.192745589⟋6∶0.735133561⟋\n' +
    //       '0∶14⟋1∶0.273214614⟋2∶0.083431884⟋3∶0.565146092⟋4∶0.935388666⟋5∶0.637675154⟋6∶0.523815661⟋\n'
    //   },
    //   {
    //     count: 3,
    //     added: true,
    //     removed: false,
    //     value: '0∶n1⟋1∶0.944492151⟋2∶0.89950443⟋3∶0.182709318⟋4∶0.892820757⟋5∶0.709746901⟋6∶0.097385354⟋\n' +
    //       '0∶n2⟋1∶0.769805921⟋2∶0.061355308⟋3∶0.314826137⟋4∶0.855857651⟋5∶0.653550539⟋6∶0.772500773⟋\n' +
    //       '0∶n3⟋1∶0.158739038⟋2∶0.085078711⟋3∶0.844664253⟋4∶0.21630142⟋5∶0.912931341⟋6∶0.735138313⟋\n'
    //   }
    // ]
    for (let i = 0; i < r.dfs.length; i++) {
        let df = r.dfs[i]
        console.log(i, 'df', df)
    }
    // => 0 df [
    //   { p: '', k: 0, vo: '1', vn: '' },
    //   { p: '', k: 1, vo: '0.974848293', vn: '' },
    //   { p: '', k: 2, vo: '0.791303871', vn: '' },
    //   { p: '', k: 3, vo: '0.716898185', vn: '' },
    //   { p: '', k: 4, vo: '0.506002098', vn: '' },
    //   { p: '', k: 5, vo: '0.137888903', vn: '' },
    //   { p: '', k: 6, vo: '0.626724085', vn: '' }
    // ]
    // 1 df [
    //   { p: '', k: 0, vo: '2', vn: '' },
    //   { p: '', k: 1, vo: '-0.529408622', vn: '' },
    //   { p: 'modify', k: 2, vo: '0.839882385', vn: '0.1839882385' },
    //   { p: '', k: 3, vo: '0.663059856', vn: '' },
    //   { p: '', k: 4, vo: '0.49047221', vn: '' },
    //   { p: 'modify', k: 5, vo: '123', vn: '0.395763265' },
    //   { p: 'modify', k: 6, vo: '0.395763265', vn: '45.6' },
    //   { p: '', k: 7, vo: '0.866151835', vn: '' }
    // ]
    // 2 df [
    //   { p: '', k: 0, vo: '3', vn: '' },
    //   { p: '', k: 1, vo: '-0.10320217', vn: '' },
    //   { p: '', k: 2, vo: '0.475514539', vn: '' },
    //   { p: '', k: 3, vo: '0.969205779', vn: '' },
    //   { p: '', k: 4, vo: '0.711250309', vn: '' },
    //   { p: '', k: 5, vo: '0.153847069', vn: '' },
    //   { p: '', k: 6, vo: '0.410092395', vn: '' }
    // ]
    // 3 df [
    //   { p: '', k: 0, vo: '4', vn: '' },
    //   { p: '', k: 1, vo: '-0.121479865', vn: '' },
    //   { p: '', k: 2, vo: '0.486179086', vn: '' },
    //   { p: '', k: 3, vo: '0.481023842', vn: '' },
    //   { p: '', k: 4, vo: '0.467410582', vn: '' },
    //   { p: '', k: 5, vo: '0.42602231', vn: '' },
    //   { p: '', k: 6, vo: '0.849701641', vn: '' }
    // ]
    // 4 df [
    //   { p: '', k: 0, vo: '5', vn: '' },
    //   { p: '', k: 1, vo: '0.757346003', vn: '' },
    //   { p: '', k: 2, vo: '0.697242433', vn: '' },
    //   { p: '', k: 3, vo: '0.67532802', vn: '' },
    //   { p: '', k: 4, vo: '0.174644416', vn: '' },
    //   { p: '', k: 5, vo: '0.045652267', vn: '' },
    //   { p: '', k: 6, vo: '0.397104668', vn: '' }
    // ]
    // 5 df [
    //   { p: 'remove', k: 0, vo: '6', vn: '' },
    //   { p: 'remove', k: 1, vo: '0.663032731', vn: '' },
    //   { p: 'remove', k: 2, vo: '0.259252779', vn: '' },
    //   { p: 'remove', k: 3, vo: '0.566177431', vn: '' },
    //   { p: 'remove', k: 4, vo: '0.679637706', vn: '' },
    //   { p: 'remove', k: 5, vo: '0.377814487', vn: '' },
    //   { p: 'remove', k: 6, vo: '0.400248119', vn: '' }
    // ]
    // 6 df [
    //   { p: '', k: 0, vo: '7', vn: '' },
    //   { p: '', k: 1, vo: '0.72721374', vn: '' },
    //   { p: '', k: 2, vo: '0.263793391', vn: '' },
    //   { p: '', k: 3, vo: '0.167895215', vn: '' },
    //   { p: '', k: 4, vo: '0.794808602', vn: '' },
    //   { p: '', k: 5, vo: '0.107070584', vn: '' },
    //   { p: '', k: 6, vo: '0.011822872', vn: '' }
    // ]
    // 7 df [
    //   { p: '', k: 0, vo: '8', vn: '' },
    //   { p: '', k: 1, vo: '0.247416664', vn: '' },
    //   { p: '', k: 2, vo: '0.360426795', vn: '' },
    //   { p: '', k: 3, vo: '0.014346373', vn: '' },
    //   { p: '', k: 4, vo: '0.000469616', vn: '' },
    //   { p: '', k: 5, vo: '0.4082693', vn: '' },
    //   { p: '', k: 6, vo: '0.913806611', vn: '' }
    // ]
    // 8 df [
    //   { p: '', k: 0, vo: '9', vn: '' },
    //   { p: '', k: 1, vo: '0.345880037', vn: '' },
    //   { p: '', k: 2, vo: '0.167996664', vn: '' },
    //   { p: '', k: 3, vo: '0.711054429', vn: '' },
    //   { p: 'modify', k: 4, vo: '0.363177921', vn: '0.363173478' },
    //   { p: 'modify', k: 5, vo: '0.206849994', vn: '0.636855344' },
    //   { p: 'remove', k: 6, vo: '0.636855344', vn: '' }
    // ]
    // 9 df [
    //   { p: '', k: 0, vo: '10', vn: '' },
    //   { p: '', k: 1, vo: '0.576739457', vn: '' },
    //   { p: '', k: 2, vo: '0.324665077', vn: '' },
    //   { p: '', k: 3, vo: '0.973218005', vn: '' },
    //   { p: '', k: 4, vo: '0.883927423', vn: '' },
    //   { p: '', k: 5, vo: '0.176906125', vn: '' },
    //   { p: '', k: 6, vo: '0.20087887', vn: '' }
    // ]
    // 10 df [
    //   { p: 'remove', k: 0, vo: '11', vn: '' },
    //   { p: 'remove', k: 1, vo: '1.2', vn: '' }
    // ]
    // 11 df [
    //   { p: 'remove', k: 0, vo: '12', vn: '' },
    //   { p: 'remove', k: 1, vo: '23.5', vn: '' }
    // ]
    // 12 df [
    //   { p: '', k: 0, vo: '13', vn: '' },
    //   { p: '', k: 1, vo: '0.504421248', vn: '' },
    //   { p: '', k: 2, vo: '0.984003751', vn: '' },
    //   { p: '', k: 3, vo: '0.32549507', vn: '' },
    //   { p: '', k: 4, vo: '0.987090751', vn: '' },
    //   { p: '', k: 5, vo: '0.192745589', vn: '' },
    //   { p: '', k: 6, vo: '0.735133561', vn: '' }
    // ]
    // 13 df [
    //   { p: '', k: 0, vo: '14', vn: '' },
    //   { p: '', k: 1, vo: '0.273214614', vn: '' },
    //   { p: '', k: 2, vo: '0.083431884', vn: '' },
    //   { p: '', k: 3, vo: '0.565146092', vn: '' },
    //   { p: '', k: 4, vo: '0.935388666', vn: '' },
    //   { p: '', k: 5, vo: '0.637675154', vn: '' },
    //   { p: '', k: 6, vo: '0.523815661', vn: '' }
    // ]
    // 14 df [
    //   { p: 'add', k: 0, vo: 'n1', vn: '' },
    //   { p: 'add', k: 1, vo: '0.944492151', vn: '' },
    //   { p: 'add', k: 2, vo: '0.89950443', vn: '' },
    //   { p: 'add', k: 3, vo: '0.182709318', vn: '' },
    //   { p: 'add', k: 4, vo: '0.892820757', vn: '' },
    //   { p: 'add', k: 5, vo: '0.709746901', vn: '' },
    //   { p: 'add', k: 6, vo: '0.097385354', vn: '' }
    // ]
    // 15 df [
    //   { p: 'add', k: 0, vo: 'n2', vn: '' },
    //   { p: 'add', k: 1, vo: '0.769805921', vn: '' },
    //   { p: 'add', k: 2, vo: '0.061355308', vn: '' },
    //   { p: 'add', k: 3, vo: '0.314826137', vn: '' },
    //   { p: 'add', k: 4, vo: '0.855857651', vn: '' },
    //   { p: 'add', k: 5, vo: '0.653550539', vn: '' },
    //   { p: 'add', k: 6, vo: '0.772500773', vn: '' }
    // ]
    // 16 df [
    //   { p: 'add', k: 0, vo: 'n3', vn: '' },
    //   { p: 'add', k: 1, vo: '0.158739038', vn: '' },
    //   { p: 'add', k: 2, vo: '0.085078711', vn: '' },
    //   { p: 'add', k: 3, vo: '0.844664253', vn: '' },
    //   { p: 'add', k: 4, vo: '0.21630142', vn: '' },
    //   { p: 'add', k: 5, vo: '0.912931341', vn: '' },
    //   { p: 'add', k: 6, vo: '0.735138313', vn: '' }
    // ]
}

Parameters:

Returns:

Type

Object

(static) arrFilterByKeywords(arr, keywords) → {Array}

Description:

• 對arr陣列內各字串進行關鍵字計算，計算是否含有關鍵字與程度，多關鍵字用空白區隔，必要關鍵字可於字首添加「+」，不要關鍵字可於字首添加「-」

  Unit Test: Github

Source:

• arrFilterByKeywords.mjs, line 161

Example

let arr = [
    'abc def xyz',
    '測試abc中文mnop',
    'Instead of creating yet another opinionated application',
    'Node.js module which can be integrated into a larger application',
]
let kws = null
let r = null

kws = 'abc'
r = arrFilterByKeywords(arr, kws)
console.log(r)
// => [
//     { hasKeyword: true, weight: 1 },
//     { hasKeyword: true, weight: 1 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 }
// ]

kws = 'def'
r = arrFilterByKeywords(arr, kws)
console.log(r)
// => [
//     { hasKeyword: true, weight: 1 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 }
// ]

kws = 'def 中文'
r = arrFilterByKeywords(arr, kws)
console.log(r)
// => [
//     { hasKeyword: true, weight: 1 },
//     { hasKeyword: true, weight: 0.25 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 }
// ]

kws = 'def 中文 mnop'
r = arrFilterByKeywords(arr, kws)
console.log(r)
// => [
//     { hasKeyword: true, weight: 1 },
//     { hasKeyword: true, weight: 0.5555555555555557 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 }
// ]

kws = 'def +yet'
r = arrFilterByKeywords(arr, kws)
console.log(r)
// => [
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: true, weight: 1 },
//     { hasKeyword: false, weight: 0 }
// ]

kws = 'def of module -yet'
r = arrFilterByKeywords(arr, kws)
console.log(r)
// => [
//     { hasKeyword: true, weight: 1 },
//     { hasKeyword: true, weight: 1 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: true, weight: 1 }
// ]

kws = '+'
r = arrFilterByKeywords(arr, kws)
console.log(r)
// => [
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 }
// ]

kws = '-'
r = arrFilterByKeywords(arr, kws)
console.log(r)
// => [
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 }
// ]

kws = 'def +'
r = arrFilterByKeywords(arr, kws)
console.log(r)
// => [
//     { hasKeyword: true, weight: 1 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 }
// ]

kws = ['def', 'of', 'module', '-yet']
r = arrFilterByKeywords(arr, kws)
console.log(r)
// => [
//     { hasKeyword: true, weight: 1 },
//     { hasKeyword: true, weight: 1 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: true, weight: 1 }
// ]

kws = ['can be', 'def']
r = arrFilterByKeywords(arr, kws)
console.log(r)
// => [
//     { hasKeyword: true, weight: 0.25 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: true, weight: 1 }
// ]

kws = ['+abc']
r = arrFilterByKeywords(arr, kws)
console.log(r)
// => [
//     { hasKeyword: true, weight: 1 },
//     { hasKeyword: true, weight: 1 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 }
// ]

kws = ['-abc']
r = arrFilterByKeywords(arr, kws)
console.log(r)
// => [
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: false, weight: 0 },
//     { hasKeyword: true, weight: 1 },
//     { hasKeyword: true, weight: 1 }
// ]

Parameters:

Returns:

Type

Array

(static) arrFilterByNum(arr) → {Array}

Description:

• 過濾陣列內元素僅保留數字，並且自動轉數值

  Unit Test: Github

Source:

• arrFilterByNum.mjs, line 29

Example

let arr

arr = ['abc', '-2.2', '-1.1', -1.1, -1, -0.5, 0, '0', 0.5, 1, 1.1, '1.1', '2.2', 'xyz']
console.log(arrFilterByNum(arr))
// => [ -2.2, -1.1, -1.1, -1, -0.5, 0, 0, 0.5, 1, 1.1, 1.1, 2.2 ]

arr = ['-2.2', '-1.1', -1.1, -1, -0.5, 0, '0']
console.log(arrFilterByNum(arr))
// => [ -2.2, -1.1, -1.1, -1, -0.5, 0, 0 ]

Parameters:

Returns:

Type

Array

(static) arrFilterByPnum(arr) → {Array}

Description:

• 過濾陣列內元素僅保留正數(不含0)，並且自動轉數值

  Unit Test: Github

Source:

• arrFilterByPnum.mjs, line 29

Example

let arr

arr = ['abc', '-2.2', '-1.1', -1.1, -1, -0.5, 0, '0', 0.5, 1, 1.1, '1.1', '2.2', 'xyz']
console.log(arrFilterByPnum(arr))
// => [ 0.5, 1, 1.1, 1.1, 2.2 ]

arr = ['-2.2', '-1.1', -1.1, -1, -0.5, 0, '0']
console.log(arrFilterByPnum(arr))
// => []

Parameters:

Returns:

Type

Array

(static) arrFilterByPnumAndToLog(arr) → {Array}

Description:

• 過濾陣列內元素僅保留正數(不含0)，並且自動轉數值，再轉log10(Math.log)

  Unit Test: Github

Source:

• arrFilterByPnumAndToLog.mjs, line 32

Example

let arr

arr = ['abc', '-2.2', '-1.1', -1.1, -1, -0.5, 0, '0', 0.5, 1, 1.1, '1.1', '2.2', 'xyz']
console.log(arrFilterByPnumAndToLog(arr))
// => [
//   -0.6931471805599453,
//   0,
//   0.09531017980432493,
//   0.09531017980432493,
//   0.7884573603642703
// ]

arr = ['-2.2', '-1.1', -1.1, -1, -0.5, 0, '0']
console.log(arrFilterByPnumAndToLog(arr))
// => []

Parameters:

Returns:

Type

Array

(static) arrFind(vall, vfind) → {Array}

Description:

• 由vall陣列找尋vfind內各元素之第1位置

  Unit Test: Github

Source:

• arrFind.mjs, line 48

Example

console.log(arrFind([1, 2, 3, '4', 5, 'abc'], 2))
// => [ 1 ]

console.log(arrFind([1, 2, 3, '4', 5, 'abc'], 12))
// => [ -1 ]

console.log(arrFind([1, 2, 3, '4', 5, 'abc'], [2]))
// => [ 1 ]

console.log(arrFind([1, 2, 3, '4', 5, 'abc'], ['4', 2]))
// => [ 3, 1 ]

console.log(arrFind([1, true, 2, 3, '4', true, 5, 'abc'], true))
// => [ 1 ]

console.log(arrFind([1, true, 2, 3, '4', true, 5, 'abc'], [true]))
// => [ 1 ]

console.log(arrFind([1, 2, { x: 'xyz' }, 3, '4', 5, 'abc'], { x: 'xyz' }))
// => [ 2 ]

console.log(arrFind([1, 2, { x: 'xyz' }, 3, '4', 5, 'abc'], [{ x: 'xyz' }]))
// => [ 2 ]

console.log(arrFind([1, 2, { x: 'xyz' }, 3, '4', 5, 'abc'], ['4', { x: 'xyz' }]))
// => [ 4, 2 ]

console.log(arrFind([1, 2, { x: 'xyz' }, 3, '4', 5, 'abc'], [7, { x: 'xyz' }]))
// => [-1, 2]

Parameters:

Returns:

Type

Array

(static) arrGroupByMaxmin(arr, maxmins, optopt) → {Array}

Description:

• 依照指定最大最小值物件陣列切分陣列

  Unit Test: Github

Source:

• arrGroupByMaxmin.mjs, line 457

Example

let arr1 = [1.1, 2.2, 3.3, 4.4, 5.5, 6.6]
let mm1 = [
    {
        min: 0,
        max: 2,
    },
    {
        min: 2,
        max: 5,
    },
]
console.log(arrGroupByMaxmin(arr1, mm1))
// => [
//   { min: 0, max: 2, items: [ 1.1 ] },
//   { min: 2, max: 5, items: [ 2.2, 3.3, 4.4 ] }
// ]

let arr2 = [1.1, 2.2, 3.3, 4.4, 5.5, 6.6]
let mm2 = [
    {
        min: 0,
        max: 2,
    },
    {
        min: 2.5,
        max: 5,
    },
]
console.log(arrGroupByMaxmin(arr2, mm2))
// => [
//   { min: 0, max: 2, items: [ 1.1 ] },
//   { min: 2.5, max: 5, items: [ 3.3, 4.4 ] }
// ]

let arr3 = [1.1, 2.2, 3.3, 4.4, 5.5, 6.6]
let mm3 = [
    {
        min: -1e20,
        max: 2,
    },
    {
        min: 2.5,
        max: 5,
    },
    {
        min: 6,
        max: 1e20,
    },
]
console.log(arrGroupByMaxmin(arr3, mm3))
// => [
//   { min: -100000000000000000000, max: 2, items: [ 1.1 ] },
//   { min: 2.5, max: 5, items: [ 3.3, 4.4 ] },
//   { min: 6, max: 100000000000000000000, items: [ 6.6 ] }
// ]

let arr4 = [
    {
        name: 'a',
        value: 1.1,
    },
    {
        name: 'b',
        value: 2.2,
    },
    {
        name: 'c',
        value: 3.3,
    },
    {
        name: 'd',
        value: 4.4,
    },
    {
        name: 'e',
        value: 5.5,
    },
    {
        name: 'f',
        value: 6.6,
    },
]
let mm4 = [
    {
        min: 0,
        max: 2,
    },
    {
        min: 2,
        max: 5,
    },
]
console.log(JSON.stringify(arrGroupByMaxmin(arr4, mm4), null, 2))
// => [
//   {
//     "min": 0,
//     "max": 2,
//     "items": [
//       {
//         "name": "a",
//         "value": 1.1
//       }
//     ]
//   },
//   {
//     "min": 2,
//     "max": 5,
//     "items": [
//       {
//         "name": "b",
//         "value": 2.2
//       },
//       {
//         "name": "c",
//         "value": 3.3
//       },
//       {
//         "name": "d",
//         "value": 4.4
//       }
//     ]
//   }
// ]

let arr5 = [1.1, 2.2, 3.3, 4.4, 5.5, 6.6]
let mm5 = [
    {
        rmin: 0,
        rmax: 2,
    },
    {
        rmin: 2,
        rmax: 5,
    },
]
console.log(arrGroupByMaxmin(arr5, mm5, { keyMin: 'rmin', keyMax: 'rmax' }))
// => [
//   { rmin: 0, rmax: 2, items: [ 1.1 ] },
//   { rmin: 2, rmax: 5, items: [ 2.2, 3.3, 4.4 ] }
// ]

let arr6 = [
    {
        name: 'a',
        data: 1.1,
    },
    {
        name: 'b',
        data: 2.2,
    },
    {
        name: 'c',
        data: 3.3,
    },
    {
        name: 'd',
        data: 4.4,
    },
    {
        name: 'e',
        data: 5.5,
    },
    {
        name: 'f',
        data: 6.6,
    },
]
let mm6 = [
    {
        min: 0,
        max: 2,
    },
    {
        min: 2,
        max: 5,
    },
]
console.log(JSON.stringify(arrGroupByMaxmin(arr6, mm6, { keyValue: 'data' }), null, 2))
// => [
//   {
//     "min": 0,
//     "max": 2,
//     "items": [
//       {
//         "name": "a",
//         "data": 1.1
//       }
//     ]
//   },
//   {
//     "min": 2,
//     "max": 5,
//     "items": [
//       {
//         "name": "b",
//         "data": 2.2
//       },
//       {
//         "name": "c",
//         "data": 3.3
//       },
//       {
//         "name": "d",
//         "data": 4.4
//       }
//     ]
//   }
// ]

let arr7 = [1.1, 2.2, 3.3, 4.4, 5.5, 6.6]
let mm7 = [
    {
        min: 0,
        max: 2,
    },
    {
        min: 2,
        max: 5,
    },
]
console.log(arrGroupByMaxmin(arr7, mm7, { keyItems: 'result' }))
// => [
//   { min: 0, max: 2, result: [ 1.1 ] },
//   { min: 2, max: 5, result: [ 2.2, 3.3, 4.4 ] }
// ]

let arr8 = [1.1, 2.2, 3.3, 4.4, 5.5, 6.6]
let mm8 = [
    {
        min: 1.1,
        minType: '>',
        max: 2.2,
        maxType: '<=',
    },
    {
        min: 2.2,
        minType: '>=',
        max: 5.5,
        maxType: '<',
    },
]
console.log(arrGroupByMaxmin(arr8, mm8))
// => [
//   {
//     min: 1.1,
//     minType: '>',
//     max: 2.2,
//     maxType: '<=',
//     items: [ 2.2 ]
//   },
//   {
//     min: 2.2,
//     minType: '>=',
//     max: 5.5,
//     maxType: '<',
//     items: [ 2.2, 3.3, 4.4 ]
//   }
// ]


let arr9 = [
    {
        name: 'a',
        value: 1.1,
    },
    {
        name: 'b',
        value: 2.2,
    },
    {
        name: 'c',
        value: 3.3,
    },
    {
        name: 'd',
        value: 4.4,
    },
    {
        name: 'e',
        value: 5.5,
    },
    {
        name: 'f',
        value: 6.6,
    },
]
let mm9 = [
    {
        min: 0,
        minType: '>=',
        max: 5,
        maxType: '<',
    },
    {
        min: 5,
        minType: '>=',
        max: 10,
        maxType: '<',
    },
]
console.log(JSON.stringify(arrGroupByMaxmin(arr9, mm9), null, 2))
// => [
//   {
//     "min": 0,
//     "minType": ">=",
//     "max": 5,
//     "maxType": "<",
//     "items": [
//       {
//         "name": "a",
//         "value": 1.1
//       },
//       {
//         "name": "b",
//         "value": 2.2
//       },
//       {
//         "name": "c",
//         "value": 3.3
//       },
//       {
//         "name": "d",
//         "value": 4.4
//       }
//     ]
//   },
//   {
//     "min": 5,
//     "minType": ">=",
//     "max": 10,
//     "maxType": "<",
//     "items": [
//       {
//         "name": "e",
//         "value": 5.5
//       },
//       {
//         "name": "f",
//         "value": 6.6
//       }
//     ]
//   }
// ]


let arr10 = [
    {
        name: 'a',
        data: 1.1,
    },
    {
        name: 'b',
        data: 2.2,
    },
    {
        name: 'c',
        data: 3.3,
    },
    {
        name: 'd',
        data: 4.4,
    },
    {
        name: 'e',
        data: 5.5,
    },
    {
        name: 'f',
        data: 6.6,
    },
]
let mm10 = [
    {
        min: 0,
        minType: '>=',
        max: 5,
        maxType: '<',
    },
    {
        min: 5,
        minType: '>=',
        max: 10,
        maxType: '<',
    },
]
console.log(JSON.stringify(arrGroupByMaxmin(arr10, mm10, { keyValue: 'data' }), null, 2))
// => [
//   {
//     "min": 0,
//     "minType": ">=",
//     "max": 5,
//     "maxType": "<",
//     "items": [
//       {
//         "name": "a",
//         "data": 1.1
//       },
//       {
//         "name": "b",
//         "data": 2.2
//       },
//       {
//         "name": "c",
//         "data": 3.3
//       },
//       {
//         "name": "d",
//         "data": 4.4
//       }
//     ]
//   },
//   {
//     "min": 5,
//     "minType": ">=",
//     "max": 10,
//     "maxType": "<",
//     "items": [
//       {
//         "name": "e",
//         "data": 5.5
//       },
//       {
//         "name": "f",
//         "data": 6.6
//       }
//     ]
//   }
// ]

Parameters:

Returns:

Type

Array

(static) arrHas(vtar, vhas) → {Boolean}

Description:

• 判斷任一字串陣列vtar內元素，是否「等於」任一字串陣列vhas內元素

  Unit Test: Github

Source:

• arrHas.mjs, line 65

Example

console.log(arrHas([1, 2, 3, '4', 5, 'abc'], 2))
// => true

console.log(arrHas([1, 2, 3, '4', 5, 'abc'], 6))
// => false

console.log(arrHas([1, 2, 3, '4', 5, 'abc'], [2]))
// => true

console.log(arrHas([1, 2, 3, '4', 5, 'abc'], [6]))
// => false

console.log(arrHas([1, 2, 3, '4', 5, 'abc'], ['4', 2]))
// => true

console.log(arrHas([1, 2, 3, '4', 5, 'abc'], ['7', 6]))
// => false

console.log(arrHas([1, true, 2, 3, '4', true, 5, 'abc'], true))
// => true

console.log(arrHas([1, true, 2, 3, '4', true, 5, 'abc'], false))
// => false

console.log(arrHas([1, true, 2, 3, '4', true, 5, 'abc'], [true]))
// => true

console.log(arrHas([1, true, 2, 3, '4', true, 5, 'abc'], [false]))
// => false

console.log(arrHas([1, 2, { x: 'xyz' }, 3, '4', 5, 'abc'], { x: 'xyz' }))
// => true

console.log(arrHas([1, 2, { x: 'xyz' }, 3, '4', 5, 'abc'], { x: 'opqr' }))
// => false

console.log(arrHas([1, 2, { x: 'xyz' }, 3, '4', 5, 'abc'], [{ x: 'xyz' }]))
// => true

console.log(arrHas([1, 2, { x: 'xyz' }, 3, '4', 5, 'abc'], [{ x: 'opqr' }]))
// => false

console.log(arrHas([1, 2, { x: 'xyz' }, 3, '4', 5, 'abc'], ['4', { x: 'xyz' }]))
// => true

console.log(arrHas([1, 2, { x: 'xyz' }, 3, '4', 5, 'abc'], ['7', { x: 'opqr' }]))
// => false

Parameters:

Returns:

Type

Boolean

(static) arrInsert(arr, ind, items) → {Array}

Description:

• 於陣列arr內指定位置ind插入新陣列items

  Unit Test: Github

Source:

• arrInsert.mjs, line 50

Example

let arr = [1, 2.5, '123']
let r

r = arrInsert([], 0, 'abc')
console.log(r)
// => [ 'abc' ]

r = arrInsert(arr, 0, 'abc')
console.log(r)
// => [ 'abc', 1, 2.5, '123' ]

r = arrInsert(arr, 1, 'abc')
console.log(r)
// => [ 1, 'abc', 2.5, '123' ]

r = arrInsert(arr, 3, 'abc')
console.log(r)
// => [ 1, 2.5, '123', 'abc' ]

r = arrInsert(arr, 4, 'abc')
console.log(r)
// => [ 1, 2.5, '123' ]

r = arrInsert(arr, 1, null)
console.log(r)
// => [ 1, null, 2.5, '123' ]

r = arrInsert(arr, 1, ['abc', null, 'xyz'])
console.log(r)
// => [ 1, 'abc', null, 'xyz', 2.5, '123' ]

Parameters:

Returns:

Type

Array

(static) arrLookupByMaxmin(arr, maxmins, optopt) → {Array}

Description:

• 依照指定最大最小值物件陣列，查找陣列內各元素之所屬值

  Unit Test: Github

Source:

• arrLookupByMaxmin.mjs, line 564

Example

let arr1 = [
    {
        name: 'a',
        value: 1.1,
    },
    {
        name: 'b',
        value: 2.2,
    },
    {
        name: 'c',
        value: 3.3,
    },
    {
        name: 'd',
        value: 4.4,
    },
    {
        name: 'e',
        value: 5.5,
    },
    {
        name: 'f',
        value: 6.6,
    },
]
let mm1 = [
    {
        min: 0,
        max: 2,
    },
    {
        min: 2,
        max: 5,
    },
]
console.log(JSON.stringify(arrLookupByMaxmin(arr1, mm1), null, 2))
// => [
//   {
//     "name": "a",
//     "value": 1.1,
//     "items": [
//       {
//         "min": 0,
//         "max": 2
//       }
//     ]
//   },
//   {
//     "name": "b",
//     "value": 2.2,
//     "items": [
//       {
//         "min": 2,
//         "max": 5
//       }
//     ]
//   },
//   {
//     "name": "c",
//     "value": 3.3,
//     "items": [
//       {
//         "min": 2,
//         "max": 5
//       }
//     ]
//   },
//   {
//     "name": "d",
//     "value": 4.4,
//     "items": [
//       {
//         "min": 2,
//         "max": 5
//       }
//     ]
//   },
//   {
//     "name": "e",
//     "value": 5.5
//   },
//   {
//     "name": "f",
//     "value": 6.6
//   }
// ]

let arr2 = [
    {
        name: 'a',
        value: 1.1,
    },
    {
        name: 'b',
        value: 2.2,
    },
    {
        name: 'c',
        value: 3.3,
    },
    {
        name: 'd',
        value: 4.4,
    },
    {
        name: 'e',
        value: 5.5,
    },
    {
        name: 'f',
        value: 6.6,
    },
]
let mm2 = [
    {
        rmin: 0,
        rmax: 2,
    },
    {
        rmin: 2,
        rmax: 5,
    },
]
console.log(JSON.stringify(arrLookupByMaxmin(arr2, mm2, { keyMin: 'rmin', keyMax: 'rmax' }), null, 2))
// => [
//   {
//     "name": "a",
//     "value": 1.1,
//     "items": [
//       {
//         "rmin": 0,
//         "rmax": 2
//       }
//     ]
//   },
//   {
//     "name": "b",
//     "value": 2.2,
//     "items": [
//       {
//         "rmin": 2,
//         "rmax": 5
//       }
//     ]
//   },
//   {
//     "name": "c",
//     "value": 3.3,
//     "items": [
//       {
//         "rmin": 2,
//         "rmax": 5
//       }
//     ]
//   },
//   {
//     "name": "d",
//     "value": 4.4,
//     "items": [
//       {
//         "rmin": 2,
//         "rmax": 5
//       }
//     ]
//   },
//   {
//     "name": "e",
//     "value": 5.5
//   },
//   {
//     "name": "f",
//     "value": 6.6
//   }
// ]

let arr3 = [
    {
        name: 'a',
        data: 1.1,
    },
    {
        name: 'b',
        data: 2.2,
    },
    {
        name: 'c',
        data: 3.3,
    },
    {
        name: 'd',
        data: 4.4,
    },
    {
        name: 'e',
        data: 5.5,
    },
    {
        name: 'f',
        data: 6.6,
    },
]
let mm3 = [
    {
        min: 0,
        max: 2,
    },
    {
        min: 2,
        max: 5,
    },
]
console.log(JSON.stringify(arrLookupByMaxmin(arr3, mm3, { keyValue: 'data' }), null, 2))
// => [
//   {
//     "name": "a",
//     "data": 1.1,
//     "items": [
//       {
//         "min": 0,
//         "max": 2
//       }
//     ]
//   },
//   {
//     "name": "b",
//     "data": 2.2,
//     "items": [
//       {
//         "min": 2,
//         "max": 5
//       }
//     ]
//   },
//   {
//     "name": "c",
//     "data": 3.3,
//     "items": [
//       {
//         "min": 2,
//         "max": 5
//       }
//     ]
//   },
//   {
//     "name": "d",
//     "data": 4.4,
//     "items": [
//       {
//         "min": 2,
//         "max": 5
//       }
//     ]
//   },
//   {
//     "name": "e",
//     "data": 5.5
//   },
//   {
//     "name": "f",
//     "data": 6.6
//   }
// ]

let arr4 = [
    {
        name: 'a',
        value: 1.1,
    },
    {
        name: 'b',
        value: 2.2,
    },
    {
        name: 'c',
        value: 3.3,
    },
    {
        name: 'd',
        value: 4.4,
    },
    {
        name: 'e',
        value: 5.5,
    },
    {
        name: 'f',
        value: 6.6,
    },
]
let mm4 = [
    {
        min: 0,
        max: 2,
    },
    {
        min: 2,
        max: 5,
    },
]
console.log(JSON.stringify(arrLookupByMaxmin(arr4, mm4, { keyItems: 'res' }), null, 2))
// => [
//   {
//     "name": "a",
//     "value": 1.1,
//     "res": [
//       {
//         "min": 0,
//         "max": 2
//       }
//     ]
//   },
//   {
//     "name": "b",
//     "value": 2.2,
//     "res": [
//       {
//         "min": 2,
//         "max": 5
//       }
//     ]
//   },
//   {
//     "name": "c",
//     "value": 3.3,
//     "res": [
//       {
//         "min": 2,
//         "max": 5
//       }
//     ]
//   },
//   {
//     "name": "d",
//     "value": 4.4,
//     "res": [
//       {
//         "min": 2,
//         "max": 5
//       }
//     ]
//   },
//   {
//     "name": "e",
//     "value": 5.5
//   },
//   {
//     "name": "f",
//     "value": 6.6
//   }
// ]

let arr5 = [
    {
        name: 'a',
        value: 1.1,
    },
    {
        name: 'b',
        value: 2.2,
    },
    {
        name: 'c',
        value: 3.3,
    },
    {
        name: 'd',
        value: 4.4,
    },
    {
        name: 'e',
        value: 5.5,
    },
    {
        name: 'f',
        value: 6.6,
    },
]
let mm5 = [
    {
        name: 'x1',
        min: 0,
        max: 2,
    },
    {
        name: 'x2',
        min: 2,
        max: 5,
    },
]
console.log(JSON.stringify(arrLookupByMaxmin(arr5, mm5, {
    keyItems: 'res',
    beforeAddResult: (m) => {
        return m.name
    }
}), null, 2))
// => [
//   {
//     "name": "a",
//     "value": 1.1,
//     "res": [
//       "x1"
//     ]
//   },
//   {
//     "name": "b",
//     "value": 2.2,
//     "res": [
//       "x2"
//     ]
//   },
//   {
//     "name": "c",
//     "value": 3.3,
//     "res": [
//       "x2"
//     ]
//   },
//   {
//     "name": "d",
//     "value": 4.4,
//     "res": [
//       "x2"
//     ]
//   },
//   {
//     "name": "e",
//     "value": 5.5
//   },
//   {
//     "name": "f",
//     "value": 6.6
//   }
// ]

let arr6 = [
    {
        name: 'a',
        value: 1.1,
    },
    {
        name: 'b',
        value: 2.2,
    },
    {
        name: 'c',
        value: 3.3,
    },
    {
        name: 'd',
        value: 4.4,
    },
    {
        name: 'e',
        value: 5.5,
    },
    {
        name: 'f',
        value: 6.6,
    },
]
let mm6 = [
    {
        min: 1.1,
        minType: '>',
        max: 2.2,
        maxType: '<=',
    },
    {
        min: 2.2,
        minType: '>=',
        max: 5.5,
        maxType: '<',
    },
]
console.log(JSON.stringify(arrLookupByMaxmin(arr6, mm6), null, 2))
// => [
//   {
//     "name": "a",
//     "value": 1.1
//   },
//   {
//     "name": "b",
//     "value": 2.2,
//     "items": [
//       {
//         "min": 1.1,
//         "minType": ">",
//         "max": 2.2,
//         "maxType": "<="
//       },
//       {
//         "min": 2.2,
//         "minType": ">=",
//         "max": 5.5,
//         "maxType": "<"
//       }
//     ]
//   },
//   {
//     "name": "c",
//     "value": 3.3,
//     "items": [
//       {
//         "min": 2.2,
//         "minType": ">=",
//         "max": 5.5,
//         "maxType": "<"
//       }
//     ]
//   },
//   {
//     "name": "d",
//     "value": 4.4,
//     "items": [
//       {
//         "min": 2.2,
//         "minType": ">=",
//         "max": 5.5,
//         "maxType": "<"
//       }
//     ]
//   },
//   {
//     "name": "e",
//     "value": 5.5
//   },
//   {
//     "name": "f",
//     "value": 6.6
//   }
// ]

Parameters:

Returns:

Type

Array

(static) arrMax(vall, optopt) → {Number|Object}

Description:

• 找尋陣列內元素最大值

  Unit Test: Github

Source:

• arrMax.mjs, line 79

Example

let r

r = arrMax([100000, 1, 30, 4, 21])
console.log(r)
// => 100000

r = arrMax([1, 30, 4, 21, 100000])
console.log(r)
// => 100000

r = arrMax([1, 30, 4, 100000, 21])
console.log(r)
// => 100000

r = arrMax([1, 30, 4, 100000, 21], { returnIndex: true })
console.log(r)
// => 3

r = arrMax(['March', 'Jan', 'Feb', 'Dec'])
console.log(r)
// => null

r = arrMax(['1', '30', '  4  ', '100000', '21'])
console.log(r)
// => 100000

r = arrMax(['1', '30', '  4  ', '100000', 21])
console.log(r)
// => 100000

r = arrMax(['a1', 'b30', '  4  ', '100000', 21])
console.log(r)
// => 100000

r = arrMax(
    [{ s: 'March', i: 1 }, { s: 'Jan', i: 4 }, { s: 'Feb', i: 100000 }, { s: 'Dec', i: 30 }, { s: 'Nov', i: 'a25' }],
    { compareKey: 'i' }
)
console.log(r)
// => { s: 'Feb', i: 100000 }

r = arrMax(
    [{ s: 'March', i: 1 }, { s: 'Jan', i: 4 }, { s: 'Feb', i: 100000 }, { s: 'Dec', i: 30 }, { s: 'Nov', i: 'a25' }],
    { compareKey: 's' }
)
console.log(r)
// => null

r = arrMax(
    [{ s: 'March', i: 1 }, { s: 'Jan', i: 4 }, { s: 'Feb', i: 100000 }, { s: 'Dec', i: 30 }, { s: 'Nov', i: 'a25' }],
    { compareKey: 'i', returnIndex: true }
)
console.log(r)
// => 2

Parameters:

Returns:

Type

Number | Object

(static) arrMin(vall, optopt) → {Number|Object}

Description:

• 找尋陣列內元素最小值

  Unit Test: Github

Source:

• arrMin.mjs, line 79

Example

let r

r = arrMin([100000, 1, 30, 4, 21])
console.log(r)
// => 1

r = arrMin([1, 30, 4, 21, 100000])
console.log(r)
// => 1

r = arrMin([1, 30, 4, 100000, 21])
console.log(r)
// => 1

r = arrMin([1, 30, 4, 100000, 21], { returnIndex: true })
console.log(r)
// => 0

r = arrMin(['March', 'Jan', 'Feb', 'Dec'])
console.log(r)
// => null

r = arrMin(['1', '30', '  4  ', '100000', '21'])
console.log(r)
// => 1

r = arrMin(['1', '30', '  4  ', '100000', 21])
console.log(r)
// => 1

r = arrMin(['a1', 'b30', '  4  ', '100000', 21])
console.log(r)
// => 4

r = arrMin(
    [{ s: 'March', i: 1 }, { s: 'Jan', i: 4 }, { s: 'Feb', i: 100000 }, { s: 'Dec', i: 30 }, { s: 'Nov', i: 'a25' }],
    { compareKey: 'i' }
)
console.log(r)
// => { s: 'March', i: 1 }

r = arrMin(
    [{ s: 'March', i: 1 }, { s: 'Jan', i: 4 }, { s: 'Feb', i: 100000 }, { s: 'Dec', i: 30 }, { s: 'Nov', i: 'a25' }],
    { compareKey: 's' }
)
console.log(r)
// => null

r = arrMin(
    [{ s: 'March', i: 1 }, { s: 'Jan', i: 4 }, { s: 'Feb', i: 100000 }, { s: 'Dec', i: 30 }, { s: 'Nov', i: 'a25' }],
    { compareKey: 'i', returnIndex: true }
)
console.log(r)
// => 0

Parameters:

Returns:

Type

Number | Object

(static) arrMulti(arguments) → {Array}

Description:

• 各陣列同位置元素相乘

  Unit Test: Github

Source:

• arrMulti.mjs, line 64

Example

let v1 = [1, 2, 3, 4]
let v2 = [0.1, 0.1, 0.1, 0.1]
let v3 = [11, 22, 33, 44]

console.log(arrMulti(v1, v2))
// => [ 0.1, 0.2, 0.30000000000000004, 0.4 ]

console.log(arrMulti(v1, v2, v3))
// => [ 1.1, 4.4, 9.900000000000002, 17.6 ]

Parameters:

Returns:

Type

Array

(static) arrNorm(vec) → {Array}

Description:

• 陣列Norm值，代表由各元素平方值相加開根號

  Unit Test: Github

Source:

• arrNorm.mjs, line 25

Example

console.log(arrNorm([1, 2, 3, 4]))
// => 5.477225575051661

console.log(arrNorm([0.1, 0.1, 0.1, 0.1]))
// => 0.2

console.log(arrNorm([11, 22, 33, 44]))
// => 60.249481325568276

Parameters:

Returns:

Type

Array

(static) arrProduct(arguments) → {Array}

Description:

• 各陣列同位置元素相乘並加總

  Unit Test: Github

Source:

• arrProduct.mjs, line 26

Example

let v1 = [1, 2, 3, 4]
let v2 = [0.1, 0.1, 0.1, 0.1]
let v3 = [11, 22, 33, 44]

console.log(arrProduct(v1, v2))
// => 1

console.log(arrProduct(v1, v2, v3))
// => 33

Parameters:

Returns:

Type

Array

(static) arrPull(vsrc, vpull) → {Array}

Description:

• 針對陣列移除元素或陣列內全部元素

  Unit Test: Github

Source:

• arrPull.mjs, line 30

Example

console.log(arrPull([1, 2, 3, 4, 5, 'abc'], [1, 4]))
// => [ 2, 3, 5, 'abc' ]

console.log(arrPull([1, 2, 3, '4', 5, 'abc'], [1, 4]))
// => [ 2, 3, '4', 5, 'abc' ]

console.log(arrPull([1, 2, 3, '4', 5, 'abc'], [6, 7]))
// => [ 1, 2, 3, '4', 5, 'abc' ]

Parameters:

Returns:

Type

Array

(static) arrPullAt(vsrc, vpull) → {Array}

Description:

• 針對陣列移除指定位置或陣列的指定位置

  Unit Test: Github

Source:

• arrPullAt.mjs, line 29

Example

console.log(arrPullAt([1, 2, 3, 4, 5, 'abc'], [0, 2]))
// => [ 2, 4, 5, 'abc' ]

console.log(arrPullAt([1, 2, 3, '4', 5, 'abc'], [1, 3]))
// => [ 1, 3, 5, 'abc' ]

console.log(arrPullAt([1, 2, 3, '4', 5, 'abc'], [4, 7]))
// => [ 1, 2, 3, '4', 'abc' ]

Parameters:

Returns:

Type

Array

(static) arrReduce(vall, fun, optopt) → {Number|Object}

Description:

• 找尋陣列內元素指定值

  Unit Test: Github

Source:

• arrReduce.mjs, line 88

Example

let r

r = arrReduce([100000, 1, 30, 4, 21], (vTemp, vNow) => {
    if (vTemp === null) {
        return vNow
    }
    return Math.min(vTemp, vNow)
})
console.log(r)
// => 1

r = arrReduce([1, 30, 4, 21, 100000], (vTemp, vNow) => {
    if (vTemp === null) {
        return vNow
    }
    return Math.max(vTemp, vNow)
})
console.log(r)
// => 100000

r = arrReduce([1, 30, 4, 100000, 21], (vTemp, vNow) => {
    if (vTemp === null) {
        return vNow
    }
    return Math.max(vTemp, vNow)
}, { returnIndex: true })
console.log(r)
// => 3

r = arrReduce(
    [{ s: 'March', i: 1 }, { s: 'Jan', i: 4 }, { s: 'Feb', i: 100000 }, { s: 'Dec', i: 30 }, { s: 'Nov', i: 25, }],
    (vTemp, vNow) => {
        if (vTemp === null) {
            return vNow.i
        }
        return Math.min(vTemp, vNow.i)
    },
)
console.log(r)
// => 1

r = arrReduce(
    [{ s: 'March', i: 1 }, { s: 'Jan', i: 4 }, { s: 'Feb', i: 100000 }, { s: 'Dec', i: 30 }, { s: 'Nov', i: 25, }],
    (vTemp, vNow) => {
        if (vTemp === null) {
            return vNow
        }
        return vTemp.i < vNow.i ? vNow : vTemp //max
    },
)
console.log(r)
// => { s: 'Feb', i: 100000 }

r = arrReduce(
    [{ s: 'March', i: 1 }, { s: 'Jan', i: 4 }, { s: 'Feb', i: 100000 }, { s: 'Dec', i: 30 }, { s: 'Nov', i: 25, }],
    (vTemp, vNow) => {
        if (vTemp === null) {
            return vNow
        }
        return vTemp.i < vNow.i ? vNow : vTemp //max
    },
    { returnIndex: true }
)
console.log(r)
// => 2

Parameters:

Returns:

Type

Number | Object

(static) arrReverse(vsrc) → {Array}

Description:

• 反序排列陣列

  Unit Test: Github

Source:

• arrReverse.mjs, line 26

Example

console.log(arrReverse([1, 2, 3, 4, 5, 'abc']))
// => [ 'abc', 5, 4, 3, 2, 1 ]

console.log(arrReverse([1, 2, 3, '4', 5, 'abc']))
// => [ 'abc', 5, '4', 3, 2, 1 ]

Parameters:

Returns:

Type

Array

(static) arrSep(arr, num) → {Array}

Description:

• 依照指定數量切分陣列

  Unit Test: Github

Source:

• arrSep.mjs, line 36

Example

let arr = ['a', 123, 'xyz', 5.678, null, 'd', [], { x: 'x1', y: 'y1' }]

console.log(arrSep(arr, 2))
// => [
//   [ 'a', 123 ],
//   [ 'xyz', 5.678 ],
//   [ null, 'd' ],
//   [ [], { x: 'x1', y: 'y1' } ]
// ]

console.log(arrSep(arr, 3))
// => [
//   [ 'a', 123, 'xyz' ],
//   [ 5.678, null, 'd' ],
//   [ [], { x: 'x1', y: 'y1' } ]
// ]

Parameters:

Returns:

Type

Array

(static) arrSort(vall, optopt) → {Array}

Description:

• 排序vall陣列，可針對純數字、純字串、含固定開頭字元的數字字串、物件陣列進行排列

  排序規則(同Excel之升冪)：數字與數字字串依數值排序排在最前；其他字串其次，若皆可剔除開頭結尾非數字字元而得數字(例如'abc1')則依其數值排序，否則依字串排序；無法轉數字或無法解析者(空字串、純空白字串、null、undefined、NaN、布林、物件、陣列等)無法排序，一律放最末並維持原順序

  localeCompare為true時數字與字串一併以localeCompare(numeric)排序，無法解析者仍放最末；vall全為物件時取compareKey欄位之值套用相同規則，無此欄位者放最末

  Unit Test: Github

Source:

• arrSort.mjs, line 247

Example

let r

r = arrSort([1, 30, 4, 21, 100000])
console.log(r)
// => [ 1, 4, 21, 30, 100000 ]

r = arrSort([1, 30, 4, 21, 100000], { returnIndex: true })
console.log(r)
// => [ 0, 2, 3, 1, 4 ]

r = arrSort(['March', 'Jan', 'Feb', 'Dec'])
console.log(r)
// => [ 'Dec', 'Feb', 'Jan', 'March' ]

r = arrSort(['1', '30', '  4  ', '21', '100000'])
console.log(r)
// => [ '1', '  4  ', '21', '30', '100000' ]

r = arrSort(['1', '30', '  4  ', 21, '100000'])
console.log(r)
// => [ '1', '  4  ', 21, '30', '100000' ]

r = arrSort([1, 2, 'abc', 5, 3, '4'])
console.log(r)
// => [ 1, 2, 3, '4', 5, 'abc' ]

r = arrSort([10, '', 9, 'N/A', ' ', null, 100])
console.log(r)
// => [ 9, 10, 100, 'N/A', '', ' ', null ]

r = arrSort(['abc1', 'abc30', 'abc4', 'abc21', 'abc100000'])
console.log(r)
// => [ 'abc1', 'abc4', 'abc21', 'abc30', 'abc100000' ]

r = arrSort(['1a', '30c', '  4 abc ', 'xyz', '21d', '100000xy'])
console.log(r)
// => [ '  4 abc ', '100000xy', '1a', '21d', '30c', 'xyz' ]

r = arrSort(
    [{ s: 'March', i: 1 }, { s: 'Jan', i: 4 }, { s: 'Feb', i: 100000 }, { s: 'Dec', i: 30 }],
    { compareKey: 'i' }
)
console.log(r)
// => [
//   { s: 'March', i: 1 },
//   { s: 'Jan', i: 4 },
//   { s: 'Dec', i: 30 },
//   { s: 'Feb', i: 100000 }
// ]

r = arrSort(
    [{ s: 'March', i: 1 }, { s: 'Jan', i: 4 }, { s: 'Feb', i: 100000 }, { s: 'Dec', i: 30 }],
    { compareKey: 's' }
)
console.log(r)
// => [
//   { s: 'Dec', i: 30 },
//   { s: 'Feb', i: 100000 },
//   { s: 'Jan', i: 4 },
//   { s: 'March', i: 1 }
// ]

r = arrSort(
    [{ s: 'abc1', i: 1, }, { s: 'abc', i: -1, }, { s: 'abc30', i: 4, }, { s: 'abc4', i: 100000, }, { s: 'abc100000', i: 30, }],
    { compareKey: 's' }
)
console.log(r)
// => [
//   { s: 'abc', i: -1 },
//   { s: 'abc1', i: 1 },
//   { s: 'abc100000', i: 30 },
//   { s: 'abc30', i: 4 },
//   { s: 'abc4', i: 100000 }
// ]

r = arrSort(
    [{ s: 'abc1', i: 1, }, { s: 'abc', i: -1, }, { s: 'abc30', i: 4, }, { s: 'abc4', i: 100000, }, { s: 'abc100000', i: 30, }],
    { compareKey: 's', localeCompare: true }
)
console.log(r)
// => [
//   { s: 'abc', i: -1 },
//   { s: 'abc1', i: 1 },
//   { s: 'abc4', i: 100000 },
//   { s: 'abc30', i: 4 },
//   { s: 'abc100000', i: 30 }
// ]

r = arrSort(
    [{ s: '中文1', i: 1, }, { s: '中文', i: -1, }, { s: '中文30', i: 4, }, { s: '中文4', i: 100000, }, { s: '中文100000', i: 30, }],
    { compareKey: 's', localeCompare: true }
)
console.log(r)
// => [
//   { s: '中文', i: -1 },
//   { s: '中文1', i: 1 },
//   { s: '中文4', i: 100000 },
//   { s: '中文30', i: 4 },
//   { s: '中文100000', i: 30 }
// ]

r = arrSort(
    [{ s: 'xyz.txt', i: 100, }, { s: 'abc1.txt', i: 1, }, { s: 'abc.txt', i: -1, }, { s: 'abc', i: -2, }, { s: 'abc30.txt', i: 4, }, { s: 'abc4.txt', i: 100000, }, { s: 'abc100000.txt', i: 30, }],
    { compareKey: 's', localeCompare: true }
)
console.log(r)
// => [
//   { s: 'abc', i: -2 },
//   { s: 'abc.txt', i: -1 },
//   { s: 'abc1.txt', i: 1 },
//   { s: 'abc4.txt', i: 100000 },
//   { s: 'abc30.txt', i: 4 },
//   { s: 'abc100000.txt', i: 30 },
//   { s: 'xyz.txt', i: 100 }
// ]

Parameters:

Returns:

Type

Array

(static) asind(v) → {Number}

Description:

• 輸入浮點數計算asin角度值

  Unit Test: Github

Source:

• asind.mjs, line 42

Example

console.log(asind(0))
// => 0

console.log(asind(0.5))
// => 30.000000000000004

console.log(asind(0.7071067811865475))
// => 44.99999999999999

console.log(asind(0.8660254037844386))
// => 59.99999999999999

console.log(asind(1))
// => 90

console.log(asind(-0.5))
// => -30.000000000000004

console.log(asind(-0.7071067811865475))
// => -44.99999999999999

console.log(asind(-0.8660254037844386))
// => -59.99999999999999

console.log(asind(-1))
// => -90

Parameters:

Returns:

Type

Number

(static) atan2d(x, y) → {Number}

Description:

• 輸入浮點數x,y計算atan2角度值

  Unit Test: Github

Source:

• atan2d.mjs, line 55

Example

console.log(atan2d(1, 0))
// => 0

console.log(atan2d(1, 0.5))
// => 26.56505117707799

console.log(atan2d(1, 0.7071067811865475))
// => 35.264389682754654

console.log(atan2d(1, 0.8660254037844386))
// => 40.89339464913091

console.log(atan2d(1, 1))
// => 45

console.log(atan2d(1, 1.7320508075688767))
// => 59.99999999999999

console.log(atan2d(1, Infinity))
// => 90

console.log(atan2d(1, -0.5))
// => -26.56505117707799

console.log(atan2d(1, -0.7071067811865475))
// => -35.264389682754654

console.log(atan2d(1, -0.8660254037844386))
// => -40.89339464913091

console.log(atan2d(1, -1))
// => -45

console.log(atan2d(1, -1.7320508075688767))
// => -59.99999999999999

console.log(atan2d(1, -Infinity))
// => -90

Parameters:

Returns:

Type

Number

(static) atand(v) → {Number}

Description:

• 輸入浮點數計算atan角度值

  Unit Test: Github

Source:

• atand.mjs, line 54

Example

console.log(atand(0))
// => 0

console.log(atand(0.5))
// => 26.56505117707799

console.log(atand(0.7071067811865475))
// => 35.264389682754654

console.log(atand(0.8660254037844386))
// => 40.89339464913091

console.log(atand(1))
// => 45

console.log(atand(1.7320508075688767))
// => 59.99999999999999

console.log(atand(Infinity))
// => 90

console.log(atand(-0.5))
// => -26.56505117707799

console.log(atand(-0.7071067811865475))
// => -35.264389682754654

console.log(atand(-0.8660254037844386))
// => -40.89339464913091

console.log(atand(-1))
// => -45

console.log(atand(-1.7320508075688767))
// => -59.99999999999999

console.log(atand(-Infinity))
// => -90

Parameters:

Returns:

Type

Number

(static) attstr() → {Object}

Description:

• 屬性字串處理

  Unit Test: Github

Source:

• attstr.mjs, line 341

Example

let c
let c1
let c2
let r

let at = attstr({ uniqItems: true })

//parse
console.log('parse')

c = 'abc123'
r = at.parse(c)
console.log(r)
// => [ 'abc123' ]

c = 'abc123;abc123'
r = at.parse(c)
console.log(r)
// => [ 'abc123' ]

c = 'abc123;def456'
r = at.parse(c)
console.log(r)
// => [ 'abc123', 'def456' ]

c = 'abc@123'
r = at.parse(c)
console.log(r)
// => [ { item: 'abc@123', table: 'abc', id: '123' } ]

c = 'abc@123;abc@123'
r = at.parse(c)
console.log(r)
// => [ { item: 'abc@123', table: 'abc', id: '123' } ]

c = 'abc@123;def@456'
r = at.parse(c)
console.log(r)
// => [
//   { item: 'abc@123', table: 'abc', id: '123' },
//   { item: 'def@456', table: 'def', id: '456' }
// ]

c = ''
r = at.parse(c)
console.log(r)
// => []

//join
console.log('join')

c = ['abc123']
r = at.join(c)
console.log(r)
// => 'abc123'

c = ['abc123', 'def456']
r = at.join(c)
console.log(r)
// => 'abc123;def456'

c = ['abc@123']
r = at.join(c)
console.log(r)
// => 'abc@123'

c = ['abc@123', 'def@456']
r = at.join(c)
console.log(r)
// => 'abc@123;def@456'

c = [{ table: 'abc', id: '123' }, { table: 'def', id: '456' }]
r = at.join(c)
console.log(r)
// => 'abc@123;def@456'

c = []
r = at.join(c)
console.log(r)
// => ''

//add
console.log('add')

c1 = 'abc123'
c2 = 'def456'
r = at.add(c1, c2)
console.log(r)
// => abc123;def456

c1 = 'abc123'
c2 = 'def456;ghi789'
r = at.add(c1, c2)
console.log(r)
// => abc123;def456;ghi789

c1 = 'abc123'
c2 = 'abc123'
r = at.add(c1, c2)
console.log(r)
// => abc123

c1 = 'abc123'
c2 = 'abc123;def456'
r = at.add(c1, c2)
console.log(r)
// => abc123;def456

c1 = 'abc123;ghi789'
c2 = 'abc123;def456'
r = at.add(c1, c2)
console.log(r)
// => abc123;ghi789;def456

c1 = ''
c2 = 'abc123'
r = at.add(c1, c2)
console.log(r)
// => abc123

c1 = ''
c2 = 'abc123;def456'
r = at.add(c1, c2)
console.log(r)
// => abc123;def456

c1 = 'abc@123'
c2 = 'def@456'
r = at.add(c1, c2)
console.log(r)
// => abc@123;def@456

c1 = 'abc@123'
c2 = 'def@456;ghi@789'
r = at.add(c1, c2)
console.log(r)
// => abc@123;def@456;ghi@789

c1 = 'abc@123;ghi@789'
c2 = 'abc@123;def@456'
r = at.add(c1, c2)
console.log(r)
// => abc@123;ghi@789;def@456

c1 = ''
c2 = 'abc@123'
r = at.add(c1, c2)
console.log(r)
// => abc@123

c1 = ''
c2 = 'abc@123;def@456'
r = at.add(c1, c2)
console.log(r)
// => abc@123;def@456

//remove
console.log('remove')

c1 = 'abc123'
c2 = 'abc123'
r = at.remove(c1, c2)
console.log(r)
// => ''

c1 = 'abc123;def456'
c2 = 'abc123'
r = at.remove(c1, c2)
console.log(r)
// => def456

c1 = 'abc123'
c2 = 'def456'
r = at.remove(c1, c2)
console.log(r)
// => abc123

c1 = 'abc123'
c2 = 'ghi789;jkl012'
r = at.remove(c1, c2)
console.log(r)
// => abc123

c1 = 'abc123'
c2 = 'abc123;jkl012'
r = at.remove(c1, c2)
console.log(r)
// => ''

c1 = 'abc123;def456'
c2 = 'ghi789;jkl012'
r = at.remove(c1, c2)
console.log(r)
// => abc123;def456

c1 = 'abc123;def456'
c2 = 'def456;jkl012'
r = at.remove(c1, c2)
console.log(r)
// => abc123

c1 = ''
c2 = 'ghi789'
r = at.remove(c1, c2)
console.log(r)
// => ''

c1 = ''
c2 = 'ghi789;jkl012'
r = at.remove(c1, c2)
console.log(r)
// => ''

c1 = 'abc@123'
c2 = 'abc@123'
r = at.remove(c1, c2)
console.log(r)
// => ''

c1 = 'abc@123;def@456'
c2 = 'abc@123'
r = at.remove(c1, c2)
console.log(r)
// => def@456

c1 = 'abc@123'
c2 = 'def@456'
r = at.remove(c1, c2)
console.log(r)
// => abc@123

c1 = 'abc@123'
c2 = 'ghi@789;jkl@012'
r = at.remove(c1, c2)
console.log(r)
// => abc@123

c1 = 'abc@123'
c2 = 'abc@123;jkl@012'
r = at.remove(c1, c2)
console.log(r)
// => ''

c1 = 'abc@123;def@456'
c2 = 'ghi@789;jkl@012'
r = at.remove(c1, c2)
console.log(r)
// => abc@123;def@456

c1 = 'abc@123;def@456'
c2 = 'def@456;jkl@012'
r = at.remove(c1, c2)
console.log(r)
// => abc@123

c1 = ''
c2 = 'ghi@789'
r = at.remove(c1, c2)
console.log(r)
// => ''

c1 = ''
c2 = 'ghi@789;jkl@012'
r = at.remove(c1, c2)
console.log(r)
// => ''

let at2 = attstr({ uniqItems: true, dlmItem: ',', dlmSep: '|' })

c = 'x1|abc@123|def@456,x2|ghi@789'
r = at2.parse(c)
console.log(r)
// => [
//   { item: 'x1|abc@123|def@456', table: 'x1', id: ['abc@123','def@456'] },
//   { item: 'x2|ghi@789', table: 'x2', id: 'ghi@789' }
// ]

let at3 = attstr({ uniqItems: true, dlmItem: ',', dlmSep: '|', keyTable: 'name', keyId: 'emails' })

c = 'x1|abc@123|def@456,x2|ghi@789'
r = at3.parse(c)
console.log(r)
// => [
//   { item: 'x1|abc@123|def@456', name: 'x1', emails: ['abc@123','def@456'] },
//   { item: 'x2|ghi@789', name: 'x2', emails: 'ghi@789' }
// ]

let at4 = attstr({ uniqItems: false })

c = ['abc@123', 'abc@123', 'def@456']
r = at4.join(c)
console.log(r)
// => 'abc@123;abc@123;def@456'

c = [{ table: 'abc', id: '123' }, { table: 'def', id: '456' }, { table: 'def', id: '456' }]
r = at4.join(c)
console.log(r)
// => 'abc@123;def@456;def@456'


c1 = 'abc123;ghi789'
c2 = 'abc123;def456'
r = at4.add(c1, c2)
console.log(r)
// => abc123;ghi789;abc123;def456

c1 = 'abc@123;ghi@789'
c2 = 'abc@123;def@456'
r = at4.add(c1, c2)
console.log(r)
// => abc@123;ghi@789;abc@123;def@456

Returns:

Type

Object

(static) b642obj(b64, optopt) → {*}

Description:

• base64字串轉任意資料

  Unit Test: Github

Source:

• b642obj.mjs, line 26

Example

console.log(b642obj('eyJhIjoxfQ=='))
// => { a: 1 }

console.log(b642obj(NaN, { returnWithStateAndMsg: true }))
// => { state: 'error', msg: 'invalid b64' }

Parameters:

Returns:

Type

*

(static) b642str(b64, optopt) → {String|Object}

Description:

• base64字串轉一般字串

  Unit Test: Github

Source:

• b642str.mjs, line 26

Example

console.log(b642str('dGVzdOS4reaWhw=='))
// => 'test中文'

Parameters:

Returns:

Type

String | Object

(static) b642u16arr(b64, optopt) → {Uint16Array|Object}

Description:

• base64字串轉Uint16Array

  以逐位元組(little-endian)方式解碼，為u16arr2b64之反向；不可經u8arr2u16arr轉換，該函數為逐元素轉換無法還原大於255之元素

  Unit Test: Github

Source:

• b642u16arr.mjs, line 24

Example

console.log(b642u16arr('CwBPAAYA'))
// => new Uint16Array([11, 79, 6])

Parameters:

Returns:

Type

Uint16Array | Object

(static) b642u8arr(b64, optopt) → {Uint8Array|Object}

Description:

• base64字串轉Uint8Array

  Unit Test: Github

Source:

• b642u8arr.mjs, line 42

Example

console.log(b642u8arr('AQItAA=='))
// => new Uint8Array([1, 2.3, '45', 'abc'])

Parameters:

Returns:

Type

Uint8Array | Object

(static) binstr(s, keys, mode) → {Boolean}

Description:

• 判斷字串s是否「任一出現於、全部包含於」字串陣列keys內元素

  Unit Test: Github

Source:

• binstr.mjs, line 22

Example

console.log(binstr('1.25abc', 'ab'))
// => true

Parameters:

Returns:

Type

Boolean

(static) blob2ab(bb) → {Promise}

Description:

• 前端Blob或input檔案物件轉ArrayBuffer資料陣列

  Unit Test: Github

Source:

• blob2ab.mjs, line 72

Example

need test in browser

let bb = new Blob([new Uint8Array([66, 97, 115])])
blob2ab(b)
    .then(function(ab){
        console.log(ab)
        // => ArrayBuffer(3) {
        //     [[Int8Array]]: Int8Array(3) [66, 97, 115]
        //     [[Uint8Array]]: Uint8Array(3) [66, 97, 115]
        //     byteLength: 3
        // }
    })

Parameters:

Returns:

Type

Promise

(static) blob2b64(bb) → {Promise}

Description:

• 前端Blob或input檔案物件轉Base64字串

  Unit Test: Github

Source:

• blob2b64.mjs, line 26

Example

need test in browser

let b64 = 'YWJj5ris6Kmm'
let u8a = b642u8arr(b64)
let bb = new Blob([u8a])
blob2b64(bb)
    .then(function(b64Out){
        console.log(b64Out)
        // => data:application/octet-stream;base64,YWJj5ris6Kmm
    })

Parameters:

Returns:

Type

Promise

(static) blob2str(bb) → {Promise}

Description:

• 前端Blob或input檔案物件轉字串

  Unit Test: Github

Source:

• blob2str.mjs, line 27

Example

need test in browser

let strIn = 'abc測試'
let b64 = str2b64(strIn)
let u8a = b642u8arr(b64)
let bb = new Blob([u8a])
blob2str(bb)
    .then(function(strOut){
        console.log(strOut)
        // => abc測試
    })

Parameters:

Returns:

Type

Promise

(static) blob2u8arr(bb) → {Promise}

Description:

• 前端Blob或input檔案物件轉Uint8Array資料陣列

  Unit Test: Github

Source:

• blob2u8arr.mjs, line 24

Example

need test in browser

let u8aIn = new Uint8Array([97, 98, 99, 230, 184, 172, 232, 169, 166])
let bb = new Blob([u8aIn])
blob2u8arr(bb)
    .then(function(u8aOut){
        console.log(u8aOut)
        // => Uint8Array(9) [97, 98, 99, 230, 184, 172, 232, 169, 166]
    })

Parameters:

Returns:

Type

Promise

(static) blobs2b64s(bbs) → {Promise}

Description:

• 前端Blob或input檔案物件陣列，逐一轉為各檔案之Base64資料

  Unit Test: Github

Source:

• blobs2b64s.mjs, line 27

Example

need test in browser

let b64 = 'YWJj5ris6Kmm'
let u8a = b642u8arr(b64)
let bb = new Blob([u8a])
let bbs = [bb]
blobs2b64s(bbs)
    .then(function(b64){
        console.log(b64)
        // => ["data:application/octet-stream;base64,YWJj5ris6Kmm"]
    })

Parameters:

Returns:

Type

Promise

(static) blobs2u8arrs(bbs) → {Promise}

Description:

• 前端Blob或input檔案物件陣列，逐一轉為各檔案之Uint8Array資料陣列

  Unit Test: Github

Source:

• blobs2u8arrs.mjs, line 28

Example

need test in browser

let u8a = new Uint8Array([97, 98, 99, 230, 184, 172, 232, 169, 166])
let bb = new Blob([u8a])
let bbs = [bb]
blobs2u8arrs(bbs)
    .then(function(u8as){
        console.log(u8as)
        // => [Uint8Array(9)]
        //      0: Uint8Array(9) [97, 98, 99, 230, 184, 172, 232, 169, 166]
        //      length: 1
    })

Parameters:

Returns:

Type

Promise

(static) bodyLog(c)

Description:

• 前端顯示log訊息，預設插入至body

  Unit Test: Github

Source:

• bodyLog.mjs, line 18

Example

bodyLog('show訊息')
// => 由html顯示'show訊息'

Parameters:

(static) browserView(data, type)

Description:

• 前端瀏覽器以分頁開啟指定數據如文字、圖片、影片、pdf等

  Unit Test: Github

Source:

• browserView.mjs, line 20

Example

need test in browser

let text = 'abc'
browserView(u8a, 'text/plain')

let u8a = new Uint8Array([66, 97, 115])
browserView(u8a, 'application/pdf')

Parameters:

(static) browserViewFromBlob(bb, type)

Description:

• 前端瀏覽器以分頁開啟blob數據如文字、圖片、影片、pdf等

  Unit Test: Github

Source:

• browserViewFromBlob.mjs, line 20

Example

need test in browser

let u8a = new Uint8Array([66, 97, 115])
let bb = new Blob([u8a])
browserView(bb, 'application/pdf')

Parameters:

(static) browserViewFromText(text)

Description:

• 前端瀏覽器以分頁開啟文字資料

  Unit Test: Github

Source:

• browserViewFromText.mjs, line 18

Example

need test in browser

let text = 'abc'
browserViewFromText(u8a)

Parameters:

(static) browserViewFromU8arr(u8a, type)

Description:

• 前端瀏覽器以分頁開啟Uint8Array數據如文字、圖片、影片、pdf等

  Unit Test: Github

Source:

• browserViewFromU8arr.mjs, line 19

Example

need test in browser

let u8a = new Uint8Array([66, 97, 115])
browserView(u8a, 'application/pdf')

Parameters:

(static) bs2u8arr(bs, optopt) → {Unit8Array|Object}

Description:

• BinaryString轉Unit8Array，BinaryString為UTF-16編碼

  Unit Test: Github

Source:

• bs2u8arr.mjs, line 21

Example

console.log(bs2u8arr('abc'))
// => new Uint8Array([97, 98, 99])

Parameters:

Returns:

Type

Unit8Array | Object

(static) bufRead(buffer, offset, isBE, mLen, nBytes) → {Number}

Description:

• 讀取Uint8Array(Nodejs,Browser)或Buffer(Nodejs)資料

  Fork: buffer_ieee754

  Unit Test: Github

Source:

• bufRead.mjs, line 31

Example

let offset = 0
let isBE = true
let mLen = 52
let nBytes = 8
let b = new Uint8Array([66, 117, 16, 240, 246, 48, 64, 0]) //1447656645380
let j = bufRead(b, offset, isBE, mLen, nBytes)
console.log(j)
// => 1447656645380

Parameters:

Returns:

Type

Number

(static) bufReadDbl(buffer, offsetopt, isBEopt, mLenopt, nBytesopt) → {Number}

Description:

• 讀取Uint8Array(Nodejs,Browser)或Buffer(Nodejs)內的浮點數資料

  Unit Test: Github

Source:

• bufReadDbl.mjs, line 23

Example

let b = new Uint8Array([66, 117, 16, 240, 246, 48, 64, 0]) //1447656645380
let j = bufReadDbl(b)
console.log(j)
// => 1447656645380

Parameters:

Returns:

Type

Number

(static) bufWrite(value, buffer, offset, isBE, mLen, nBytes)

Description:

• 寫入Uint8Array(Nodejs,Browser)或Buffer(Nodejs)資料

  Fork: buffer_ieee754

  Unit Test: Github

Source:

• bufWrite.mjs, line 37

Example

let offset = 0
let isBE = true
let mLen = 52
let nBytes = 8

let i = 1447656645380 //new Uint8Array([66, 117, 16, 240, 246, 48, 64, 0])
let b = Buffer.alloc(8)
bufWrite(i, b, offset, isBE, mLen, nBytes)
console.log(b)
// >= <Buffer 42 75 10 f0 f6 30 40 00>
console.log(new Uint8Array(b))
// => Uint8Array [66, 117, 16, 240, 246, 48, 64, 0]

Parameters:

(static) bufWriteDbl(value, buffer, offsetopt, isBEopt, mLenopt, nBytesopt) → {Number}

Description:

• 寫入Uint8Array(Nodejs,Browser)或Buffer(Nodejs)內的浮點數資料，需先依照nBytes宣告Uint8Array或Buffer空間

  Unit Test: Github

Source:

• bufWriteDbl.mjs, line 27

Example

let i = 1447656645380 //new Uint8Array([66, 117, 16, 240, 246, 48, 64, 0])
let b = Buffer.alloc(8)
bufWriteDbl(i, b)
console.log(b)
// >= <Buffer 42 75 10 f0 f6 30 40 00>
console.log(new Uint8Array(b))
// => Uint8Array [66, 117, 16, 240, 246, 48, 64, 0]

Parameters:

Returns:

Type

Number

(static) cache(optopt) → {Object}

Description:

• 非同步函數快取，通過指定key代表函數與其輸入、代為執行與快取。快取可設定失效時間，超過失效時間則重新執行與再更新快取

  Unit Test: Github

Source:

• cache.mjs, line 542

Example

async function topAsync() {

    function test1() {
        return new Promise((resolve, reject) => {
            let ms = []

            let oc = cache()

            // oc.on('message', function(msg) {
            //     console.log('message', msg)
            // })
            // oc.on('error', function(msg) {
            //     console.log('error', msg)
            // })

            let i = 0
            let j = 0
            function fun(v1, v2) {
                i++
                console.log('call fun, count=' + i)
                ms.push('call fun, count=' + i)
                return new Promise(function(resolve, reject) {
                    setTimeout(function() {
                        j++
                        ms.push(v1 + '|' + v2 + ', count=' + j)
                        resolve(v1 + '|' + v2 + ', count=' + j)
                    }, 300)
                })
            }

            oc.set('fun', { fun, inputs: ['inp1', 'inp2'], timeExpired: 1200 }) //快取1200ms, 但第1次執行就需要300ms, 故執行完畢後只會再保留800ms
            setTimeout(function() {
                //第1次呼叫(1ms), 此時沒有快取只能執行取值, 執行300ms後回應, 會取得第1次結果(count=1)
                oc.get('fun')
                    .then(function(msg) {
                        console.log('fun 1st', msg)
                        ms.push('fun 1st', msg)
                    })
                    .catch(function(err) {
                        console.log('fun 1st error', err)
                        ms.push('fun 1st error', String(err))
                    })
            }, 1)
            setTimeout(function() {
                //第2次呼叫(50ms), 此時第1次呼叫還沒完成(要到300ms), 故get會共用執行中的promise等待, 於第1次執行完畢(300ms)時一併取得第1次結果(count=1)
                oc.get('fun')
                    .then(function(msg) {
                        console.log('fun 2nd', msg)
                        ms.push('fun 2nd', msg)
                    })
                    .catch(function(err) {
                        console.log('fun 2nd error', err)
                        ms.push('fun 2nd error', String(err))
                    })
            }, 50)
            setTimeout(function() {
                //第3次呼叫(250ms), 此時第1次呼叫還沒完成(要到300ms), 同第2次呼叫共用執行中的promise等待, 於300ms時一併取得第1次結果(count=1)
                oc.get('fun')
                    .then(function(msg) {
                        console.log('fun 3rd', msg)
                        ms.push('fun 3rd', msg)
                    })
                    .catch(function(err) {
                        console.log('fun 3rd error', err)
                        ms.push('fun 3rd error', String(err))
                    })
            }, 250)
            setTimeout(function() {
                //第4次呼叫(500ms), 此時第1次呼叫已結束(300ms), 且第1次快取(count=1)未過期(要到1200ms), 故get可拿到第1次計算的快取(count=1)
                oc.get('fun')
                    .then(function(msg) {
                        console.log('fun 4th', msg)
                        ms.push('fun 4th', msg)
                    })
                    .catch(function(err) {
                        console.log('fun 4th error', err)
                        ms.push('fun 4th error', String(err))
                    })
            }, 500)
            setTimeout(function() {
                //第5次呼叫(1300ms), 此時第1次快取(count=1)已過期(1200ms), 故重新執行取值(1300~1600ms執行, 2500ms過期), 於1600ms取得第2次結果(count=2)
                oc.get('fun')
                    .then(function(msg) {
                        console.log('fun 5th', msg)
                        ms.push('fun 5th', msg)
                    })
                    .catch(function(err) {
                        console.log('fun 5th error', err)
                        ms.push('fun 5th error', String(err))
                    })
            }, 1300)
            setTimeout(function() {
                //第6次呼叫(1600ms), 此時第2次執行剛好結束(1600ms), 若尚未結束則共用執行中的promise等待, 若已結束則直接拿快取, 皆會取得第2次結果(count=2)
                oc.get('fun')
                    .then(function(msg) {
                        console.log('fun 6th', msg)
                        ms.push('fun 6th', msg)
                    })
                    .catch(function(err) {
                        console.log('fun 6th error', err)
                        ms.push('fun 6th error', String(err))
                    })
            }, 1600)

            setTimeout(function() {
                resolve(ms)
            }, 2400)

        })
    }
    console.log('test1')
    let r1 = await test1()
    console.log(JSON.stringify(r1))
    // test1
    // call fun, count=1
    // fun 1st inp1|inp2, count=1
    // fun 2nd inp1|inp2, count=1
    // fun 3rd inp1|inp2, count=1
    // fun 4th inp1|inp2, count=1
    // call fun, count=2
    // fun 5th inp1|inp2, count=2
    // fun 6th inp1|inp2, count=2
    // ["call fun, count=1","inp1|inp2, count=1","fun 1st","inp1|inp2, count=1","fun 2nd","inp1|inp2, count=1","fun 3rd","inp1|inp2, count=1","fun 4th","inp1|inp2, count=1","call fun, count=2","inp1|inp2, count=2","fun 5th","inp1|inp2, count=2","fun 6th","inp1|inp2, count=2"]

    function test2() {
        return new Promise((resolve, reject) => {
            let ms = []

            let oc = cache()

            // oc.on('message', function(msg) {
            //     console.log('message', msg)
            // })
            // oc.on('error', function(msg) {
            //     console.log('error', msg)
            // })

            let i = 0
            let j = 0
            function fun(v1, v2) {
                i++
                console.log('call fun, count=' + i)
                ms.push('call fun, count=' + i)
                return new Promise(function(resolve, reject) {
                    setTimeout(function() {
                        j++
                        ms.push(v1 + '|' + v2 + ', count=' + j)
                        resolve(v1 + '|' + v2 + ', count=' + j)
                    }, 300)
                })
            }

            //首次getProxy即註冊並執行取值(0~300ms), 快取1200ms, 但第1次執行就需要300ms, 故執行完畢後只會再保留800ms
            //因useCacheWhenError預設false, 函數執行失敗時get與getProxy會reject, 故此種不取值之呼叫仍須接catch, 否則會產生unhandled rejection
            oc.getProxy('fun', { fun, inputs: ['inp1', 'inp2'], timeExpired: 1200 })
                .catch(function(err) {
                    console.log('getProxy error', err)
                })
            setTimeout(function() {
                //第1次呼叫(1ms), 此時首次getProxy執行中, 會共用執行中的promise等待, 於300ms取得第1次結果(count=1)
                oc.getProxy('fun', { fun, inputs: ['inp1', 'inp2'], timeExpired: 1200 })
                    .then(function(msg) {
                        console.log('fun 1st', msg)
                        ms.push('fun 1st', msg)
                    })
                    .catch(function(err) {
                        console.log('fun 1st error', err)
                        ms.push('fun 1st error', String(err))
                    })
            }, 1)
            setTimeout(function() {
                //第2次呼叫(100ms), 此時執行中, 同第1次呼叫共用執行中的promise等待, 於300ms取得第1次結果(count=1)
                oc.getProxy('fun', { fun, inputs: ['inp1', 'inp2'], timeExpired: 1200 })
                    .then(function(msg) {
                        console.log('fun 2nd', msg)
                        ms.push('fun 2nd', msg)
                    })
                    .catch(function(err) {
                        console.log('fun 2nd error', err)
                        ms.push('fun 2nd error', String(err))
                    })
            }, 100)
            setTimeout(function() {
                //第3次呼叫(500ms), 此時已有快取, 直接取得第1次結果(count=1)
                oc.getProxy('fun', { fun, inputs: ['inp1', 'inp2'], timeExpired: 1200 })
                    .then(function(msg) {
                        console.log('fun 3rd', msg)
                        ms.push('fun 3rd', msg)
                    })
                    .catch(function(err) {
                        console.log('fun 3rd error', err)
                        ms.push('fun 3rd error', String(err))
                    })
            }, 500)
            setTimeout(function() {
                //第4次呼叫(1300ms), 此時第1次快取(count=1)已失效(1200ms), 會重新呼叫函數取值(1300~1600ms), 取得第2次結果(count=2)
                oc.getProxy('fun', { fun, inputs: ['inp1', 'inp2'], timeExpired: 1200 })
                    .then(function(msg) {
                        console.log('fun 4th', msg)
                        ms.push('fun 4th', msg)
                    })
                    .catch(function(err) {
                        console.log('fun 4th error', err)
                        ms.push('fun 4th error', String(err))
                    })
            }, 1300)

            setTimeout(function() {
                resolve(ms)
            }, 1700)

        })
    }
    console.log('test2')
    let r2 = await test2()
    console.log(JSON.stringify(r2))
    // test2
    // call fun, count=1
    // fun 1st inp1|inp2, count=1
    // fun 2nd inp1|inp2, count=1
    // fun 3rd inp1|inp2, count=1
    // call fun, count=2
    // fun 4th inp1|inp2, count=2
    // ["call fun, count=1","inp1|inp2, count=1","fun 1st","inp1|inp2, count=1","fun 2nd","inp1|inp2, count=1","fun 3rd","inp1|inp2, count=1","call fun, count=2","inp1|inp2, count=2","fun 4th","inp1|inp2, count=2"]

    function test3() {
        return new Promise((resolve, reject) => {
            let ms = []

            let oc = cache()

            // oc.on('message', function(msg) {
            //     console.log('message', msg)
            // })
            // oc.on('error', function(msg) {
            //     console.log('error', msg)
            // })

            let i = 0
            let j = 0
            function fun(v1, v2) {
                i++
                console.log('call fun, count=' + i)
                ms.push('call fun, count=' + i)
                return new Promise(function(resolve, reject) {
                    setTimeout(function() {
                        j++
                        ms.push(v1 + '|' + v2 + ', count=' + j)
                        resolve(v1 + '|' + v2 + ', count=' + j)
                    }, 300)
                })
            }

            //首次getProxy即註冊並執行取值(0~300ms), 快取1500ms, 但第1次執行就需要300ms, 故執行完畢後只會再保留1200ms
            //因useCacheWhenError預設false, 函數執行失敗時get與getProxy會reject, 故此種不取值之呼叫仍須接catch, 否則會產生unhandled rejection
            oc.getProxy('fun', { fun, inputs: ['inp1', 'inp2'], timeExpired: 1500 })
                .catch(function(err) {
                    console.log('getProxy error', err)
                })
            setTimeout(function() {
                //第1次呼叫(延遲1ms), 此時首次getProxy執行中, 會共用執行中的promise等待, 於300ms取得第1次結果(count=1)
                oc.getProxy('fun', { fun, inputs: ['inp1', 'inp2'], timeExpired: 1500 })
                    .then(function(msg) {
                        console.log('fun 1st', msg)
                        ms.push('fun 1st', msg)
                    })
                    .catch(function(err) {
                        console.log('fun 1st error', err)
                        ms.push('fun 1st error', String(err))
                    })
            }, 1)
            setTimeout(function() {
                //第2次呼叫(延遲200ms), 此時執行中, 同第1次呼叫共用執行中的promise等待, 於300ms取得第1次結果(count=1), 早於被強制更新(1100ms)
                oc.getProxy('fun', { fun, inputs: ['inp1', 'inp2'], timeExpired: 1500 })
                    .then(function(msg) {
                        console.log('fun 2nd', msg)
                        ms.push('fun 2nd', msg)
                    })
                    .catch(function(err) {
                        console.log('fun 2nd error', err)
                        ms.push('fun 2nd error', String(err))
                    })
            }, 200)
            setTimeout(function() {
                //第3次呼叫(500ms), 此時已有快取, 直接取得第1次結果(count=1)
                oc.getProxy('fun', { fun, inputs: ['inp1', 'inp2'], timeExpired: 1500 })
                    .then(function(msg) {
                        console.log('fun 3rd', msg)
                        ms.push('fun 3rd', msg)
                    })
                    .catch(function(err) {
                        console.log('fun 3rd error', err)
                        ms.push('fun 3rd error', String(err))
                    })
            }, 500)
            setTimeout(function() {
                //更新快取值(延遲1100ms), 快取值為abc, 快取時間也被更新至此時, 故會重新計算1500ms才會失效
                oc.update('fun', 'abc')
                console.log('fun update', 'abc')
                ms.push('fun update', 'abc')
            }, 1100)
            setTimeout(function() {
                //第4次呼叫(延遲1300ms), 此時會取得被強制更新之快取值(abc), 快取還剩1300ms才失效(也就是在2600ms失效)
                oc.getProxy('fun', { fun, inputs: ['inp1', 'inp2'], timeExpired: 1500 })
                    .then(function(msg) {
                        console.log('fun 4th', msg)
                        ms.push('fun 4th', msg)
                    })
                    .catch(function(err) {
                        console.log('fun 4th error', err)
                        ms.push('fun 4th error', String(err))
                    })
            }, 1300)
            setTimeout(function() {
                //第5次呼叫(延遲2700ms), 此時被強制更新之快取值(abc)已失效, 會重新呼叫函數取值, 取得第2次結果(count=2)
                oc.getProxy('fun', { fun, inputs: ['inp1', 'inp2'], timeExpired: 1500 })
                    .then(function(msg) {
                        console.log('fun 5th', msg)
                        ms.push('fun 5th', msg)
                    })
                    .catch(function(err) {
                        console.log('fun 5th error', err)
                        ms.push('fun 5th error', String(err))
                    })
            }, 2700)

            setTimeout(function() {
                resolve(ms)
            }, 3100)

        })
    }
    console.log('test3')
    let r3 = await test3()
    console.log(JSON.stringify(r3))
    // test3
    // call fun, count=1
    // fun 1st inp1|inp2, count=1
    // fun 2nd inp1|inp2, count=1
    // fun 3rd inp1|inp2, count=1
    // fun update abc
    // fun 4th abc
    // call fun, count=2
    // fun 5th inp1|inp2, count=2
    // ["call fun, count=1","inp1|inp2, count=1","fun 1st","inp1|inp2, count=1","fun 2nd","inp1|inp2, count=1","fun 3rd","inp1|inp2, count=1","fun update","abc","fun 4th","abc","call fun, count=2","inp1|inp2, count=2","fun 5th","inp1|inp2, count=2"]

    async function test4() {
        //執行中clear與update: clear於執行中呼叫仍有效(執行中之呼叫取得本次結果, 下次get重新執行); update於執行中呼叫以update之值為準, 不被執行結果覆寫
        let oc = cache()

        let n = 0
        let fun = () => {
            n++
            return new Promise(function(resolve, reject) {
                setTimeout(function() {
                    resolve('count=' + n)
                }, 100)
            })
        }

        //clear於執行中
        oc.set('clear', { fun, inputs: [], timeExpired: 30000 })
        let pm1 = oc.get('clear')
        await new Promise((resolve) => setTimeout(resolve, 10))
        oc.clear('clear')
        let v1 = await pm1 //執行中之呼叫取得本次結果(count=1)
        let v2 = await oc.get('clear') //clear有效, 重新執行(count=2)
        let v3 = await oc.get('clear') //快取(count=2)

        //update於執行中
        n = 0
        oc.set('update', { fun, inputs: [], timeExpired: 30000 })
        let pm2 = oc.get('update')
        await new Promise((resolve) => setTimeout(resolve, 10))
        oc.update('update', 'abc')
        let v4 = await pm2 //以update之值為準(abc)
        let v5 = await oc.get('update') //快取(abc), 不重新執行

        return { v1, v2, v3, v4, v5, n }
    }
    console.log('test4')
    let r4 = await test4()
    console.log(JSON.stringify(r4))
    // test4
    // {"v1":"count=1","v2":"count=2","v3":"count=2","v4":"abc","v5":"abc","n":1}

    async function test5() {
        //timeFrom: 預設'start'自fun開始起算, 'end'自fun結束起算; fun耗時200ms, timeExpired 220ms, 結束後再隔120ms取值: 'start'時已過期(320>220)重新執行, 'end'時未過期(120<220)取快取
        let oc = cache()

        let n = 0
        let fun = () => {
            n++
            return new Promise(function(resolve, reject) {
                setTimeout(function() {
                    resolve('count=' + n)
                }, 200)
            })
        }

        oc.set('start', { fun, inputs: [], timeExpired: 220 }) //預設timeFrom='start'
        let v1 = await oc.get('start')
        await new Promise((resolve) => setTimeout(resolve, 120))
        let v2 = await oc.get('start')

        n = 0
        oc.set('end', { fun, inputs: [], timeExpired: 220, timeFrom: 'end' })
        let v3 = await oc.get('end')
        await new Promise((resolve) => setTimeout(resolve, 120))
        let v4 = await oc.get('end')

        return { v1, v2, v3, v4 }
    }
    console.log('test5')
    let r5 = await test5()
    console.log(JSON.stringify(r5))
    // test5
    // {"v1":"count=1","v2":"count=2","v3":"count=1","v4":"count=1"}

    async function test6() {
        //useCacheWhenError: 預設false則失敗不寫入快取, 錯誤拋給執行者與等待中之併發呼叫, 下次get重新執行; 設true則失敗仍寫入快取(值為undefined)並保留整個timeExpired, 呼叫端取得undefined而非收到錯誤; 兩者error事件皆發出
        let oc = cache()

        let errs = []
        oc.on('error', function(msg) {
            errs.push(msg.key + ':' + msg.msg.message)
        })

        let n = 0
        let fun = () => {
            n++
            return new Promise(function(resolve, reject) {
                setTimeout(function() {
                    if (n <= 2) {
                        reject(new Error('down' + n))
                    }
                    else {
                        resolve('up' + n)
                    }
                }, 50)
            })
        }

        oc.set('fun', { fun, inputs: [], timeExpired: 30000 }) //預設useCacheWhenError=false

        //第1次執行失敗: 執行者與等待中之併發呼叫皆收到reject
        let pm1 = oc.get('fun').then((v) => 'ok:' + v).catch((e) => 'err:' + e.message)
        await new Promise((resolve) => setTimeout(resolve, 10))
        let pm2 = oc.get('fun').then((v) => 'ok:' + v).catch((e) => 'err:' + e.message)
        let r1 = await pm1
        let r2 = await pm2

        //第2次執行仍失敗(失敗不寫入快取故重新執行)
        let r3 = await oc.get('fun').then((v) => 'ok:' + v).catch((e) => 'err:' + e.message)

        //第3次執行成功並快取
        let r4 = await oc.get('fun').then((v) => 'ok:' + v).catch((e) => 'err:' + e.message)
        let r5 = await oc.get('fun').then((v) => 'ok:' + v).catch((e) => 'err:' + e.message)

        //useCacheWhenError=true時, 失敗不拋錯而是取得undefined, 且快取整個timeExpired故不重新執行
        let m = 0
        let funErr = async () => {
            m++
            throw new Error('always down')
        }
        oc.set('funErr', { fun: funErr, inputs: [], timeExpired: 30000, useCacheWhenError: true })
        let c1 = await oc.get('funErr').then((v) => 'ok:' + v).catch((e) => 'err:' + e.message)
        let c2 = await oc.get('funErr').then((v) => 'ok:' + v).catch((e) => 'err:' + e.message)

        await new Promise((resolve) => setTimeout(resolve, 50)) //error事件以timer脫勾發送, 稍待

        return { rs: [r1, r2, r3, r4, r5], n, cs: [c1, c2], m, errs }
    }
    console.log('test6')
    let r6 = await test6()
    console.log(JSON.stringify(r6))
    // test6
    // {"rs":["err:down1","err:down1","err:down2","ok:up3","ok:up3"],"n":3,"cs":["ok:undefined","ok:undefined"],"m":1,"errs":["fun:down1","fun:down2","funErr:always down"]}

    async function test7() {
        //useCloneDeep: 預設true回傳複製值, 呼叫端修改不影響快取; 設false則直接回傳快取內之值(為同一參照), 可省去大量數據之複製開銷, 但呼叫端須自行確保不修改
        let oc = cache()

        let fun = async () => {
            return { a: 1 }
        }

        //預設true
        oc.set('clone', { fun, inputs: [], timeExpired: 30000 })
        let v1 = await oc.get('clone')
        v1.a = 2 //修改所取得之值
        let v2 = await oc.get('clone') //快取未受影響

        //get傳入useCloneDeep=false
        oc.set('noclone', { fun, inputs: [], timeExpired: 30000 })
        let v3 = await oc.get('noclone', { useCloneDeep: false })
        let v4 = await oc.get('noclone', { useCloneDeep: false })

        //set時設定useCloneDeep=false, get未指定則沿用set之設定
        oc.set('setnoclone', { fun, inputs: [], timeExpired: 30000, useCloneDeep: false })
        let v5 = await oc.get('setnoclone')
        let v6 = await oc.get('setnoclone')

        //get之設定可覆寫set之設定
        let v7 = await oc.get('setnoclone', { useCloneDeep: true })

        return { v2, sameNoclone: v3 === v4, sameSetnoclone: v5 === v6, sameOverride: v5 === v7 }
    }
    console.log('test7')
    let r7 = await test7()
    console.log(JSON.stringify(r7))
    // test7
    // {"v2":{"a":1},"sameNoclone":true,"sameSetnoclone":true,"sameOverride":false}

}
topAsync().catch(() => {})

Parameters:

Returns:

Type

Object

(static) cacheBd(fun, optopt) → {Object}

Description:

• 非同步函數快取，封裝指定非同步函數與再提供取用快取版

  get須定期或高執行率，getFromCache雖能自己自動調用，但僅第1次取得後數據就無法更新，此會導致一直取得舊數據

  Unit Test: Github

Source:

• cacheBd.mjs, line 178

Example

let test1 = async () => {
    let ms = []

    let fun = async(p1, p2) => {
        await delay(300)
        return `${p1}:${p2}`
    }

    let bc = cacheBd(fun)
    let execFun = bc.get
    let execFunCache = bc.getFromCache

    let pm1 = execFunCache(123, 'abc') //pm1執行取得快取, 因無快取將持續等待
    pm1
        .then((res) => {
            // console.log('res', res)
            ms.push({ result: `pm1-${res}` })
        })

    let pm2 = execFun(4.56, 'def') //pm2執行原本函數與使用輸入, 會最先回傳, 且更新快取給等待或之後取得快取使用
    pm2
        .then((res) => {
            // console.log('res', res)
            ms.push({ result: `pm2-${res}` })
        })

    let pm3 = execFunCache(78.9, 'xyz') //pm3執行取得快取, 因已有快取將直接取得快取
    pm3
        .then((res) => {
            // console.log('res', res)
            ms.push({ result: `pm3-${res}` })
        })

    await Promise.all([pm1, pm2, pm3])
    // console.log('rs', rs)

    console.log('ms', ms)
    return ms
}
await test1()
// ms [
//   { result: 'pm2-4.56:def' },
//   { result: 'pm1-4.56:def' },
//   { result: 'pm3-4.56:def' }
// ]

let test2 = async () => {
    let ms = []

    let fun = async(p1, p2) => {
        await delay(300)
        return `${p1}:${p2}`
    }

    let bc = cacheBd(fun)
    let execFun = bc.get
    let execFunCache = bc.getFromCache

    setTimeout(() => {
        console.log('pm1 exec..')
        let pm1 = execFunCache(123, 'abc') //pm1執行取得快取, 因無快取將持續等待
        pm1
            .then((res) => {
                console.log('pm1 then', res)
                ms.push({ result: `pm1-${res}` })
            })
    }, 1)

    setTimeout(() => {
        console.log('pm2 exec..')
        let pm2 = execFun(4.56, 'def') //1000ms後, pm2執行原本函數與使用輸入, 會最先回傳, 且更新快取給等待或之後取得快取使用
        pm2
            .then((res) => {
                console.log('pm2 then', res)
                ms.push({ result: `pm2-${res}` })
            })
    }, 1000)

    setTimeout(() => {
        console.log('pm3 exec..')
        let pm3 = execFunCache(78.9, 'xyz') //pm3執行取得快取, 因已有快取將直接取得快取
        pm3
            .then((res) => {
                console.log('pm3 then', res)
                ms.push({ result: `pm3-${res}` })
            })
    }, 3000)

    await delay(5000)

    console.log('ms', ms)
    return ms
}
await test2()
// ms [
//   { result: 'pm2-4.56:def' },
//   { result: 'pm1-4.56:def' },
//   { result: 'pm3-4.56:def' }
// ]

let test3 = async () => {
    let ms = []

    let fun = async(p1, p2) => {
        await delay(300)
        return `${p1}:${p2}`
    }

    let bc = cacheBd(fun)
    let execFun = bc.get
    let execFunCache = bc.getFromCache

    setTimeout(() => {
        console.log('pm1 exec..')
        let pm1 = execFunCache(123, 'abc') //pm1執行取得快取, 因無快取將持續等待, 3000ms將執行get與自己的輸入, 並最先回傳
        pm1
            .then((res) => {
                console.log('pm1 then', res)
                ms.push({ result: `pm1-${res}` })
            })
    }, 1)

    setTimeout(() => {
        console.log('pm2 exec..')
        let pm2 = execFun(4.56, 'def') //3500ms後, pm2執行原本函數與使用輸入, 計算完畢則會覆蓋快取, 此快取將再給等待或之後取得快取使用
        pm2
            .then((res) => {
                console.log('pm2 then', res)
                ms.push({ result: `pm2-${res}` })
            })
    }, 3500)

    setTimeout(() => {
        console.log('pm3 exec..')
        let pm3 = execFunCache(78.9, 'xyz') //pm3執行取得快取, 因已有快取將直接取得快取
        pm3
            .then((res) => {
                console.log('pm3 then', res)
                ms.push({ result: `pm3-${res}` })
            })
    }, 4500)

    await delay(6500)

    console.log('ms', ms)
    return ms
}
await test3()
// ms [
//   { result: 'pm1-123:abc' },
//   { result: 'pm2-4.56:def' },
//   { result: 'pm3-4.56:def' }
// ]

Parameters:

Returns:

Type

Object

(static) cacheSt(optopt) → {Object}

Description:

• 非同步狀態旗標快取，含TTL與互斥/同步原語，可用於在單一process內協調非同步動作之執行順序與資源獨占

  Unit Test: Github

Source:

• cacheSt.mjs, line 99

Example

let test1 = async () => {
    let ms = []

    let cs = cacheSt({ timeExpire: 10000 })

    //案例: mutex取得與釋放
    let b1 = cs.checkWithSet('myLock') //第一次取得lock, 回true
    ms.push({ '1st checkWithSet': b1 })
    let b2 = cs.checkWithSet('myLock') //第二次嘗試, 已被占用回false
    ms.push({ '2nd checkWithSet': b2 })
    await cs.del('myLock')             //釋放lock
    let b3 = cs.checkWithSet('myLock') //釋放後可再取
    ms.push({ 'after del checkWithSet': b3 })

    cs.clear() //結束時停止TTL偵測timer
    console.log('ms', ms)
    return ms
}
await test1()
// ms [
//   { '1st checkWithSet': true },
//   { '2nd checkWithSet': false },
//   { 'after del checkWithSet': true }
// ]

let test2 = async () => {
    let ms = []

    let cs = cacheSt({ timeExpire: 10000 })

    //案例: 多key原子占用並執行函數, 結束自動釋放
    let r = await cs.setWithFree(['lockA', 'lockB'], async () => {
        ms.push({ inside: 'fn running' })
        return 'done'
    })
    ms.push({ result: r })
    ms.push({ 'lockA after': await cs.check('lockA') }) //已自動釋放
    ms.push({ 'lockB after': await cs.check('lockB') }) //已自動釋放

    cs.clear()
    console.log('ms', ms)
    return ms
}
await test2()
// ms [
//   { inside: 'fn running' },
//   { result: 'done' },
//   { 'lockA after': false },
//   { 'lockB after': false }
// ]

let test3 = async () => {
    let ms = []

    let cs = cacheSt({ timeExpire: 10000 })

    //案例: 等待key出現 (條件變數模式)
    setTimeout(() => {
        cs.set('ready', 'data-x')
    }, 200)

    await cs.waitExist('ready', { attemptNum: 30, timeInterval: 100 }) //3秒內等候ready出現
    let v = await cs.get('ready')
    ms.push({ 'after waitExist': v })

    cs.clear()
    console.log('ms', ms)
    return ms
}
await test3()
// ms [
//   { 'after waitExist': 'data-x' }
// ]

Parameters:

Returns:

Type

Object

(static) cbol(v) → {Boolean}

Description:

• 布林值或字串轉布林值

  Unit Test: Github

Source:

• cbol.mjs, line 56

Example

console.log(cbol(true))
// => true

console.log(cbol(false))
// => false

console.log(cbol(0))
// => false

console.log(cbol(1))
// => true

console.log(cbol('true'))
// => true

console.log(cbol('tRuE'))
// => true

console.log(cbol('TRUE'))
// => true

console.log(cbol('abc'))
// => false

console.log(cbol(''))
// => false

console.log(cbol([]))
// => false

console.log(cbol({}))
// => false

console.log(cbol(null))
// => false

console.log(cbol(undefined))
// => false

Parameters:

Returns:

Type

Boolean

(static) cdbl(v) → {Number}

Description:

• 數字或字串轉浮點數 若輸入非數字則回傳0

  Unit Test: Github

Source:

• cdbl.mjs, line 19

Example

console.log(cdbl('25'))
// => 25

Parameters:

Returns:

Type

Number

(static) ceil(v, idigopt) → {Number}

Description:

• 數字或字串無條件進位至指定位數(0位為整數)

  Unit Test: Github

Source:

• ceil.mjs, line 66

Example

console.log(ceil(1.5))
// => 2

console.log(ceil('1.5'))
// => 2

console.log(ceil(-1.5))
// => -1

console.log(ceil('125abc'))
// => ''

console.log(ceil(9.83501, 2))
// => 9.84

console.log(ceil(9.8350, 2))
// => 9.84

console.log(ceil(9.82501, 2))
// => 9.83

console.log(ceil(9.8250, 2))
// => 9.83

console.log(ceil(9.8249, 2))
// => 9.83

console.log(ceil(12.6449, 2))
// => 12.65

console.log(ceil(12.645, 2))
// => 12.65

console.log(ceil(12.6451, 2))
// => 12.65

console.log(ceil(12.65, 2))
// => 12.65

console.log(ceil(12.64, 2))
// => 12.64

console.log(ceil(12.6, 2))
// => 12.6

console.log(ceil(12, 2))
// => 12

Parameters:

Returns:

Type

Number

(static) cfilesize(b) → {String}

Description:

• 檔案大小(bytes)自動轉換單位 可調整檔案大小為b,kb,mb,gb，並添加單位 若輸入不是數字或字串時則回傳空字串

  Unit Test: Github

Source:

• cfilesize.mjs, line 33

Example

console.log(cfilesize(0))
// => '0.0 b'

console.log(cfilesize(100))
// => '100.0 b'

console.log(cfilesize(2048))
// => '2.0 kb'

console.log(cfilesize(2000000))
// => '1.9 mb'

console.log(cfilesize(2000000000))
// => '1.9 gb'

Parameters:

Returns:

Type

String

(static) cfinancial(v, idigopt) → {String}

Description:

• 數字或字串轉金融格式(百分位添加逗號)表示 若輸入不是數字或字串時則回傳空字串

  Unit Test: Github

Source:

• cfinancial.mjs, line 27

Example

console.log(cfinancial(0.123456789, 3))
// => '0.123'

console.log(cfinancial(1234567.89))
// => '1,234,568'

console.log(cfinancial(1234567.89, 1))
// => '1,234,567.9'

Parameters:

Returns:

Type

String

(static) chkOrmData(data, optopt) → {null|Object}

Description:

• w-orm系列寫入資料(鍵名與字串值，含巢狀物件與陣列元素)之良構檢核，回傳null(合格)或{ reason, path }

  輸入為各後端於複製(如cloneDeep)後、補主鍵與加欄位前之寫入資料(單一文件、文件陣列或任何值)，本函數不修改輸入(但會呼叫可列舉存取器，見第7點)，並假設後端其後寫入的就是被檢查之值；存取器屬性(自有或繼承之可列舉者)於檢核時呼叫其getter一次取值，有狀態之getter須由後端於複製後轉為資料屬性。

  1. 走訪範圍：一般物件與類別實例之自有可列舉字串鍵(鍵名與值)及繼承自Object.prototype以外原型之可列舉字串鍵(lodash merge、sequelize update、mdb取值皆經原型鏈，自有同名或較近原型同名者含不可列舉者遮蔽之)、陣列元素(依索引)、Map之項目(字串鍵、物件鍵之內容與值，逐項迭代)、Set之元素、String包裝物件之字串值與其額外屬性(字元索引鍵除外)、RegExp之source、Error之name/message/cause；Map、Set、RegExp、Error另走訪其自有與繼承之可列舉屬性；被後端自動轉成文字之函數(原始碼)與Symbol值(描述)；字串經chkOrmStr檢核，預設只檢孤立代理(值之NUL不檢查，opt.nul為true時一併檢查NUL)。內建物件依內部槽判型(與標籤無關，標籤被改寫者亦然；原型為Object.prototype或null者直接當一般物件)。

  2. 略過：Date、TypedArray、ArrayBuffer、SharedArrayBuffer、DataView、Buffer(整個物件，連其上自有額外屬性)、數字、布林、null、undefined、BigInt、Symbol鍵、不可列舉鍵、陣列之洞與非索引屬性、Object.prototype上之屬性、Number/Boolean包裝與Promise/WeakMap/WeakSet(無可列舉內容)；toJSON或自訂序列化之輸出不檢查。

  3. 走訪順序固定為文件順序(深度優先)：同一物件內鍵名先於其值(自有鍵名、由近至遠之繼承鍵名、自有值、繼承值)，各值依自有鍵序(陣列依索引、整數樣鍵依引擎規定先於其他鍵)；回傳首個不合格處。

  4. 迭代走訪(顯式堆疊，不遞迴)，深度、節點數與字串長度皆不設上限；循環參照與共享參照安全，同一物件出現多處只走訪一次(路徑取首次出現處)；稀疏陣列依實際元素走訪，成本不隨length；Map、Set逐項迭代不預先具現；同一原型(如同一類別之多個實例)之鍵只掃描一次。

  5. 回傳{ reason, path }：reason為chkOrmStr之固定原因詞彙(不回顯值)；path以root起始，物件鍵為.鍵名(限30字元並以?取代控制字元、格式字元、方括號)、陣列元素與Set元素為[索引]、Map項目為序號，不合格之物件鍵名不出現在path，以.標示；Error與RegExp之文字為.message、.name、.cause、.source；路徑超過120字元截為...加末100碼元(切點避開代理對中間)；opt.root含控制字元、孤立代理、NUL或過長者改用預設。

  6. 不吞例外：讀取過程中Proxy陷阱、getter等拋出之例外原樣拋出；各後端於複製後呼叫則一般資料不會遇到。

  7. 會呼叫可列舉存取器(含繼承者)，後端應於獨立複本上走訪：存取器之getter以被走訪者為this執行，其副作用可能改動被走訪之同一份複本——例如繼承之存取器把已檢查之欄位改成不合格字串，或把主鍵改指向既有他列——使其後寫入或刪除的不是被檢查之值(cloneDeep保留原型而不讀繼承存取器，故複製後存取器仍在)。後端須另做一份獨立複本(如再cloneDeep一次)供本函數走訪，寫入用複本不被走訪；交給事件訂閱者之物件亦須為獨立快照(訂閱者的改動不得影響其後各筆)，訂閱函數拋錯不得影響操作。此作法擋得住存取器對寫入複本的直接改動，但擋不住存取器『修好』走訪用複本中的不合格值(寫入用複本仍帶原值而通過檢核)；要連此一併杜絕，須在檢核前把存取器固定為資料(每個可列舉屬性含繼承者只讀一次，產生不含存取器之資料)，檢核並寫入同一份固定後之資料。契約案例表增補案例next之toctou組(inh-getter-、event-shared、listener-throws)驗證獨立複本與事件快照；『修好』之情形尚無案例，列為已知限制。

  後端依回傳組成訊息：invalid data: reason at [path]；w-orm系列契約案例表見wsemi/src/_cvOrmStrCases.mjs。

  Unit Test: Github

Source:

• chkOrmData.mjs, line 239

Example

console.log(chkOrmData({ id: 'a', name: '中文\u{1F600}', tags: ['x', 'y'], meta: { k: 'v' } }))
// => null

console.log(chkOrmData({ id: 'a', meta: { tags: ['ok', 'b\uD800'] } }))
// => { reason: 'string contains lone surrogate', path: 'data.meta.tags[1]' }

console.log(chkOrmData({ id: 'a', ['k\uD800']: 1 }, { root: 'data[2]' }))
// => { reason: 'string contains lone surrogate', path: 'data[2].<invalid key>' }

console.log(chkOrmData({ name: 'a\u0000b' }))
// => null

console.log(chkOrmData({ name: 'a\u0000b' }, { nul: true }))
// => { reason: 'string contains NUL', path: 'data.name' }

Parameters:

Returns:

Type

null | Object

(static) chkOrmStr(s, optopt) → {String|null}

Description:

• w-orm系列字串之良構檢核，回傳null(合格)或固定原因字串

  檢查順序：非字串→NUL→孤立代理，回傳首個命中之原因。

  1. 非字串(含String包裝物件、undefined、null、數字、物件等任何非原始字串值)回傳'not a string'，不呼叫該值之任何方法。

  2. NUL：字串含U+0000回傳'string contains NUL'；opt.nul嚴格等於false時不檢查(僅自有資料屬性生效，繼承值、存取器與其他假值皆維持檢查)。

  3. 孤立代理：含孤立之代理碼元(高代理之後無低代理，或低代理之前無高代理，即String.prototype.isWellFormed()為false)回傳'string contains lone surrogate'；U+FFFD本身與成對代理(emoji、CJK擴充B區以後之罕用字)為良構，回傳null。

  4. 長度不另限；對字串輸入不拋錯；不修改輸入；純JS(不import任何模組、不用Node API)，無String.prototype.isWellFormed之環境走等價之正則退路；檢核所用之內建於模組載入時取得，載入後被覆寫或原型被汙染不影響結果。

  回傳之原因字串為固定詞彙，不回顯輸入值，供呼叫端組成'invalid id: 原因 at [路徑]'等訊息；w-orm系列契約案例表見wsemi/src/_cvOrmStrCases.mjs。

  Unit Test: Github

Source:

• chkOrmStr.mjs, line 80

Example

console.log(chkOrmStr('abc'))
// => null

console.log(chkOrmStr('中文\u{1F600}'))
// => null

console.log(chkOrmStr('a\uD800'))
// => string contains lone surrogate

console.log(chkOrmStr('a\u0000b'))
// => string contains NUL

console.log(chkOrmStr('a\u0000b', { nul: false }))
// => null

console.log(chkOrmStr(123))
// => not a string

Parameters:

Returns:

Type

String | null

(static) cint(v, optopt) → {Integer}

Description:

• 數字或字串四捨五入轉整數 若輸入非數字則回傳0

  Unit Test: Github

Source:

• cint.mjs, line 52

Example

console.log(cint('1.5'))
// => 2

console.log(cint('-1.5'))
// => -1

console.log(cint(Infinity))
// => 1.7976931348623157e+308

console.log(cint(Infinity, { useClampSafe: true }))
// => 9007199254740991

console.log(cint(-Infinity, { useClampSafe: true }))
// => -9007199254740991

try {
    cint(Infinity, { useLimitSafe: true })
}
catch (err) {
    console.log(err.message)
    // => v[1.7976931348623157e+308] is not a safe integer
}

console.log(cint(Infinity, { useLimitSafe: true, returnWithStateAndMsg: true }))
// => { state: 'error', msg: 'v[1.7976931348623157e+308] is not a safe integer' }

console.log(cint('1.5', { returnWithStateAndMsg: true }))
// => { state: 'success', msg: 2 }

Parameters:

Returns:

Type

Integer

(static) clearXSS(inp) → {Object|Array|String}

Description:

• 清除xss攻擊語法

  Depend on: https://jsxss.com/zh/index.html

  白名單外之標籤轉義，白名單內之標籤刪除白名單外之屬性與危險網址(style屬性保留)，標籤外之文字只轉義會開始標籤之<(其後為英文字母、斜線、驚嘆號、問號或位於結尾)，>與其餘之<維持原樣，故'a < b'等數學式不改寫

  輸出僅供以HTML內文呈現(如v-html、innerHTML)，不可放入屬性值或註解內

  走訪採顯式堆疊並以來源物件之參照記憶化，不遞迴：深巢狀與循環參照不拋錯(循環保持)，共用子結構只處理一次且輸出中保持共用，成本與節點數成正比，不設深度上限(僅受堆積限制)。處置如下：

  1. 字串清除(含包裝String，清除後為原始字串)；空字串與number、boolean、null、undefined等非字串原值回傳

  2. 物件(含類別實例)與真陣列(含子類別)走訪並保留原型(null原型物件變一般物件)，length視為一般鍵(不使走訪改為類陣列，不新增鍵)，成本與length值無關；物件依自有可列舉之字串鍵與Symbol鍵，陣列依索引(空洞補undefined，非索引屬性不複製，正規表示式比對結果之index與input除外，其input亦清除)；Map走訪值、Set走訪元素(Map之鍵不處理，清除後相同之Set元素合併)，Map與Set之自有可列舉屬性一併走訪；不可列舉屬性不複製，原型上之資料不處理

  3. 物件之字串鍵與Map之鍵不清除，由使用端自行檢核

  4. arguments物件與以Symbol.toStringTag偽稱Array或Arguments之物件，視為物件並依自有可列舉鍵走訪，轉為一般物件

  5. Date、RegExp、型別陣列、Buffer、ArrayBuffer、包裝Number等回傳複本，其自有字串屬性不清除(物件值屬性依上述走訪)；函數、Error、WeakMap、Promise、URL等不可複製者，巢狀時回傳同一參照而不清除其內字串，位於最外層時函數複製為一般物件(清除其可列舉屬性)、Error等回傳{}；其餘經lodash cloneDeep複製後仍帶自訂Symbol.toStringTag之物件亦不清除其內字串

  6. 經lodash cloneDeep複製之物件(上述第4、5點以外之非一般物件，如類別實例、null原型物件、陣列子類別、自訂標籤者)沿用其複製行為(含原型上之setter)，再依複本之終態逐鍵清除；除此之外輸入不被修改

  7. 清除對字串不保證冪等(如<b='<<>清一次與清兩次結果不同)，已清除之值再送入可能再被改寫

  Unit Test: Github

Source:

• clearXSS.mjs, line 138

Example

console.log(clearXSS(`><script>alert('XSS')</script>`))
// => `>&lt;script>alert('XSS')&lt;/script>`

console.log(clearXSS(`<img src="javascript:alert('XSS')">`))
// => `<img src>`

console.log(clearXSS(`孔深 < 500 m 且 > 10 m`))
// => `孔深 < 500 m 且 > 10 m`

console.log(clearXSS({ a: `<script>alert('XSS')</script>`, b: [1, `<b>x</b>`, { c: `<img src=x onerror=alert(1)>` }], d: new Map([['k', `<script>1</script>`]]) }))
// => { a: "&lt;script>alert('XSS')&lt;/script>", b: [ 1, '<b>x</b>', { c: '<img src>' } ], d: Map(1) { 'k' => '&lt;script>1&lt;/script>' } }

Parameters:

Returns:

Type

Object | Array | String

(async, static) clearXSSDyn(inp, optopt, pathItems) → {Promise}

Description:

• 清除xss攻擊語法，採用動態加載技術，處理規則同clearXSS

  Depend on: https://jsxss.com/zh/index.html

  Unit Test: Github

Source:

• clearXSSDyn.mjs, line 30

Example

let r

r = await clearXSSDyn(`><script>alert('XSS')</script>`)
console.log(r)
// => `>&lt;script>alert('XSS')&lt;/script>`

r = await clearXSSDyn(`<img src="javascript:alert('XSS')">`)
console.log(r)
// => `<img src>`

Parameters:

Returns:

Type

Promise

(static) color() → {Object}

Description:

• 顏色轉換

  Unit Test: Github

Source:

• color.mjs, line 1524

Example

import oc from 'wsemi/src/color.mjs'

let c
let c1
let c2
let r

c = '#cd'
r = oc.toRgbaString(c)
console.log(r)
// => rgba(205, 205, 205, 1)

c = '#6a3'
r = oc.toRgbaString(c)
console.log(r)
// => rgba(102, 170, 51, 1)

c = '#6b8e23'
r = oc.toRgbaString(c)
console.log(r)
// => rgba(107, 142, 35, 1)

c1 = '#cd'
c2 = 'hsl (320, 50%, 40%)'
r = oc.mix(c1, 0.5, c2, 0.5, 'toRgbString')
console.log(r)
// => rgb(179, 128, 162)

c1 = '#cd'
c2 = 'hsl (320, 50%, 40%)' //rgb(153, 51, 119)
r = oc.mix(c1, 0, c2, 1, 'toRgbString')
console.log(r)
// => rgb(153, 51, 119)

c1 = 'rgb(250, 120, 50)'
c2 = 'hsva (320, 100%, 50%, 0.1)'
r = oc.mix(c1, 0.5, c2, 0.5, 'toRgba')
console.log(r)
// => { r: 189, g: 60, b: 68, a: 0.55 }

c = 'rgb(250, 120, 50)'
r = oc.toRgbaString(c)
console.log(r)
// => rgba(250, 120, 50, 1)

c = 'rgb(250, 120, 50)'
r = oc.toHslaString(c)
console.log(r)
// => hsla(21, 0.952, 0.588, 1)

c = 'rgb(250, 120, 50)'
r = oc.toHsvaString(c)
console.log(r)
// => hsva(21, 0.8, 0.98, 1)

c = 'rgb(250, 120, 50)'
r = oc.toHexString(c)
console.log(r)
// => #fa7832

c = 'skyblue'
r = oc.toRgbaString(c)
console.log(r)
// => rgba(135, 206, 235, 1)

c = 'hsl (320, 50%, 40%)'
r = oc.toRgba(c)
console.log(r)
// => { r: 153, g: 51, b: 119, a: 1 }

c = 'hsva (320, 100%, 50%, 0.1)'
r = oc.toRgba(c)
console.log(r)
// => { r: 128, g: 0, b: 85, a: 0.1 }

c = { r: 255, g: 150, b: 50 }
r = oc.toHsla(c)
console.log(r)
// => { h: 29, s: 0.672, l: 0.002, a: 1 }

c = { r: '50%', g: 150, b: 50, a: 0.1 }
r = oc.toHsva(c)
console.log(r)
// => { h: 74, s: 0.667, v: 0.002, a: 0.1 }

c = { h: 320, s: 0.2, l: 0.15 }
r = oc.toRgba(c)
console.log(r)
// => { r: 46, g: 31, b: 31, a: 1 }

c = { h: 320, s: '12%', l: '8%', a: 0.1 }
r = oc.toRgba(c)
console.log(r)
// => { r: 23, g: 18, b: 18, a: 0.1 }

c = { h: 320, s: 0.2, v: 0.15 }
r = oc.toRgba(c)
console.log(r)
// => { r: 38, g: 31, b: 31, a: 1 }

c = { h: '50%', s: 0.2, l: 0.15 }
r = oc.toHexString(c)
console.log(r)
// => #1f2e2e

c = { h: '50%', s: 0.2, l: 0.15 }
r = oc.toRgbaString(c)
console.log(r)
// => rgba(31, 46, 46, 1)

c = { h: '50%', s: 0.2, l: 0.15 }
r = oc.toRgba(c)
console.log(r)
// => { r: 31, g: 46, b: 46, a: 1 }

c = { h: 180, s: 0.2, l: 0.15 }
r = oc.toHexString(c)
console.log(r)
// => #1f2e2e

c = { h: '50%', s: '12%', v: '8%', a: 0.1 }
r = oc.toRgba(c)
console.log(r)
// => { r: 20, g: 18, b: 18, a: 0.1 }

let gradient = {
    0: 'rgb(255, 255, 255)',
    0.2: 'rgb(254, 178, 76)',
    0.4: 'rgb(252, 78, 42)',
    0.6: 'rgb(220, 58, 38)',
    0.8: 'rgb(200, 40, 23)',
    1: 'rgba(180, 30, 60, 0.5)',
}
let fun = oc.interp(gradient)
console.log('fun(0)', fun(0))
//fun(0) rgba(255, 255, 255, 1)

console.log('fun(0.1)', fun(0.1))
//fun(0.1) rgba(255, 217, 166, 1)

console.log('fun(0.2)', fun(0.2))
//fun(0.2) rgba(254, 178, 76, 1)

console.log('fun(0.8)', fun(0.8))
//fun(0.8) rgba(200, 40, 23, 1)

console.log('fun(0.9)', fun(0.9))
//fun(0.9) rgba(190, 35, 42, 0.75)

console.log('fun(1)', fun(1))
//fun(1) rgba(180, 30, 60, 0.5)

console.log('fun(2)', fun(2))
//fun(2) null

console.log('fun(-1)', fun(-1))
//fun(-1) null

Returns:

Type

Object

(static) composeToTree(items, optopt, bindKeyopt, bindParentopt, bindChildrenopt, saveExtPropsopt) → {Array}

Description:

• 組合關聯陣列成為樹狀陣列

  Unit Test: Github

Source:

• composeToTree.mjs, line 93

Example

let data = [
    {
        id: 1,
        text: '1-a',
    },
    {
        id: 2,
        text: '2-b',
    },
    {
        id: 3,
        text: '3-c',
        parentId: 2,
    },
    {
        id: 4,
        text: '4-d',
        parentId: 2,
    },
    {
        id: 5,
        text: '5-e',
        parentId: 3,
    },
    {
        id: 6,
        text: 'empty',
    },
]
let r = composeToTree(data)
let cr = JSON.stringify(r)
console.log(cr)
// => [
//   {
//     "id": 1,
//     "text": "1-a"
//   },
//   {
//     "id": 2,
//     "text": "2-b",
//     "children": [
//       {
//         "id": 3,
//         "text": "3-c",
//         "parentId": 2,
//         "children": [
//           {
//             "id": 5,
//             "text": "5-e",
//             "parentId": 3
//           }
//         ]
//       },
//       {
//         "id": 4,
//         "text": "4-d",
//         "parentId": 2
//       }
//     ]
//   },
//   {
//     "id": 6,
//     "text": "empty"
//   }
// ]

Parameters:

Returns:

Type

Array

(static) convertToTree(data, optopt, bindKeyopt, bindParentopt, bindTextopt, bindChildrenopt, bindTypeopt, bindNumOfChilrenopt, bindRootopt, saveExtPropsopt) → {Array}

Description:

• 展開物件或陣列成為樹狀陣列

  Unit Test: Github

Source:

• convertToTree.mjs, line 901

Example

let r

let obj = {
    a: 1,
    b: 12.3,
    c: 'abc',
    d: '45-de',
    x: true,
    y: null,
    z: function() {},
    e: [],
    f: [
        91,
        912.3,
        'abc',
        '945-de',
        true,
        null,
        function() {},
        [
            5,
            54.3,
            'xyz',
        ]
    ],
    g: {},
    h: {
        ga: 81,
        gb: 812.3,
        gc: 'abc',
        gd: '845-de',
        ge: [
            71,
            712.3,
            'abc',
            '745-de',
            true,
            null,
            function() {},
        ],
        gf: {
            gfa: 61,
            gfb: 612.3,
            gfc: 'abc',
            gfd: '645-de',
            gfe: true,
            gff: null,
            gfg: function() {},
        },
        gx: true,
        gy: null,
        gz: function() {},
    },
    i: Symbol('foo'),
    [Symbol('i-sym-key-a')]: 'i-sym-value',
    [Symbol('i-sym-key-b')]: {
        symfa: 61,
        symfb: 612.3,
        symfc: 'abc',
        symfd: '645-de',
        symfe: true,
        symff: null,
        symfg: function() {},
    },
}
r = convertToTree(obj)
console.log('convertToTree obj', JSON.stringify(r, null, 2))
// => convertToTree obj [
//   {
//     "id": "root",
//     "parentId": "",
//     "type": "object",
//     "key": "root",
//     "numOfChilren": 12,
//     "children": [
//       {
//         "id": "root-a",
//         "parentId": "root",
//         "type": "node",
//         "key": "a",
//         "text": 1
//       },
//       {
//         "id": "root-b",
//         "parentId": "root",
//         "type": "node",
//         "key": "b",
//         "text": 12.3
//       },
//       {
//         "id": "root-c",
//         "parentId": "root",
//         "type": "node",
//         "key": "c",
//         "text": "abc"
//       },
//       {
//         "id": "root-d",
//         "parentId": "root",
//         "type": "node",
//         "key": "d",
//         "text": "45-de"
//       },
//       {
//         "id": "root-x",
//         "parentId": "root",
//         "type": "node",
//         "key": "x",
//         "text": true
//       },
//       {
//         "id": "root-y",
//         "parentId": "root",
//         "type": "node",
//         "key": "y",
//         "text": null
//       },
//       {
//         "id": "root-z",
//         "parentId": "root",
//         "type": "node",
//         "key": "z"
//       },
//       {
//         "id": "root-e",
//         "parentId": "root",
//         "type": "array",
//         "key": "e",
//         "numOfChilren": 0
//       },
//       {
//         "id": "root-f",
//         "parentId": "root",
//         "type": "array",
//         "key": "f",
//         "numOfChilren": 8,
//         "children": [
//           {
//             "id": "root-f-0",
//             "parentId": "root-f",
//             "type": "node",
//             "key": 0,
//             "text": 91
//           },
//           {
//             "id": "root-f-1",
//             "parentId": "root-f",
//             "type": "node",
//             "key": 1,
//             "text": 912.3
//           },
//           {
//             "id": "root-f-2",
//             "parentId": "root-f",
//             "type": "node",
//             "key": 2,
//             "text": "abc"
//           },
//           {
//             "id": "root-f-3",
//             "parentId": "root-f",
//             "type": "node",
//             "key": 3,
//             "text": "945-de"
//           },
//           {
//             "id": "root-f-4",
//             "parentId": "root-f",
//             "type": "node",
//             "key": 4,
//             "text": true
//           },
//           {
//             "id": "root-f-5",
//             "parentId": "root-f",
//             "type": "node",
//             "key": 5,
//             "text": null
//           },
//           {
//             "id": "root-f-6",
//             "parentId": "root-f",
//             "type": "node",
//             "key": 6
//           },
//           {
//             "id": "root-f-7",
//             "parentId": "root-f",
//             "type": "array",
//             "key": 7,
//             "numOfChilren": 3,
//             "children": [
//               {
//                 "id": "root-f-7-0",
//                 "parentId": "root-f-7",
//                 "type": "node",
//                 "key": 0,
//                 "text": 5
//               },
//               {
//                 "id": "root-f-7-1",
//                 "parentId": "root-f-7",
//                 "type": "node",
//                 "key": 1,
//                 "text": 54.3
//               },
//               {
//                 "id": "root-f-7-2",
//                 "parentId": "root-f-7",
//                 "type": "node",
//                 "key": 2,
//                 "text": "xyz"
//               }
//             ]
//           }
//         ]
//       },
//       {
//         "id": "root-g",
//         "parentId": "root",
//         "type": "object",
//         "key": "g",
//         "numOfChilren": 0
//       },
//       {
//         "id": "root-h",
//         "parentId": "root",
//         "type": "object",
//         "key": "h",
//         "numOfChilren": 9,
//         "children": [
//           {
//             "id": "root-h-ga",
//             "parentId": "root-h",
//             "type": "node",
//             "key": "ga",
//             "text": 81
//           },
//           {
//             "id": "root-h-gb",
//             "parentId": "root-h",
//             "type": "node",
//             "key": "gb",
//             "text": 812.3
//           },
//           {
//             "id": "root-h-gc",
//             "parentId": "root-h",
//             "type": "node",
//             "key": "gc",
//             "text": "abc"
//           },
//           {
//             "id": "root-h-gd",
//             "parentId": "root-h",
//             "type": "node",
//             "key": "gd",
//             "text": "845-de"
//           },
//           {
//             "id": "root-h-ge",
//             "parentId": "root-h",
//             "type": "array",
//             "key": "ge",
//             "numOfChilren": 7,
//             "children": [
//               {
//                 "id": "root-h-ge-0",
//                 "parentId": "root-h-ge",
//                 "type": "node",
//                 "key": 0,
//                 "text": 71
//               },
//               {
//                 "id": "root-h-ge-1",
//                 "parentId": "root-h-ge",
//                 "type": "node",
//                 "key": 1,
//                 "text": 712.3
//               },
//               {
//                 "id": "root-h-ge-2",
//                 "parentId": "root-h-ge",
//                 "type": "node",
//                 "key": 2,
//                 "text": "abc"
//               },
//               {
//                 "id": "root-h-ge-3",
//                 "parentId": "root-h-ge",
//                 "type": "node",
//                 "key": 3,
//                 "text": "745-de"
//               },
//               {
//                 "id": "root-h-ge-4",
//                 "parentId": "root-h-ge",
//                 "type": "node",
//                 "key": 4,
//                 "text": true
//               },
//               {
//                 "id": "root-h-ge-5",
//                 "parentId": "root-h-ge",
//                 "type": "node",
//                 "key": 5,
//                 "text": null
//               },
//               {
//                 "id": "root-h-ge-6",
//                 "parentId": "root-h-ge",
//                 "type": "node",
//                 "key": 6
//               }
//             ]
//           },
//           {
//             "id": "root-h-gf",
//             "parentId": "root-h",
//             "type": "object",
//             "key": "gf",
//             "numOfChilren": 7,
//             "children": [
//               {
//                 "id": "root-h-gf-gfa",
//                 "parentId": "root-h-gf",
//                 "type": "node",
//                 "key": "gfa",
//                 "text": 61
//               },
//               {
//                 "id": "root-h-gf-gfb",
//                 "parentId": "root-h-gf",
//                 "type": "node",
//                 "key": "gfb",
//                 "text": 612.3
//               },
//               {
//                 "id": "root-h-gf-gfc",
//                 "parentId": "root-h-gf",
//                 "type": "node",
//                 "key": "gfc",
//                 "text": "abc"
//               },
//               {
//                 "id": "root-h-gf-gfd",
//                 "parentId": "root-h-gf",
//                 "type": "node",
//                 "key": "gfd",
//                 "text": "645-de"
//               },
//               {
//                 "id": "root-h-gf-gfe",
//                 "parentId": "root-h-gf",
//                 "type": "node",
//                 "key": "gfe",
//                 "text": true
//               },
//               {
//                 "id": "root-h-gf-gff",
//                 "parentId": "root-h-gf",
//                 "type": "node",
//                 "key": "gff",
//                 "text": null
//               },
//               {
//                 "id": "root-h-gf-gfg",
//                 "parentId": "root-h-gf",
//                 "type": "node",
//                 "key": "gfg"
//               }
//             ]
//           },
//           {
//             "id": "root-h-gx",
//             "parentId": "root-h",
//             "type": "node",
//             "key": "gx",
//             "text": true
//           },
//           {
//             "id": "root-h-gy",
//             "parentId": "root-h",
//             "type": "node",
//             "key": "gy",
//             "text": null
//           },
//           {
//             "id": "root-h-gz",
//             "parentId": "root-h",
//             "type": "node",
//             "key": "gz"
//           }
//         ]
//       },
//       {
//         "id": "root-i",
//         "parentId": "root",
//         "type": "node",
//         "key": "i"
//       },
//       {
//         "id": "root-Symbol(i-sym-key-a)",
//         "parentId": "root",
//         "type": "node",
//         "text": "i-sym-value"
//       },
//       {
//         "id": "root-Symbol(i-sym-key-b)",
//         "parentId": "root",
//         "type": "object",
//         "numOfChilren": 7,
//         "children": [
//           {
//             "id": "root-Symbol(i-sym-key-b)-symfa",
//             "parentId": "root-Symbol(i-sym-key-b)",
//             "type": "node",
//             "key": "symfa",
//             "text": 61
//           },
//           {
//             "id": "root-Symbol(i-sym-key-b)-symfb",
//             "parentId": "root-Symbol(i-sym-key-b)",
//             "type": "node",
//             "key": "symfb",
//             "text": 612.3
//           },
//           {
//             "id": "root-Symbol(i-sym-key-b)-symfc",
//             "parentId": "root-Symbol(i-sym-key-b)",
//             "type": "node",
//             "key": "symfc",
//             "text": "abc"
//           },
//           {
//             "id": "root-Symbol(i-sym-key-b)-symfd",
//             "parentId": "root-Symbol(i-sym-key-b)",
//             "type": "node",
//             "key": "symfd",
//             "text": "645-de"
//           },
//           {
//             "id": "root-Symbol(i-sym-key-b)-symfe",
//             "parentId": "root-Symbol(i-sym-key-b)",
//             "type": "node",
//             "key": "symfe",
//             "text": true
//           },
//           {
//             "id": "root-Symbol(i-sym-key-b)-symff",
//             "parentId": "root-Symbol(i-sym-key-b)",
//             "type": "node",
//             "key": "symff",
//             "text": null
//           },
//           {
//             "id": "root-Symbol(i-sym-key-b)-symfg",
//             "parentId": "root-Symbol(i-sym-key-b)",
//             "type": "node",
//             "key": "symfg"
//           }
//         ]
//       }
//     ]
//   }
// ]

let arr = [
    91,
    912.3,
    'abc',
    '945-de',
    true,
    null,
    function() {},
    [
        5,
        54.3,
        'xyz',
        {
            gf: {
                gfa: 61,
                gfb: 612.3,
                gfc: 'abc',
                gfd: '645-de',
                gfe: true,
                gff: null,
                gfg: function() {},
            },
        },
    ],
    {
        h: {
            ga: 81,
            gb: 812.3,
            gc: 'abc',
            gd: '845-de',
            ge: [
                71,
                712.3,
                'abc',
                '745-de',
                true,
                null,
                function() {},
            ],
            gx: true,
            gy: null,
            gz: function() {},
        },
        i: Symbol('foo'),
        [Symbol('i-sym-key-a')]: 'i-sym-value',
        [Symbol('i-sym-key-b')]: {
            symfa: 61,
            symfb: 612.3,
            symfc: 'abc',
            symfd: '645-de',
            symfe: true,
            symff: null,
            symfg: function() {},
        },
    },
]
r = convertToTree(arr)
console.log('convertToTree arr', JSON.stringify(r, null, 2))
// => convertToTree arr [
//   {
//     "id": "root",
//     "parentId": "",
//     "type": "array",
//     "key": "root",
//     "numOfChilren": 9,
//     "children": [
//       {
//         "id": "root-0",
//         "parentId": "root",
//         "type": "node",
//         "key": 0,
//         "text": 91
//       },
//       {
//         "id": "root-1",
//         "parentId": "root",
//         "type": "node",
//         "key": 1,
//         "text": 912.3
//       },
//       {
//         "id": "root-2",
//         "parentId": "root",
//         "type": "node",
//         "key": 2,
//         "text": "abc"
//       },
//       {
//         "id": "root-3",
//         "parentId": "root",
//         "type": "node",
//         "key": 3,
//         "text": "945-de"
//       },
//       {
//         "id": "root-4",
//         "parentId": "root",
//         "type": "node",
//         "key": 4,
//         "text": true
//       },
//       {
//         "id": "root-5",
//         "parentId": "root",
//         "type": "node",
//         "key": 5,
//         "text": null
//       },
//       {
//         "id": "root-6",
//         "parentId": "root",
//         "type": "node",
//         "key": 6
//       },
//       {
//         "id": "root-7",
//         "parentId": "root",
//         "type": "array",
//         "key": 7,
//         "numOfChilren": 4,
//         "children": [
//           {
//             "id": "root-7-0",
//             "parentId": "root-7",
//             "type": "node",
//             "key": 0,
//             "text": 5
//           },
//           {
//             "id": "root-7-1",
//             "parentId": "root-7",
//             "type": "node",
//             "key": 1,
//             "text": 54.3
//           },
//           {
//             "id": "root-7-2",
//             "parentId": "root-7",
//             "type": "node",
//             "key": 2,
//             "text": "xyz"
//           },
//           {
//             "id": "root-7-3",
//             "parentId": "root-7",
//             "type": "object",
//             "key": 3,
//             "numOfChilren": 1,
//             "children": [
//               {
//                 "id": "root-7-3-gf",
//                 "parentId": "root-7-3",
//                 "type": "object",
//                 "key": "gf",
//                 "numOfChilren": 7,
//                 "children": [
//                   {
//                     "id": "root-7-3-gf-gfa",
//                     "parentId": "root-7-3-gf",
//                     "type": "node",
//                     "key": "gfa",
//                     "text": 61
//                   },
//                   {
//                     "id": "root-7-3-gf-gfb",
//                     "parentId": "root-7-3-gf",
//                     "type": "node",
//                     "key": "gfb",
//                     "text": 612.3
//                   },
//                   {
//                     "id": "root-7-3-gf-gfc",
//                     "parentId": "root-7-3-gf",
//                     "type": "node",
//                     "key": "gfc",
//                     "text": "abc"
//                   },
//                   {
//                     "id": "root-7-3-gf-gfd",
//                     "parentId": "root-7-3-gf",
//                     "type": "node",
//                     "key": "gfd",
//                     "text": "645-de"
//                   },
//                   {
//                     "id": "root-7-3-gf-gfe",
//                     "parentId": "root-7-3-gf",
//                     "type": "node",
//                     "key": "gfe",
//                     "text": true
//                   },
//                   {
//                     "id": "root-7-3-gf-gff",
//                     "parentId": "root-7-3-gf",
//                     "type": "node",
//                     "key": "gff",
//                     "text": null
//                   },
//                   {
//                     "id": "root-7-3-gf-gfg",
//                     "parentId": "root-7-3-gf",
//                     "type": "node",
//                     "key": "gfg"
//                   }
//                 ]
//               }
//             ]
//           }
//         ]
//       },
//       {
//         "id": "root-8",
//         "parentId": "root",
//         "type": "object",
//         "key": 8,
//         "numOfChilren": 2,
//         "children": [
//           {
//             "id": "root-8-h",
//             "parentId": "root-8",
//             "type": "object",
//             "key": "h",
//             "numOfChilren": 8,
//             "children": [
//               {
//                 "id": "root-8-h-ga",
//                 "parentId": "root-8-h",
//                 "type": "node",
//                 "key": "ga",
//                 "text": 81
//               },
//               {
//                 "id": "root-8-h-gb",
//                 "parentId": "root-8-h",
//                 "type": "node",
//                 "key": "gb",
//                 "text": 812.3
//               },
//               {
//                 "id": "root-8-h-gc",
//                 "parentId": "root-8-h",
//                 "type": "node",
//                 "key": "gc",
//                 "text": "abc"
//               },
//               {
//                 "id": "root-8-h-gd",
//                 "parentId": "root-8-h",
//                 "type": "node",
//                 "key": "gd",
//                 "text": "845-de"
//               },
//               {
//                 "id": "root-8-h-ge",
//                 "parentId": "root-8-h",
//                 "type": "array",
//                 "key": "ge",
//                 "numOfChilren": 7,
//                 "children": [
//                   {
//                     "id": "root-8-h-ge-0",
//                     "parentId": "root-8-h-ge",
//                     "type": "node",
//                     "key": 0,
//                     "text": 71
//                   },
//                   {
//                     "id": "root-8-h-ge-1",
//                     "parentId": "root-8-h-ge",
//                     "type": "node",
//                     "key": 1,
//                     "text": 712.3
//                   },
//                   {
//                     "id": "root-8-h-ge-2",
//                     "parentId": "root-8-h-ge",
//                     "type": "node",
//                     "key": 2,
//                     "text": "abc"
//                   },
//                   {
//                     "id": "root-8-h-ge-3",
//                     "parentId": "root-8-h-ge",
//                     "type": "node",
//                     "key": 3,
//                     "text": "745-de"
//                   },
//                   {
//                     "id": "root-8-h-ge-4",
//                     "parentId": "root-8-h-ge",
//                     "type": "node",
//                     "key": 4,
//                     "text": true
//                   },
//                   {
//                     "id": "root-8-h-ge-5",
//                     "parentId": "root-8-h-ge",
//                     "type": "node",
//                     "key": 5,
//                     "text": null
//                   },
//                   {
//                     "id": "root-8-h-ge-6",
//                     "parentId": "root-8-h-ge",
//                     "type": "node",
//                     "key": 6
//                   }
//                 ]
//               },
//               {
//                 "id": "root-8-h-gx",
//                 "parentId": "root-8-h",
//                 "type": "node",
//                 "key": "gx",
//                 "text": true
//               },
//               {
//                 "id": "root-8-h-gy",
//                 "parentId": "root-8-h",
//                 "type": "node",
//                 "key": "gy",
//                 "text": null
//               },
//               {
//                 "id": "root-8-h-gz",
//                 "parentId": "root-8-h",
//                 "type": "node",
//                 "key": "gz"
//               }
//             ]
//           },
//           {
//             "id": "root-8-i",
//             "parentId": "root-8",
//             "type": "node",
//             "key": "i"
//           },
//           {
//             "id": "root-8-Symbol(i-sym-key-a)",
//             "parentId": "root-8",
//             "type": "node",
//             "text": "i-sym-value"
//           },
//           {
//             "id": "root-8-Symbol(i-sym-key-b)",
//             "parentId": "root-8",
//             "type": "object",
//             "numOfChilren": 7,
//             "children": [
//               {
//                 "id": "root-8-Symbol(i-sym-key-b)-symfa",
//                 "parentId": "root-8-Symbol(i-sym-key-b)",
//                 "type": "node",
//                 "key": "symfa",
//                 "text": 61
//               },
//               {
//                 "id": "root-8-Symbol(i-sym-key-b)-symfb",
//                 "parentId": "root-8-Symbol(i-sym-key-b)",
//                 "type": "node",
//                 "key": "symfb",
//                 "text": 612.3
//               },
//               {
//                 "id": "root-8-Symbol(i-sym-key-b)-symfc",
//                 "parentId": "root-8-Symbol(i-sym-key-b)",
//                 "type": "node",
//                 "key": "symfc",
//                 "text": "abc"
//               },
//               {
//                 "id": "root-8-Symbol(i-sym-key-b)-symfd",
//                 "parentId": "root-8-Symbol(i-sym-key-b)",
//                 "type": "node",
//                 "key": "symfd",
//                 "text": "645-de"
//               },
//               {
//                 "id": "root-8-Symbol(i-sym-key-b)-symfe",
//                 "parentId": "root-8-Symbol(i-sym-key-b)",
//                 "type": "node",
//                 "key": "symfe",
//                 "text": true
//               },
//               {
//                 "id": "root-8-Symbol(i-sym-key-b)-symff",
//                 "parentId": "root-8-Symbol(i-sym-key-b)",
//                 "type": "node",
//                 "key": "symff",
//                 "text": null
//               },
//               {
//                 "id": "root-8-Symbol(i-sym-key-b)-symfg",
//                 "parentId": "root-8-Symbol(i-sym-key-b)",
//                 "type": "node",
//                 "key": "symfg"
//               }
//             ]
//           }
//         ]
//       }
//     ]
//   }
// ]

Parameters:

Returns:

Type

Array

(static) copyStrToClipboard(str, optopt) → {String}

Description:

• 複製字串至剪貼簿

  Unit Test: Github

Source:

• copyStrToClipboard.mjs, line 24

Example

copyStrToClipboard('The Woodman(樵夫) set to work at once, and so...')

let ele = document.querySelector('#id')
copyStrToClipboard('The Woodman(樵夫) set to work at once, and so...', { eleParent: ele })

Parameters:

Returns:

Type

String

(static) core(t, tNowopt, optopt) → {Object}

Description:

• 毫秒時間轉過去時間

  Unit Test: Github

Source:

• timemsTZ2past.mjs, line 77

Example

let t
let tNow = '2020-10-18T12:34:56.987+08:00'
let r

t = '2020-10-18T12:34:54.987+08:00'
r = timemsTZ2past(t, tNow)
console.log(r)
// => { today: true, msg: '2秒前', err: '' }

t = '2020-10-18T04:34:54.987+00:00'
r = timemsTZ2past(t, tNow)
console.log(r)
// => { today: true, msg: '2秒前', err: '' }

t = '2020-10-18T04:34:54.987Z'
r = timemsTZ2past(t, tNow)
console.log(r)
// => { today: true, msg: '2秒前', err: '' }

t = '2020-10-18T12:34:55.500+08:00'
r = timemsTZ2past(t, tNow)
console.log(r)
// => { today: true, msg: '1秒前', err: '' }

t = '2020-10-18T12:31:54.987+08:00'
r = timemsTZ2past(t, tNow)
console.log(r)
// => { today: true, msg: '3分鐘前', err: '' }

t = '2020-10-18T08:31:54.987+08:00'
r = timemsTZ2past(t, tNow)
console.log(r)
// => { today: true, msg: '4小時前', err: '' }

t = '2020-10-13T08:31:54.987+08:00'
r = timemsTZ2past(t, tNow)
console.log(r)
// => { today: false, msg: '5天前', err: '' }

t = '2020-04-13T08:31:54.987+08:00'
r = timemsTZ2past(t, tNow)
console.log(r)
// => { today: false, msg: '6個月前', err: '' }

t = '2013-04-13T08:31:54.987+08:00'
r = timemsTZ2past(t, tNow)
console.log(r)
// => { today: false, msg: '7年前', err: '' }

t = '2023-04-13T08:31:54.987+08:00'
r = timemsTZ2past(t, tNow)
console.log(r)
// => { today: null, msg: '', err: '時間未到' }

Parameters:

Returns:

Type

Object

(static) cosd(deg) → {Number}

Description:

• 輸入角度計算cos值

  Unit Test: Github

Source:

• cosd.mjs, line 72

Example

console.log(cosd(0))
// => 1

console.log(cosd(30))
// => 0.8660254037844387

console.log(cosd(45))
// => 0.7071067811865476

console.log(cosd(60))
// => 0.5000000000000001

console.log(cosd(90))
// => 6.123233995736766e-17

console.log(cosd(120))
// => -0.4999999999999998

console.log(cosd(135))
// => -0.7071067811865475

console.log(cosd(150))
// => -0.8660254037844387

console.log(cosd(180))
// => -1

console.log(cosd(210))
// => -0.8660254037844386

console.log(cosd(225))
// => -0.7071067811865477

console.log(cosd(240))
// => -0.5000000000000004

console.log(cosd(270))
// => -1.8369701987210297e-16

console.log(cosd(300))
// => 0.5000000000000001

console.log(cosd(315))
// => 0.7071067811865474

console.log(cosd(330))
// => 0.8660254037844384

console.log(cosd(360))
// => 1

console.log(cosd(450))
// => 3.061616997868383e-16

console.log(cosd(720))
// => 1

Parameters:

Returns:

Type

Number

(static) cotd(deg) → {Number}

Description:

• 輸入角度計算cot值

  Unit Test: Github

Source:

• cotd.mjs, line 73

Example

console.log(cotd(0))
// => Infinity

console.log(cotd(30))
// => 1.7320508075688774

console.log(cotd(45))
// => 1.0000000000000002

console.log(cotd(60))
// => 0.577350269189626

console.log(cotd(90))
// => 6.123233995736766e-17

console.log(cotd(120))
// => -0.5773502691896254

console.log(cotd(135))
// => -0.9999999999999998

console.log(cotd(150))
// => -1.7320508075688774

console.log(cotd(180))
// => -8165619676597685

console.log(cotd(210))
// => 1.7320508075688767

console.log(cotd(225))
// => 1.0000000000000004

console.log(cotd(240))
// => 0.5773502691896264

console.log(cotd(270))
// => 1.83697019872103e-16

console.log(cotd(300))
// => -0.5773502691896258

console.log(cotd(315))
// => -0.9999999999999996

console.log(cotd(330))
// => -1.7320508075688754

console.log(cotd(360))
// => -4082809838298842.5

console.log(cotd(450))
// => 3.061616997868383e-16

console.log(cotd(720))
// => -2041404919149421.2

Parameters:

Returns:

Type

Number

(static) createExcelWorkbook() → {Object}

Description:

• 產生Excel的Workbook空物件

  Workbook物件格式為{ sheets: [] }，各分頁為{ name, rows }物件，可交由addExcelWorksheetFromData添加分頁、getExcelU8ArrFromWorkbook輸出檔案

  Unit Test: Github

Source:

• createExcelWorkbook.mjs, line 16

Example

let wb = createExcelWorkbook()
console.log(wb)
// => { sheets: [] }

Returns:

Type

Object

(static) cscd(deg) → {Number}

Description:

• 輸入角度計算csc值

  Unit Test: Github

Source:

• cscd.mjs, line 73

Example

console.log(cscd(0))
// => Infinity

console.log(cscd(30))
// => 2.0000000000000004

console.log(cscd(45))
// => 1.4142135623730951

console.log(cscd(60))
// => 1.1547005383792517

console.log(cscd(90))
// => 1

console.log(cscd(120))
// => 1.1547005383792515

console.log(cscd(135))
// => 1.414213562373095

console.log(cscd(150))
// => 2.0000000000000004

console.log(cscd(180))
// => 8165619676597685

console.log(cscd(210))
// => -1.9999999999999996

console.log(cscd(225))
// => -1.4142135623730951

console.log(cscd(240))
// => -1.1547005383792517

console.log(cscd(270))
// => -1

console.log(cscd(300))
// => -1.1547005383792517

console.log(cscd(315))
// => -1.4142135623730947

console.log(cscd(330))
// => -1.9999999999999982

console.log(cscd(360))
// => -4082809838298842.5

console.log(cscd(450))
// => 1

console.log(cscd(720))
// => -2041404919149421.2

Parameters:

Returns:

Type

Number

(static) cstr(v) → {String}

Description:

• 輸入轉字串 若輸入不是字串、數字、Symbol、BigInt時則回傳空字串

  Unit Test: Github

Source:

• cstr.mjs, line 27

Example

console.log(cstr(2.25))
// => '2.25'

console.log(cstr(123n))
// => '123'

console.log(cstr(BigInt('9007199254740993')))
// => '9007199254740993' (超過Number.MAX_SAFE_INTEGER, BigInt精確保留)

Parameters:

Returns:

Type

String

(static) cvOrmFind(find, optopt) → {Object}

Description:

• w-orm系列條件(find)之形狀檢核與正規化，回傳全新之null原型深複本，不合白名單者同步拋錯

  輸入為任意值：undefined與一般物件{}為全部(回傳空的null原型物件)，其餘依系列白名單檢核，通過者回傳全新複本(物件皆為null原型、陣列為全新密集陣列、Date為新Date，與輸入無任何共用參照)，後續一律只使用複本。

  白名單：

  1. 頂層與每層條件物件須為一般物件(原型為Object.prototype或null)，null、陣列、字串、數值、布林、函數、Date、RegExp、Map、Set、類別實例等一律reject，不得視同{}；原型被改為null或Object.prototype之Map、Set、WeakMap、WeakSet、Promise、ArrayBuffer、DataView、TypedArray、Symbol與BigInt包裝、WeakRef、FinalizationRegistry等內建品牌物件，於任何位置(頂層、欄位運算子物件、$and/$or元素，空或帶自有鍵)亦reject；頂層空物件(代表全部)須可證明為真實空物件，Proxy與不可複製之宿主物件不視為全部

  2. 欄位等值{欄: 純量}，多欄隱含AND；純量為字串、有限數字(含-0)、布林、有效Date，字串不得含NUL與孤立代理字元；null僅可用於欄位等值、$eq、$ne

  3. 欄位運算子：$eq $ne $gt $gte $lt $lte(值為純量)、$in $nin(值為純量陣列，元素不收null；$in:[]允許為恆假，$nin:[]reject)，運算子物件須至少一個運算子

  4. 文件層邏輯：$and、$or(值為非空陣列，元素為非空條件物件)，可巢狀、可與欄位鍵並列

  5. 欄名：1~128字元(UTF-16碼元)，符合^[\p{L}][\p{L}\p{M}\p{N}]*$且非__proto__；點路徑、$開頭、連字號、空白、引號等一律reject

  6. 其餘一律reject(整批性、不得靜默忽略)：$not $nor $regex $options $exists $type $where $expr $function $elemMatch $size $all $mod $like $ilike $custom等白名單外運算子、欄位層$and/$or、子查詢、Symbol鍵、函數值、BigInt、Buffer、RegExp、NaN、±Infinity、無效Date、undefined、包裝物件

  7. 異常結構一律reject：存取器屬性、不可列舉屬性、Symbol鍵、陣列之洞與額外屬性、length非非負整數之陣列；每個屬性與元素只讀一次並只使用該次所讀之值，帶length鍵之一般物件(如{length:3})之length為一般欄名

  8. 上限(opt只可下調，不可放寬)：邏輯巢狀深度32、$and/$or長度1000、$in/$nin長度10000、節點總數100000(條件物件、運算子物件、純量各計1)、欄名128

  錯誤一律為同步拋出之Error('invalid find: 原因 at [路徑]')，不回顯值(鍵名為路徑之一部分，限30字元並以?取代控制字元、格式字元與方括號)；走訪中任何例外(含呼叫端之getter、Proxy陷阱、Symbol.toStringTag getter)一律轉為此格式，不轉述呼叫端之錯誤訊息，描述子陷阱拋錯、存取器與不可列舉屬性之路徑含該屬性鍵或元素索引；可重入。opt須為物件、null或未給，僅可含下列五個鍵(自有資料屬性)，設定錯誤另拋Error('invalid opt: 原因')。

  已知限制：判定內部標籤須讀Symbol.toStringTag，可能執行呼叫端之Proxy陷阱或getter(例外一律轉為invalid find)；Proxy無法穿透，非空位置之Proxy包住原型被改之品牌物件視同其經陷阱暴露之條件物件；無法觀察品牌者(含私有欄位之類別實例與AbortController等宿主物件改原型為null、自有鍵為純量constructor之Promise)不被辨出；品牌檢查先以一次結構化複製(structuredClone)證明被記錄之條件物件皆非品牌物件，環境無可用之該全域、字串總長逾400萬碼元或樹內含Proxy時改逐物件探針(每物件約50微秒，含Proxy之近節點上限輸入可達數秒)，且無可用之該全域時無法辨出空Proxy；被判為品牌物件而reject者，其內部資料(Map/Set之項目、ArrayBuffer之位元組)可能被複製讀取一次，成本不受節點預算約束；Proxy之ownKeys結果於引擎內先被完整具現化，其成本不受節點預算約束；共享參照(同一物件出現於多處)每出現一次即各讀各檢各複製，節點數亦逐次計入

  後端專屬之檢核(欄位型別、欄是否存在、主鍵正規化、DATE範圍、NULL三值語意)不在此，由各後端於本函數之後自行處理；契約案例表見wsemi/src/_cvOrmFindCases.mjs。

  Unit Test: Github

Source:

• cvOrmFind.mjs, line 736

Example

console.log(Object.keys(cvOrmFind()))
// => []

console.log(Object.keys(cvOrmFind({})))
// => []

let r = cvOrmFind({ name: 'a', age: { $gt: 20, $in: [21, 22] }, $or: [{ g: 'A' }, { g: null }] })
console.log(Object.getPrototypeOf(r), Object.keys(r))
// => null [ 'name', 'age', '$or' ]

try {
    cvOrmFind({ name: { $regex: 'a' } })
}
catch (err) {
    console.log(err.message)
}
// => invalid find: unsupported operator [$regex] at [find.name.$regex]

try {
    cvOrmFind(null)
}
catch (err) {
    console.log(err.message)
}
// => invalid find: condition must be a plain object, got [null] at [find]

Parameters:

Throws:

不合白名單者拋出Error('invalid find: 原因 at [路徑]')，opt錯誤者拋出Error('invalid opt: 原因')

Type

Error

Returns:

Type

Object

(static) day2cht(t, bNoDisplayYearopt) → {String}

Description:

• 日時間轉中文格式時間字串

  Unit Test: Github

Source:

• day2cht.mjs, line 19

Example

console.log(day2cht('2019-01-02'))
// => '民國 108 年 1 月 2 日'

Parameters:

Returns:

Type

String

(static) debounce(msopt, optopt)

Description:

• 函數去除抖動

  呼叫無回傳值，任務不被等待；任務同步拋錯或其Promise被reject時以console.log記錄而不外拋(不產生未處理之rejection)，不影響後續佇列；輸入非函數時不排入佇列(不影響已排入之任務)，以console.log記錄'func is not a function'

  Unit Test: Github

Source:

• debounce.mjs, line 128

Example

async function topAsync() {

    function test1() {
        return new Promise((resolve, reject) => {
            let ms = []

            let dbc = debounce(300)

            let i = 0
            function core(name) {
                i++
                ms.push({ name, i })
                console.log({ name, i })
            }

            setTimeout(function() {
                dbc(() => {
                    core('A')
                })
            }, 100)
            setTimeout(function() {
                dbc(() => {
                    core('B')
                })
            }, 200)
            setTimeout(function() {
                dbc(() => {
                    core('C')
                })
            }, 250)
            setTimeout(function() {
                dbc(() => {
                    core('D')
                })
            }, 350)
            setTimeout(function() {
                dbc(() => {
                    core('E')
                })
            }, 400)
            setTimeout(function() {
                resolve(ms)
            }, 800)
        })
    }
    console.log('test1')
    let r1 = await test1()
    console.log(JSON.stringify(r1))
    // test1
    // { name: 'E', i: 1 }
    // [{"name":"E","i":1}]

    function test2() {
        return new Promise((resolve, reject) => {
            let ms = []

            let dbc = debounce(300)

            let i = 0
            function core(name) {
                i++
                ms.push({ name, i })
                console.log({ name, i })
            }

            setTimeout(function() {
                dbc(() => {
                    core('A')
                })
            }, 50)
            setTimeout(function() {
                dbc(() => {
                    core('B')
                })
            }, 100)
            setTimeout(function() {
                dbc(() => {
                    core('C')
                })
            }, 150)
            setTimeout(function() {
                dbc(() => {
                    core('D')
                })
            }, 500)
            setTimeout(function() {
                dbc(() => {
                    core('E')
                })
            }, 550)
            setTimeout(function() {
                resolve(ms)
            }, 1400)
        })
    }
    console.log('test2')
    let r2 = await test2()
    console.log(JSON.stringify(r2))
    // test2
    // { name: 'C', i: 1 }
    // { name: 'E', i: 2 }
    // [{"name":"C","i":1},{"name":"E","i":2}]

}
topAsync().catch(() => {})

Parameters:

(static) delay(msopt, optopt) → {Promise}

Description:

• Promise延遲毫秒

  Unit Test: Github

Source:

• delay.mjs, line 23

Example

need test in browser

delay(1000)
// => 延遲1s才執行

Parameters:

Returns:

Type

Promise

(static) detectXSS(str) → {Array}

Description:

• 偵測字串內之xss攻擊語法，回傳clearXSS會轉義或刪除之可疑項目，供提示用，不改寫資料

  Depend on: https://jsxss.com/zh/index.html

  與clearXSS共用同一份js-xss設定(白名單、網址判定、白名單外之style屬性保留)，判定規則：

  1. 標籤(type為'tag')：白名單外之標籤，名稱由原始標籤片段取得且其後須接空白、斜線、大於或結尾，故含'<svg/onload=...>'，不含'孔深 < 500 m'、'5<6>4'、'<o:p>'；結尾未閉合且無屬性之白名單標籤(如'若 a<b'之'<b')亦不計

  2. 屬性(type為'attr')：白名單內標籤被刪除之事件屬性，名稱為on接英文字母且有值，故不含'ac'之once

  3. 網址(type為'url')：白名單內標籤之href或src被擋下，且依HTML5規則解碼字元參照、刪除tab與換行、刪除開頭控制字元與空白後，協定為javascript、vbscript或data，相對網址被擋不計

  4. 註解：js-xss先刪註解再解析，與瀏覽器之註解規則不同(如'--!>'亦結束註解)，有註解時另保留註解再解析一次取聯集，註解本身不計

  5. 重複項目合併為1筆，依出現順序排列

  限制：style屬性比照clearXSS保留不檢查；非HTML之純文字(如'javascript:alert(1)')不偵測，網址欄位須另檢查協定

  Unit Test: Github

Source:

• detectXSS.mjs, line 95

console.log(detectXSS('<img src=x onerror=alert(1)><script>alert(1)</script>'))
// => [ { type: 'attr', tag: 'img', name: 'onerror' }, { type: 'tag', tag: 'script' } ]

console.log(detectXSS('<svg/onload=alert(1)>'))
// => [ { type: 'tag', tag: 'svg' } ]

console.log(detectXSS('<a href="jav&#x09;ascript:alert(1)">點我</a>'))
// => [ { type: 'url', tag: 'a', name: 'href', scheme: 'javascript' } ]

console.log(detectXSS('<!-- --!><script>alert(1)</script>-->'))
// => [ { type: 'tag', tag: 'script' } ]

console.log(detectXSS('&lt;b&gt; 為粗體標籤'))
// => []

console.log(detectXSS('孔深 < 500 m 且 > 10 m'))
// => []

console.log(detectXSS('若 a<b'))
// => []

console.log(detectXSS('a<b and once>c'))
// => []

console.log(detectXSS('<div style="text-align:center;">圖1 名稱</div>'))
// => []

console.log(detectXSS('<img src="pics/a.png" alt="圖">'))
// => []

let r

r = await detectXSSDyn('<img src=x onerror=alert(1)><script>alert(1)</script>')
console.log(r)
// => [ { type: 'attr', tag: 'img', name: 'onerror' }, { type: 'tag', tag: 'script' } ]

r = await detectXSSDyn('<a href="jav&#x09;ascript:alert(1)">點我</a>')
console.log(r)
// => [ { type: 'url', tag: 'a', name: 'href', scheme: 'javascript' } ]

console.log(dig(0.123456789, 3))
// => '0.123'

console.log(dig(0.123456789, 4))
// => '0.1235'

console.log(digExp(0.000000123456789, 2))
// => '1.23e-7'

need test in browser

domAlert('提示訊息')

domAlert('提示訊息', {type:'error'})

domAlert('提示訊息', {backgroundColor:'rgba(220,220,220,0.3)'})

need test in browser

let html = '<div>abc</div>'
domAppend(document.querySelector('#id'),html)

need test in browser

window.addEventListener('touchstart', (e) => {
    domCancelEvent(e)
})

need test in browser

let r = domCompareText(ele, 'title', 'strOld', 'strNew')
console.log(r)
// => { diff, html }

need test in browser

let ele = document.querySelector('#id')
domConvertToPic(ele, { scale: 3 })
    .then((b64)=>{
        // => data:image/png;base64,iVBORw0KGgoAAAANSU...
    })

need test in browser

domConvertToPicDyn(ele, { scale: 3 })
    .then((b64)=>{
        // => data:image/png;base64,iVBORw0KGgoAAAANSU...
    })

need test in browser

//監聽dom
let de = domDetect(() => {
    return document.querySelector('#id')
})
de.on('resize', (s) => {
    console.log('resize', s)
})
de.on('resizeWithWindow', (s) => {
    console.log('resizeWithWindow', s)
})

//釋放監聽
de.clear()

need test in browser

//監聽dom
let dd = domDrag(document.querySelector('#id'), { group:'group', attIndex: 'dragindex' })

//change
dd.on('change', (msg) => {
    console.log('change', msg)
})
dd.on('start', (msg) => {
    console.log('start', msg)
})
dd.on('move', (msg) => {
    console.log('move', msg)
})
dd.on('enter', (msg) => {
    console.log('enter', msg)
})
dd.on('leave', (msg) => {
    console.log('leave', msg)
})
dd.on('drop', (msg) => {
    console.log('drop', msg)
})

//釋放監聽
dd.clear()

need test in browser

//監聽dom
let divPanel = document.querySelector('#id_panel')
let divBar = document.querySelector('#id_bar')
let getHeighRatio = () => 0.9
let das = domDragBarAndScroll(divPanel, divBar, { getHeighRatio, stopScrollPropagationForPanel: true, stopTouchDragPropagationForPanel: true })
das.on('scrollPanel', () => {})
das.on('pressBar', () => {})
das.on('dragBar', () => {})
das.on('freeBar', () => {})

//釋放監聽
das.clear()

need test in browser

//監聽dom
let dp = domDragPointer(document.querySelector('#id'), { canPress: () => editable })
dp.on('press', (msg) => {})
dp.on('drag', (msg) => {})
dp.on('free', (msg) => {})

//釋放監聽
dp.clear()

need test in browser

let pv = domDragPreview({
    attIdentify,
    containerOpacity: previewOpacity,
    containerBackground: previewBackground,
    containerBorderWidth: previewBorderWidth,
    containerBorderColor: previewBorderColor,
})
pv.createPreview()
pv.removeDragPreview()
pv.clear()

need test in browser

let ele = document.querySelector('#id')
let ev = domDropFiles(ele)
ev.on('getFiles', ({ files, filesTree, entries, cb }) => {
    console.log(files, filesTree, entries)
    cb()
})
ev.on('dropIn', () => {
    console.log('dropIn')
})
ev.on('dropOut', () => {
    console.log('dropOut')
})
ev.on('error', (err) => {
    console.log('error', err)
})

need test in browser

window.addEventListener('mousemove', (e) => {
  console.log(domElementsFromPoint(e.clientX, e.clientY))
})

need test in browser

domFadeIn(document.querySelector('#id'))

domFadeIn(document.querySelector('#id'), { duration: 500, delay: 100, opacityIni: 0.2 })

need test in browser

domFadeOut(document.querySelector('#id'))

domFadeOut(document.querySelector('#id'), { duration: 500, delay: 100, opacityIni: 0.8 })

need test in browser

let ele = domFind('#id')

need test in browser

let eles = domFinds('[name="abc"]')

need test in browser

//<div id="eid" cus_attr="abc"></div>
let r = domGetAttr(document.querySelector('#eid'), 'cus_attr')
conssole.log(r)
// => abc

need test in browser

let r = domGetBoudRect(document.querySelector('#id'))
console.log(r)
// => {
  x:...,
  y:...,
  width:...,
  height:...,
  top:...,
  right:...,
  bottom:...,
  left:...,
}

need test in browser

let r = domGetBoudRectRefSelf(document.querySelector('#id'))
console.log(r)
// => {
  x:...,
  y:...,
  w:...,
  h:...,
}

need test in browser

need test in browser

let ele = document.querySelector('#id')
let r = domGetFiles(ele)

need test in browser

let eleParents = domGetParents(document.querySelector('#id'))

need test in browser

window.addEventListener('mousemove', (e) => {
  console.log(domGetPointFromEvent(e))
})

need test in browser

let eleScrollableParent = domGetScrollableParent(document.querySelector('#id'))