打印Proxy对象和ref对象的包实现详解
作者：小白不是很聪明
前因
平时工作的时候，我喜欢用console.log调试大法。但Vue3更新后，控制台都是打印的Proxy对象和ref对象，想看里边的值，就需要很麻烦的一层一层的展开。
为了解决这个问题，我试过在编辑器中写一个新的快捷键，快速写出console.log(JSON.parse(JSON.stringify()))。
但我用的是webStorm，它自带的.log快捷键太舒服了，比如这样：abc.log 点击tab键，就自动替换为console.log(abc)。
我试了好久，终究还是没能拓展类似的代码。所以才有了重写console.log()的想法。
目标
我希望新的console.log可以像现在的console.log一模一样，只是当打印Proxy和ref对象时可以直接输出它的源对象或ref.value。并且，还保留记录当前文件和行数的功能，可以让我看到到底是哪个文件哪个步骤执行的打印。
结果
先说结果：
我翻了好久的文档，终究还是不能达到我想要的效果，控制台右侧展示出的打印文档及行号终究还是不能直接显示源文件，如果有大神能看到这篇文章的话，希望告诉我怎么怎么才能实现这个想法。
但退而求其次，我用console.trace 和Error.stack两种方式十分简陋的完成了这个目标。
各位可以去 下载试试，源码也就不到200行，有兴趣的同学可以看看。
实现（直接看源码的同学可以略过）
判断一个对象是否是Proxy
这个不好判断,Vue3添加了isProxy 方法，但如果不是Vue环境的话，那这个方法就失效了。 而且就这么一个简单的小功能，实在没必要依赖其他的包。 最终是选择在用户new Proxy之前，把Proxy对象改造。
// 记录用户new Proxy操作的所有对象
// WeakSet，WeakMap，都是弱引用，不干预其他模块的垃圾回收机制
export const proxyMap = new WeakMap()
let OriginalProxy = null
export function listenProxy() {
if (OriginalProxy) { // 防止用户多次调用监听
return
}
OriginalProxy = window.Proxy
window.Proxy = new Proxy(Proxy, {
construct(target, args) {
const newProxy = new OriginalProxy(...args)
proxyInstances.set(newProxy, target)
return newProxy
},
get(obj, prop) {
// https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Symbol/hasInstance
if (prop === Symbol.hasInstance) { // 监控 `instanceof` 关键字
return instance => proxyMap.has(instance)
}
// https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Reflect/get
return Reflect.get(...arguments)
}
})
}
export function unListenProxy() {
window.Proxy = OriginalProxy || window.Proxy
}
输出用户log的源对象
按说我们上一步已经监控了用户动作，可以获取源对象，等用户log的时候，我们直接输出源对象就可以了。但这也有个问题，Proxy毕竟不是普通的对象，通过Proxy获取的结果，很可能跟源对象没有一毛钱关系。所以只能通过深克隆返回源对象的值，但这也有个问题，就是对于某些不能遍历的对象或属性，就打印不了了……
问题貌似锁死了，但，我们实际运用中，只是为了简简单单输出一个不用展开的源对象而已，甚至运用场景都特别单一：Vue3! 用户如果觉得打印的不准确，换一个api不完了吗，比如我们监控的是console.log，那用户就用console.info一样能输出相同的结果。 把选择权交给用户就好了。在引用包的时候，再写多一个配置项，让用户自己选平时的使用场景哪个正确结果比较多，就选哪个。想要完全正确，就换一个其他的api。
我简直是个天才，哈哈哈
export function getOrg(obj) {
return proxyMap.get(obj)
}
// 深克隆
export function clone(obj, _refs = new WeakSet()) {
if (obj === null || obj === undefined) return null
if (typeof obj !== 'object') return obj
if (obj.constructor === Date) return new Date(obj)
if (obj.constructor === RegExp) return new RegExp(obj)
const newObj = new obj.constructor() //保持继承的原型
for (const key in obj) {
if (obj.hasOwnProperty(key)) {
const val = obj[key]
if (typeof val === 'object' && !_refs.has(val)) {
newObj[key] = clone(val)
} else {
newObj[key] = val
}
}
}
return newObj
}
最后暴露出去给用户调用
import { listenProxy, unListenProxy, clone, getOrg } from "./until";
let config = {
key: 'log', // any String
type: 'trace', // 'trace' | 'error' | 'any String'
cloneProxy: getOrg
}
let Vue = {}
export default function (obj = {}, vue) {
Vue = vue || {}
config = { ...config, ...obj }
if (obj.copy === 'clone') {
config.cloneProxy = clone
}
listenLog(config)
}
// ----------------------------------------
const { groupCollapsed, groupEnd, trace, log } = console
// const type = 'trace' | 'error' | ''
function listenLog() {
const isRef = Vue.isRef || (obj => {
return typeof obj === 'object' && !!obj.constructor && obj.constructor.name === 'RefImpl'
})
const unref = Vue.unref || (obj => obj.value)
const { key, type, cloneProxy } = config
if (!key) {
console.error('Missing required parameter: key')
}
listenProxy() // 为 new Proxy 对象添加 `instanceof` 支持
console[key] = function (...arr) {
const newArr = arr.map(i => {
if (isRef(i)) {
return unref(i)
} else if (i instanceof Proxy) {
return cloneProxy(i)
} else {
return i
}
})
groupCollapsed(...newArr)
// 以 trace
if (type === 'trace') {
// trace(...newArr)
console.log('第二行即为调用者所在的文件位置')
trace('The second line is the file location of the caller')
groupEnd()
return
}
let stack = new Error().stack || ''
// stack = stack.replace('Error', 'Log')
if (type === 'error') {
log('%c这不是一个错误，请点击第二行的"at"，跳转到对应的文件', 'color: #008000')
log('%cThis is not an error. Please click "at" in the second line to jump to the corresponding file', 'color: #008000')
log(stack)
groupEnd()
return;
}
// 简单输入模式，控制台看起来是简单了，却失去了点击链接直接跳转到对应文件的功能
const stackArr = stack.match(/at.*\s/g) || []
log(stackArr[1])
groupEnd()
}
}
至此已全部结束。
再加上一点ts的解释文件，那这个库就能运行在所有平台了
以上就是打印Proxy对象和ref对象的包实现详解的详细内容，更多关于打印Proxy ref对象包的资料请关注脚本之家其它相关文章！