藏井阁

" Scientists ask why, engineers ask why not? "

使用JSLint校验脚本 – EditPlus增加JSLint插件

JSLint是Douglas Crockford提供的一个语法检测工具,用来检测是否使用了Javascript中“不好的部分”,避免隐含的错误,规范代码书写习惯。在线检测地址为www.jslint.com

每次将代码复制到浏览器中检测,还是有点麻烦,在比较紧急的情况下,甚至忽略或忘记。在IDE中集成这个作为插件,在提交测试前运行一下,更加方便快捷。鉴于目前的国内网络环境,本地检测更是一种永久可行的方法。

本文以Editplus为例,安装此功能。

为EditPlus添加JSLint的方案

一种方法是直接使用jslint.js文件来检测,但实际中不完善,可以参见这篇介绍《editplus中的jslint》

另外一种方法是对jslint.js进行封装,比较完善。配置方式见《JSLint for EditPlus 检验js语法》

此插件包含两个文件:JSLint.wsf和JSLint.js,可以从http://www.jslint.com/fulljslint.js下载最新版本来替换解压后的JSLint.js。Editplus通过WScript.exe执行JSLint.wsf,将当前文件的内容给JSLint.js检测,并输出检测结果。

JSLint插件不支持含非英文字符的UTF-8编码的文件

但这个插件存在一个问题:仅支持ASCII编码的校验,对于包含中文的UTF-8编码的文件会停止校验。

打开JSLint.wsf,里面读取文件的时候,默认都采用了ASCII的编码读取的,所以对非ASCII编码的文件不会正常校验。

原因

在JSLint.wsf的最后的部分可以找到如下代码:

if(args.length>0) {
	var fso = new ActiveXObject("Scripting.FileSystemObject"),
		file = fso.OpenTextFile(filepath),
		cot = file.ReadAll();
	JSLINT(cot);
	var report = JSLINT.reportTXT();
	WScript.StdOut.Write(report);
 }
 WScript.Quit();

这里采用FSO的OpenTextFile获取文件内容。OpenTextFile的格式为:

object.OpenTextFile(filename[, iomode[, create[, format]]])

format指定了读取文件的编码格式,其值可以为:

  • -2:采用系统默认编码
  • -1:采用Unicode
  • 0:采用ASCII,默认值

其默认值为0,也就是读取ASCII编码的文件,不支持指定编码为UTF-8,所以针对UTF-8编码的文件会报错。

解决方案

为了支持对UTF-8文件的检测,改用ADODB.Stream读取文件,将这段代码改写如下:

if(args.length>0) {
/**
	var fso = new ActiveXObject("Scripting.FileSystemObject"),
		file = fso.OpenTextFile(filepath),
		cot = file.ReadAll();
/**/
	var stream = new ActiveXObject("ADODB.Stream"),
	cot = '';

	stream.Mode = 3;  // 常用值 1:读,2:写,3:读写,当前环境之允许用3
	stream.Type = 2;  // 1:二进制,2:文本(默认)
	stream.Charset = 'UTF-8';  // 指定编码
	stream.Open();
	stream.LoadFromFile(filepath);
	cot = stream.ReadText(-1);  // 读取全部内容
	stream.Close();

	JSLINT(cot);

	var report = JSLINT.reportTXT();
	WScript.StdOut.Write(report);
}
WScript.Quit();

这样,就可以对UTF-8进行JSLint的检测了。

你也可以直接下载修改好的JSLint插件文件。

TODO

目前是根据个人常用的文件编码方式(如UTF-8),将其硬编码到JSLint.wsf中的,最好是能够自动识别文件编码并读取和校验。这将涉及编码方式的检测,尤其是到对无BOM的UTF-8文件检测。

参考资料:

在 Windows 中的 Windows 脚本宿主的概述

原版本EditPlus.JSLint

Reading and Writing Binary Files Using JScript

OpenTextFile Method

Stream Object (ADO)

类别: Web开发

Tags: Editplus,JSLint,编码

damon pang

大魔

Damo

i#impng.com

专注Web开发,爱电影,爱One Piece.