概述

给内部使用的库

不依赖第三方工具, 只依赖基本 API (浏览器环境 API, js API)

分为两个部分:

1. node + browser 环境

2. browser 环境

浏览器环境 API

objectToFormData

将对象转为表单数据

``js
import { assert } from 'chai'

import { objectToFormData } from '#test/index.mjs'

assert.strictEqual(
objectToFormData({ a: 1, b: 2 }).get('a'),
'1',
'objectToFormData 未成功转换',
)

assert.strictEqual(
objectToFormData({ a: 1, b: 2 }).get('b'),
'2',
'objectToFormData 未成功转换',
)

// 复合数据
assert.strictEqual(
objectToFormData({ a: { b: 1 } }).get('a[b]'),
'1',
'objectToFormData 未成功转换',
)
`

node + browser 环境

findKeyPath

在对象或数组中找到指定 key 的链路

返回的顺序为: [第一节点key, 第二节点key, ..., 当前指定key]

`js
import { assert } from 'chai'

import { findKeyPath } from '#test/index.mjs'

// 默认比较 key, 遍历 children
assert.deepEqual(
findKeyPath(
{
key: 1,
children: [
{
key: 2,
children: [{ key: 3 }],
},
{
key: 4,
children: [{ key: 5 }],
},
],
},
5,
),
[1, 4, 5],
)

// 改变比较的 key, 遍历的 key 名
assert.deepEqual(
findKeyPath(
{
id: 1,
list: [
{
id: 2,
list: [{ id: 3 }],
},
{
id: 4,
list: [{ id: 5 }],
},
],
},
3,
{
recurseKeyName: 'list',
diffKeyName: 'id',
},
),
[1, 2, 3],
)

assert.deepEqual(
findKeyPath(
[
{
id: '1',
list: [
{
id: '1-1',
list: [{ id: '1-1-1' }],
},
{
id: '1-2',
list: [{ id: '1-2-1' }],
},
],
},
{
id: '2',
list: [
{
id: '2-1',
list: [{ id: '2-1-1' }],
},
{
id: '2-2',
list: [{ id: '2-2-1' }],
},
],
},
],
'2-2-1',
{
recurseKeyName: 'list',
diffKeyName: 'id',
},
),
['2', '2-2', '2-2-1'],
)
`

getFileNameFromCD

通过 header 的 Content-Disposition 获取文件名

`js
import { assert } from 'chai'

import { getFileNameFromCD } from '#test/index.mjs'

assert.strictEqual(
getFileNameFromCD("attachment;filename*=utf-8''研发非人力费用管理.xlsx"),
'研发非人力费用管理.xlsx',
)

assert.strictEqual(
getFileNameFromCD(
"attachment;filename*=utf-8''%E7%A0%94%E5%8F%91%E9%9D%9E%E4%BA%BA%E5%8A%9B%E8%B4%B9%E7%94%A8%E7%AE%A1%E7%90%86.xlsx",
),
'研发非人力费用管理.xlsx',
)

assert.strictEqual(
getFileNameFromCD('', {
defaultFileName: '研发非人力费用管理.xlsx',
}),
'研发非人力费用管理.xlsx',
)
`

getType

得到变量的类型

`js
import { assert } from 'chai'

import { getType } from '#test/index.mjs'

assert.strictEqual(getType([]), 'array')
assert.strictEqual(getType({}), 'object')
assert.strictEqual(getType(1), 'number')
assert.strictEqual(getType('yomua'), 'string')
assert.strictEqual(getType(true), 'boolean')
assert.strictEqual(getType(Symbol(1)), 'symbol')
assert.strictEqual(getType(null), 'null')
assert.strictEqual(getType(undefined), 'undefined')
assert.strictEqual(getType(BigInt(1)), 'bigInt')
assert.strictEqual(
getType(function () {}),
'function',
)
`

isType

判断变量的类型

`js
import { assert } from 'chai'

import { isType } from '#test/index.mjs'

assert.strictEqual(isType([], 'array'), true)
assert.strictEqual(isType({}, 'object'), true)
assert.strictEqual(isType(1, 'number'), true)
assert.strictEqual(isType('yomua', 'string'), true)
assert.strictEqual(isType(true, 'boolean'), true)
assert.strictEqual(isType(Symbol(1), 'symbol'), true)
assert.strictEqual(isType(null, 'null'), true)
assert.strictEqual(isType(undefined, 'undefined'), true)
assert.strictEqual(isType(BigInt(1), 'bigInt'), true)
assert.strictEqual(
isType(function () {}, 'function'),
true,
)
assert.strictEqual(
isType(async function () {}, 'asyncFunction'),
true,
)
`

isNil

判断变量是否为 null 或 undefined

`js
import { assert } from 'chai'

import { isNil } from '#test/index.mjs'

assert.strictEqual(isNil(null), true, 'isNil 未成功校验 null')
assert.strictEqual(isNil(undefined), true, 'isNil 未成功校验 undefined')
assert.strictEqual(isNil(), true, 'isNil 未成功校验 undefined')
assert.strictEqual(isNil({}), false, 'isNil 未成功校验 其他值')
assert.strictEqual(isNil(''), false, 'isNil 未成功校验 其他值')
assert.strictEqual(isNil(1), false, 'isNil 未成功校验 其他值')
assert.strictEqual(isNil(true), false, 'isNil 未成功校验 其他值')
assert.strictEqual(isNil(Symbol(1)), false, 'isNil 未成功校验 其他值')
assert.strictEqual(isNil(BigInt(1)), false, 'isNil 未成功校验 其他值')
assert.strictEqual(isNil([]), false, 'isNil 未成功校验 其他值')
assert.strictEqual(
isNil(function () {}),
false,
'isNil 未成功校验 其他值',
)
`

parseQueryString

解析查询字符串

`js
import { assert } from 'chai'

import { parseQueryString } from '#test/index.mjs'

assert.deepEqual(parseQueryString('?key=value1&key2=value2'), {
key: 'value1',
key2: 'value2',
})
``