更酷的 Console,更简单的输出方式,Enjoy it in Vue ~

Github: https://github.com/TaroXin/vue-pretty-logger

Table of content

  • 老生常谈 Console
  • 不如换种姿势?
  • vue-pretty-logger 做了什么
  • 安装方式
  • 开始使用
  • 使用命令输出
  • Loader Option 配置项
  • Example
  • 提交 Issues

老生常谈 Console

提起浏览器的 Console API,相比大家都觉得是老生常谈了,在我们刚开始学习前端到使用各种框架驰骋在前端界之间,Console 的使用频率从来不会很低,不管是通过 Console.log() 打印一条信息,还是 Console.error() 去输出错误信息,都不免接触到 Console

但是,有时候我会觉得 Console 很无趣,不管是原生的 API,还是网上封装的各种各样的库,都没有什么新意,永远在几个 API 之间徘徊,而vue-pretty-logger的出现就是打破 Console 的限制,谁指定 Console 就必须这样用?

vue-pretty-logger只让你有两点感受,酷,简单

不如换种姿势?

来看看 Console 是怎么使用的

let num = 123
console.log(num) // result -> 123

其实不难理解,毕竟 Console 的 API 如此简单,网上有很多关于 Console 的具体使用方式,笔者在这里就不赘述了

再来看看 vue-pretty-logger

let num = 123 // {#}
// result -> 123

如果你不理解做了什么,接下来我会详解,但是从表面上来讲,我们不必要去多写一句输出了,而且这种方式比较倾向于 Hack,所以使用起来会很酷

vue-pretty-logger 做了什么

vue-pretty-logger 将你原来需要多写的一句 console.log() 简化成了 // {#} 的写法,在 loader 执行期间,获得该注释,并转换为相应的 console 进行输出

简单来讲,vue-pretty-logger 做了你自己不想做的

有没有觉得突然世界都好玩了许多,OK,程序界惯例,我们来输出一只 Hello World

安装方式

你可以使用 npm or yarn 来安装 vue-pretty-logger,因为 logger 本身的性质就处于开发环境,所以你最好加上 -D or --dev 选项,这样在生产环境就不会打包此代码

npm install -D vue-pretty-logger
// or
yarn add --dev vue-pretty-logger

请确认你下载的是最新版本,因为新功能的使用只在最新版本中存在

首先,你得知道一点,vue-pretty-logger 其实是一个 webpack loader, 也就是说,你只需要将它配置在 webpack 对于 .vue 文件的处理 loader 之中就可以了

...
module: {
    rules: [
        {
            test: /.vue$/,
            use: [
                {
                    'vue-loader'
                },
                {
                    'vue-pretty-logger',
                    options: {
                        ...
                    }
                }
            ]
        }
    ]
}
...

需要注意的是,vue-pretty-logger 必须在 vue-loader 之前处理 .vue 文件, 所以,它必须处于 use 数组的最后一位

开始使用

接着,你就可以在你的 .vue 文件之中使用 vue-pretty-logger 了,如下

<template>
    <div></div>
</template>
<script>
    export default {
        mounted () {
            const str = 'Hello World' // {#} -e    
        }
    }
</script>

Perfect,成功输出 Hello World,但是, -e,又代表什么意思呢,该命令指定了当前的输出级别是 error 级别,一会我们会看到更多的命令

我们来看看 vue-pretty-logger 具体可以应用到什么地方

变量赋值

let str = 'Hello World' // {#}
// equals: console.log(str)
str = 'Goodbye World' // {#}
// equals: console.log(str)

函数声明

<script>
    export default {
        mounted () {
        },
        methods: {
            testFunc (p1, p2) { // {#} -sign
                // equals: console.log(p1, p2)
            }
        }
    }
</script>

函数调用

<script>
    export default {
        mounted () {
            this.testFunc(1, 'Hello') // {#} -stop -time
            // equals: const result = this.testFunc(1, 'Hello'); console.log(result)
        },
        methods: {
            testFunc (p1, p2) { // {#} -i -t TestFunc
            }
        }
    }
</script>

你可以为你的注释后面加上更多的命令来达成你的目的,当然前提是你懂得这些命令该怎么用

使用命令输出

输出级别命令有四个,-e -d -w -i,分别代表 console 的四个输出级别,error debug warn info,你可以在注释语句后面加指定的命令来输出指定的级别,如果你添加了多个级别命令,那么优先级为 -e > -d > -w > -i

其他命令如下

-t 你可以指定当前打印的使用应用什么 Tag 方便你去区分繁多的 Console 内容,-t TestFunc 将会为打印结果加上一个 TestFunctag,前提是该输出语句拥有级别命令中的任意一种,结果如下

// 调用该函数
this.testFunc('Hello', 'World')

-i -t TestFunc

-sign 用来给输出的日志信息打上标记,比如上面的函数使用 -sign 之后的结果如下

// 调用该函数
this.testFunc('Hello', 'World') // {#} -sign

-count 用来输出函数被调用的次数,同样,我们以 testFunc 来做实验,结果如下

// 调用该函数
this.testFunc('Hello', 'World') // {#} -count

-time 用来记录函数执行所需要的时间,修改我们的函数调用,结果如下

// 调用该函数
this.testFunc('Hello', 'World') // {#} -time

我们发现,控制台多打印了一行 undefined,来告诉我们方法的返回值,但是我们不需要这个信息,只需要获得方法的执行时间,那么就需要下面的命令

-stop 停止默认动作,结果如下

// 调用该函数
this.testFunc('Hello', 'World') // {#} -time -stop

-profile 为你的函数添加一个 profile,相当于 console.profile() console.profileEnd()

// 调用该函数
this.testFunc('Hello', 'World') // {#} -time -stop -profile

如果你不愿意用 // {#} 的方式来表示打印注释,或者想要设定一个全局的 tag,那么 Option 就派上用场了

Loader Option 配置项

hook 配置项,默认为 #, 修改 hook 就可以达到修改 // {#} 的目的,比如我想修改为 Log,那么需要指定 hook: 'Log',结果如下

this.testFunc('Hello', 'World') // {Log} -time -stop

tag 配置项,则是指定一个全局的 Tag,你可以这样修改,tag: 'PrettyLogger'

infoTag 配置项,指定 -i 输出时的前缀,默认为 INFO

infoTagStyle 配置项, 指定输出的样式,样式格式为 css 格式

error warn debug 的配置项与 info 一致

Example

你可以在 Github 仓库找到 example/,仓库地址为 https://github.com/TaroXin/vue-pretty-logger,如果你觉得vue-pretty-logger符合你的口味,那不妨点击一下 star,毕竟支持就是动力

提交 Issues

如果你在使用过程中碰到了任何的疑问,欢迎提交 Issues,你的建议将让 vue-pretty-logger 越来越完美,不过我们的发展方向只有一个,酷,简单