Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

中文文档 #1

Open
lifesinger opened this issue Jun 29, 2013 · 10 comments
Open

中文文档 #1

lifesinger opened this issue Jun 29, 2013 · 10 comments

Comments

@lifesinger
Copy link
Member

加载 seajs-log 插件后,seajs 会拥有 log 方法。

seajs.log Function

苦逼的前端经常会在代码中加入类似下面这种代码:

if (typeof console === 'undefined') {
    console = { log: function() {}, warn: function() {}, ... }
}

为的是上线后,如果某个浏览器不支持 console ,代码不会抛错。

有了 Sea.js,我们再也不用这么去担心受怕了。直接通过 seajs.log 就可以搞定一切:

seajs.log('订单流程', 'group'); // 调用 console.group
seajs.log('a 的值是 ' + a.value); // 调用 console.log
seajs.log('发现错误 ' + msg, 'warn'); // 调用 console.warn
seajs.log('订单流程', 'groupEnd'); // 调用 console.groupEnd

上面是简单示例,只要是 console 支持的方法,都可以作为最后一个参数传进去。默认调用的是 console.log 方法。

注意console.log 信息默认不会显示,在 Sea.js 的 debug 为 true 时才显示。

@litson
Copy link

litson commented Nov 12, 2013

这个有问题,忽略了例如,console.log的第二个参数

//code
console.log("text","font-size:18px");

@lizzie
Copy link
Member

lizzie commented Nov 12, 2013

@litson 特意不支持的. 大多数情况下一个参数就能搞定

see: seajs/seajs#607

@litson
Copy link

litson commented Nov 12, 2013

了解

@hotoo
Copy link
Member

hotoo commented Nov 12, 2013

我想说的实际情况是:

  1. console.log 多个参数的情况很多,是很方便的功能。
  2. 更少的情况会使用 console 的其他方法。
  3. console.log 用法不一致,容易错用。

所以建议 seajs.logconsole.log 保持一致,支持多个参数。
少考虑其他不常用方法,有必要的话可以增加少数几个常用方法如 seajs.error 等。

@hotoo hotoo reopened this Nov 12, 2013
@afc163
Copy link
Member

afc163 commented Nov 12, 2013

同意 @hotoo

seajs/seatools@93c86d3

@lifesinger
Copy link
Member Author

不同意。log 并非 seajs 核心功能,我都想去掉这个功能,记不清楚为何当初只做了简化,而未果断地完全去掉。

@hotoo
Copy link
Member

hotoo commented Nov 13, 2013

删除 seajs.log 也未尝不可,目前这个插件太简单没什么实际用处。
现在只是简单保护不支持 console 的浏览器,而没有做增强。

不一定在 seajs 里,不过我还是有必要有一个全局的调试工具,可以:

  1. 开发、调试(包括生产环境的动态调试)时方便打印出调试信息(兼容多终端)。
  2. 非开发、调试模式下关闭打印调试信息。

@afc163
Copy link
Member

afc163 commented Nov 13, 2013

hotoo 说的不就是 seajs-debug 。

@hotoo
Copy link
Member

hotoo commented Nov 13, 2013

我想说这个可以考虑结合在 seajs-debug 里。

@hotoo
Copy link
Member

hotoo commented Nov 13, 2013

不过不同的是,要求在动态加载 debug 插件之前, xxx.log 是不会报错的。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

5 participants