bytedo
/
es.shim
1
0
Fork 0
Code Issues Pull Requests Wiki Activity

Compare commits

base: bytedo:master
Branches Tags
bytedo:master
bytedo:2.4.2
bytedo:2.2.0
bytedo:2.1.1
bytedo:2.1.0
bytedo:2.0.2
..
compare: bytedo:2.2.0
Branches Tags
bytedo:master
bytedo:2.4.2
bytedo:2.2.0
bytedo:2.1.1
bytedo:2.1.0
bytedo:2.0.2

No commits in common. "master" and "2.2.0" have entirely different histories.
master ... 2.2.0

13 changed files with 61 additions and 276 deletions
Show Stats Expand all files Collapse all files

38
History.md
View File

@ -1,41 +1,3 @@
2.4.3 / 2024-09-29
==================
* 修复`Object.defineProperty`定义声明
* 增加`Promise.withResolvers`
2.4.2 / 2024-09-12
==================
* 优化字符串转义
2.4.0 / 2024-08-22
==================
* 增加Set的一系列原型方法`union、equal、difference、symmetricDifference、intersection、isSubsetOf、isSupersetOf、isDisjointFrom`
2.3.0 / 2024-08-07
==================
* 增加修复版toFixed
2.2.2 / 2024-03-28
==================
* 增加Obejct.groupBy和Map.groupBy
2.2.1 / 2023-11-06
==================
* 一些小修复
2.2.0 / 2023-07-20
==================
* 数组增加一组原型方法
* 字符串增加版本号大小比较的原型方法
2.1.1 / 2023-02-27
==================
* 修复 Object.prototype.toParams()原型方法
2.1.0 / 2022-01-27
==================
* Array.prototype.item 更名为 Array.prototype.at

22
Readme.md
View File

@ -7,15 +7,10 @@
```js
├── Obejct
│ ├── .empty(any) // 判断对象是否为空对象
│ ├── .groupBy(arr, fn) // 数组分组, 返回分组后的对象
│ └── .hasOwn(any, key) // 安全版的 Object.prototype.hasOwnProperty()
│ └── .empty(any) // 判断对象是否为空对象
├── Obejct.prototype
│ └── .toParams() // 把对象转为 key1=value1&key2=value2 格式
│
├── Map
│ └── .groupBy(any) // 数组分组, 返回分组后的对象
│
├── Array.prototype
│ ├── .flat(depth) // 数组降维
│ ├── .flatMap(fn) // 等价于 map(fn) -> flat(1)
@ -29,16 +24,6 @@
│ ├── .group(fn) // 数组分组
│ └── .groupToMap(fn) // 数组分组, 返回Map对象
│
├── Set.prototype
│ ├── .union(other) // 合并2个集合
│ ├── .equals(other) // 判断2个集合是否一致(仅元素相同, 无关顺序)
│ ├── .difference(fn) // 返回不存在于另一个集合的所有元素集合
│ ├── .symmetricDifference(fn) // 返回当前集合与给定集合中, 不同时存在的所有元素集合
│ ├── .intersection(fn) // 返回共有的元素集合
│ ├── .isSubsetOf(fn) // 判断当前集合是否为给定集合的子集
│ ├── .isSupersetOf(fn) // 判断当前集合是否为给定集合的子超集
│ ├── .isDisjointFrom(fn) // 判断当前集合,是否与给定集合完全不重合
│
├── Date
│ └── .isDate(any) // 判断对象是否为 日期对象
├── Date.prototype
@ -63,12 +48,9 @@
├── Number
│ ├── .parse(str) // 将安全范围内的数字字符串转为数字类型
│ └── .fromString(str) // 将字符串转为数字类型
├── Number.prototype
│ └── .toFixed(digits) // 修正版的toFixed
│
└── Promise
├── .defer() // 创建一个延迟的Promise对象
└── .withResolvers() // 创建一个延迟的Promise对象, 同defer
└── .defer() // 创建一个延迟的Promise对象
```

7
package.json
View File

@ -1,6 +1,6 @@
{
"name": "es.shim",
"version": "2.4.3",
"version": "2.2.0",
"description": "实现部分新API, 以及一些常用的扩展方法",
"keyworks": [
"es5",
@ -19,10 +19,7 @@
"scripts": {
"start": "node ./build.js"
},
"repository": {
"type": "git",
"url": "git+https://git.wkit.fun/bytedo/es.shim.git"
},
"repository": "https://github.com/bytedo/es.shim.git",
"author": "yutent",
"license": "MIT"
}

4
src/index.mjs
View File

@ -4,10 +4,8 @@
* @date 2022/01/27 15:33:09
*/
import './lib/set.js'
import './lib/array.js'
import './lib/object.js'
import './lib/map.js'
import './lib/array.js'
import './lib/string.js'
import './lib/number.js'
import './lib/date.js'

49
src/lib/array.js
View File

@ -7,7 +7,7 @@
* 重写原生的flat方法, 性能提升5~10倍(看数组的结构)
*/
Object.defineProperty(Array.prototype, 'flat', {
value(deep = 1, arr = []) {
value: function (deep = 1, arr = []) {
for (let it of this) {
if (Array.isArray(it) && deep > 0) {
it.flat(deep - 1, arr)
@ -22,7 +22,7 @@ Object.defineProperty(Array.prototype, 'flat', {
})
Object.defineProperty(Array.prototype, 'flatMap', {
value(fn) {
value: function (fn) {
return this.map(fn).flat()
},
writable: true
@ -30,19 +30,20 @@ Object.defineProperty(Array.prototype, 'flatMap', {
if (!Array.prototype.at) {
Object.defineProperty(Array.prototype, 'at', {
value(num) {
value: function (num) {
let n = +num
if (n < 0) {
n += this.length
}
return this[n]
}
},
writable: true
})
}
if (!Array.prototype.findLast) {
Object.defineProperty(Array.prototype, 'findLast', {
value(fn) {
value: function (fn) {
let num = this.length
while (num > 0) {
let item = this[--num]
@ -50,12 +51,13 @@ if (!Array.prototype.findLast) {
return item
}
}
}
},
writable: true
})
// 没有findLast也不会有findLastIndex
Object.defineProperty(Array.prototype, 'findLastIndex', {
value(fn) {
value: function (fn) {
let num = this.length
while (num > 0) {
let item = this[--num]
@ -64,32 +66,36 @@ if (!Array.prototype.findLast) {
}
}
return -1
}
},
writable: true
})
}
// 最新增加的几种方法
if (!Array.prototype.toSorted) {
Object.defineProperty(Array.prototype, 'toSorted', {
value(fn) {
value: function (fn) {
return [...this].sort(fn)
}
},
writable: true
})
Object.defineProperty(Array.prototype, 'toReversed', {
value() {
value: function () {
return [...this].reverse()
}
},
writable: true
})
Object.defineProperty(Array.prototype, 'toSpliced', {
value(...args) {
value: function (...args) {
return [...this].splice(...args)
}
},
writable: true
})
Object.defineProperty(Array.prototype, 'with', {
value(num, val) {
value: function (num, val) {
let n = +num
let arr = [...this]
if (n < 0) {
@ -97,14 +103,15 @@ if (!Array.prototype.toSorted) {
}
arr[n] = val
return arr
}
},
writable: true
})
}
// 数组分组
if (!Array.prototype.group) {
Object.defineProperty(Array.prototype, 'group', {
value(fn) {
value: function (fn) {
let output = {}
if (typeof fn === 'function') {
for (let it of this) {
@ -119,11 +126,12 @@ if (!Array.prototype.group) {
} else {
throw Error('argument callback must be a function.')
}
}
},
writable: true
})
Object.defineProperty(Array.prototype, 'groupToMap', {
value(fn) {
value: function (fn) {
let output = new Map()
if (typeof fn === 'function') {
for (let it of this) {
@ -138,6 +146,7 @@ if (!Array.prototype.group) {
} else {
throw Error('argument callback must be a function.')
}
}
},
writable: true
})
}

13
src/lib/date.js
View File

@ -6,16 +6,17 @@
//获取当天是本月第几周
if (!Date.isDate) {
Object.defineProperty(Date, 'isDate', {
value(obj) {
value: function (obj) {
return obj && typeof obj === 'object' && obj.getTime ? true : false
}
},
writable: true
})
}
if (!Date.prototype.getFullWeek) {
//获取当天是本年度第几周
Object.defineProperty(Date.prototype, 'getFullWeek', {
value() {
value: function () {
let thisYear = this.getFullYear()
let that = new Date(thisYear, 0, 1)
let firstDay = that.getDay()
@ -26,7 +27,7 @@ if (!Date.prototype.getFullWeek) {
//获取当天是本月第几周
Object.defineProperty(Date.prototype, 'getWeek', {
value() {
value: function () {
let today = this.getDate()
let thisMonth = this.getMonth()
let thisYear = this.getFullYear()
@ -39,7 +40,7 @@ if (!Date.prototype.getFullWeek) {
//时间格式化
if (!Date.prototype.format) {
Object.defineProperty(Date.prototype, 'format', {
value(str) {
value: function (str) {
let dt = {
fullyear: this.getFullYear(),
year: this.getYear(),
@ -47,7 +48,7 @@ if (!Date.prototype.format) {
week: this.getWeek(),
month: this.getMonth() + 1,
date: this.getDate(),
day: this.getDay(),
day: this.getDay() + 1,
hours: this.getHours(),
minutes: this.getMinutes(),
seconds: this.getSeconds()

13
src/lib/map.js
View File

@ -1,13 +0,0 @@
/**
* {}
* @author yutent<yutent.io@gmail.com>
* @date 2024/03/28 18:48:08
*/
if (!Map.groupBy) {
Object.defineProperty(Map, 'groupBy', {
value(arr, fn) {
return arr.groupToMap(fn)
}
})
}

20
src/lib/number.js
View File

@ -3,23 +3,12 @@
* @date 2020/09/16 11:58:40
*/
// Number.EPSILON
const NATIVE_TO_FIXED = Number.prototype.toFixed
Object.defineProperty(Number.prototype, 'toFixed', {
value(n) {
return NATIVE_TO_FIXED.call(this + Number.EPSILON, n)
},
writable: true
})
// 简单的数字处理
// 将安全范围内的数字字符串转为数字类型
// 否则转为字符串类型
if (!Number.parse) {
Object.defineProperty(Number, 'parse', {
value(val) {
value: function(val) {
if (typeof val === 'number' || typeof val === 'string') {
val += ''
if (val.startsWith('0') && !val.startsWith('0.')) {
@ -30,10 +19,7 @@ if (!Number.parse) {
}
} else {
if (isFinite(val)) {
if (
val >= Number.MIN_SAFE_INTEGER &&
val <= Number.MAX_SAFE_INTEGER
) {
if (val >= Number.MIN_SAFE_INTEGER && val <= Number.MAX_SAFE_INTEGER) {
val = +val
}
}
@ -48,7 +34,7 @@ if (!Number.parse) {
// 将字符串转为数字类型
if (!Number.fromString) {
Object.defineProperty(Number, 'fromString', {
value(val) {
value: function(val) {
return +val || 0
}
})

23
src/lib/object.js
View File

@ -10,7 +10,7 @@
*/
if (!Object.empty) {
Object.defineProperty(Object, 'empty', {
value(obj) {
value: function (obj) {
try {
for (let i in obj) {
return false
@ -21,32 +21,13 @@ if (!Object.empty) {
})
}
if (!Object.groupBy) {
Object.defineProperty(Object, 'groupBy', {
value(arr, fn) {
return arr.group(fn)
}
})
}
if (!Object.hasOwn) {
Object.defineProperty(Object, 'hasOwn', {
value(obj, key) {
if (obj === null) {
return false
}
return obj.hasOwnProperty(key)
}
})
}
/**
* 将对象转为url参数字符串
* 注意: 这里不会处理复杂类型, 直接按toString结果拼接
*/
if (!Object.prototype.toParams) {
Object.defineProperty(Object.prototype, 'toParams', {
value() {
value: function () {
let params = ''
for (let k in this) {
if (this[k] === void 0) {

6
src/lib/promise.js
View File

@ -4,7 +4,7 @@
*/
if (!Promise.defer) {
Promise.defer = function () {
Promise.defer = function() {
let obj = {}
obj.promise = new Promise((resolve, reject) => {
obj.resolve = resolve
@ -13,7 +13,3 @@ if (!Promise.defer) {
return obj
}
}
if (!Promise.withResolvers) {
Promise.withResolvers = Promise.defer
}

110
src/lib/set.js
View File

@ -1,110 +0,0 @@
/**
* @author yutent<yutent.io@gmail.com>
* @date 2020/09/16 11:54:31
*/
if (!Set.prototype.union) {
// 类似 Array的concat, 合并2个集合, 返回1个新集合, 原集合不发生变化
Object.defineProperty(Set.prototype, 'union', {
value(other) {
let output = new Set([...this])
if (
other.size !== void 0 &&
other.has !== void 0 &&
other.keys !== void 0
) {
for (let it of other.keys()) {
output.add(it)
}
}
return output
}
})
// 同一批 API
// 返回不存在于另一个集合的所有元素集合
Object.defineProperty(Set.prototype, 'difference', {
value(other) {
let output = new Set()
for (let it of this) {
if (!other.has(it)) {
output.add(it)
}
}
return output
}
})
// 返回当前集合与给定集合中, 不同时存在的所有元素集合
Object.defineProperty(Set.prototype, 'symmetricDifference', {
value(other) {
let output = this.difference(other)
for (let it of other) {
if (!this.has(it)) {
output.add(it)
}
}
return output
}
})
// 返回共有的元素集合
Object.defineProperty(Set.prototype, 'intersection', {
value(other) {
let output = new Set()
for (let it of this) {
if (other.has(it)) {
output.add(it)
}
}
return output
}
})
// 判断当前集合是否为给定集合的子集
Object.defineProperty(Set.prototype, 'isSubsetOf', {
value(other) {
for (let it of this) {
if (!other.has(it)) {
return false
}
}
return true
}
})
// 判断当前集合是否为给定集合的子超集
Object.defineProperty(Set.prototype, 'isSupersetOf', {
value(other) {
for (let it of other) {
if (!this.has(it)) {
return false
}
}
return true
}
})
// 判断当前集合,是否与给定集合完全不重合
Object.defineProperty(Set.prototype, 'isDisjointFrom', {
value(other) {
for (let it of this) {
if (other.has(it)) {
return false
}
}
return true
}
})
}
// 判断2个集合是否一致(仅元素相同, 无关顺序)
if (!Set.prototype.equals) {
Object.defineProperty(Set.prototype, 'equals', {
value(other) {
return this.size === other.size && this.isSubsetOf(other)
}
})
}

28
src/lib/string.js
View File

@ -34,7 +34,7 @@ function compare(v1, v2) {
//类似于Array 的splice方法
if (!String.prototype.splice) {
Object.defineProperty(String.prototype, 'splice', {
value(start, len, fill) {
value: function (start, len, fill) {
let length = this.length
let argLen = arguments.length
@ -70,7 +70,7 @@ if (!String.prototype.splice) {
//同php的htmlspecialchars函数
if (!String.prototype.htmlspecialchars) {
Object.defineProperty(String.prototype, 'htmlspecialchars', {
value(sign) {
value: function (sign) {
let str = this.replace(/&(?!\w+;)/g, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;')
@ -89,11 +89,10 @@ if (!String.prototype.htmlspecialchars) {
//htmlspecialchars的还原
if (!String.prototype.tohtml) {
Object.defineProperty(String.prototype, 'tohtml', {
value() {
value: function () {
return this.replace(/&lt;/gi, '<')
.replace(/&gt;/gi, '>')
.replace(/&quot;/gi, '"')
.replace(/&#34;/g, '"')
.replace(/&#39;/g, "'")
.replace(/&amp;/gi, '&')
}
@ -103,7 +102,7 @@ if (!String.prototype.tohtml) {
//简单的过滤xss
if (!String.prototype.xss) {
Object.defineProperty(String.prototype, 'xss', {
value() {
value: function () {
let str = this.htmlspecialchars('ENT_QUOTES')
str = str
.replace(
@ -119,7 +118,7 @@ if (!String.prototype.xss) {
// js特殊字符的转义
if (!String.prototype.escape) {
Object.defineProperty(String.prototype, 'escape', {
value() {
value: function () {
return this.replace(/('|"|&|\\|\}|\{|\(|\)|;|=|\,|&)/g, '\\$1')
}
})
@ -127,13 +126,14 @@ if (!String.prototype.escape) {
if (!String.prototype.at) {
Object.defineProperty(String.prototype, 'at', {
value(num) {
value: function (num) {
let n = +num
if (n < 0) {
n += this.length
}
return this[n]
}
},
writable: true
})
}
@ -143,7 +143,7 @@ if (!String.prototype.at) {
*/
if (!String.prototype.toJson) {
Object.defineProperty(String.prototype, 'toJson', {
value() {
value: function () {
let str = this.replace(/^\?/, '')
let params = decodeURIComponent(str)
.split('&')
@ -161,31 +161,31 @@ if (!String.prototype.toJson) {
// 用于版本号的比较
if (!String.prototype.lt) {
Object.defineProperty(String.prototype, 'lt', {
value(v) {
value: function (v) {
return compare(this, v) === -1
}
})
Object.defineProperty(String.prototype, 'lte', {
value(v) {
value: function (v) {
return compare(this, v) < 1
}
})
Object.defineProperty(String.prototype, 'gt', {
value(v) {
value: function (v) {
return compare(this, v) === 1
}
})
Object.defineProperty(String.prototype, 'gte', {
value(v) {
value: function (v) {
return compare(this, v) > -1
}
})
Object.defineProperty(String.prototype, 'eq', {
value(v) {
value: function (v) {
return compare(this, v) === 0
}
})

4
test/index.js
View File

@ -1,4 +0,0 @@
require('../dist/index.js')
console.log((1.345).toFixed())
console.log((1.345).toFixed(2))