AChecker + Selenium2对需要登录的页面进行自动化可访问性测试

前言：这段时间还算比较空闲，我准备把过去做过的有些形形色色，甚至有些奇怪的研究总结一下，也许刚好有人用的着也不一定，不枉为之抓耳挠腮的时光和浪费的电力。

 

名词解释：

网站可访问性测试：国内基本没有什么开展，简单又不太科学地说，就是让盲人，色弱，聋哑人也可以访问的网站。网站只有符合很多的编码和布局标准，屏幕阅读器才能很好地帮助残疾人访问这个网站。在美国，可访问性是立法了的，政府或者政府资助的网站，必须符合一定的可访问性标准，即所谓的508 section。

AChecker：一个php的，开源的，在线可访问性检查工具。和所有其他的在线可访问性检查工具一样，它没办法检查需要登录的页面。但是好在它开源，我们可以修改它的源代码来达到目的，这就是本文的主旨.

AChecker源码可以从这里获取：http://www.atutor.ca/achecker/download.php

 

部署Achecker

首先的首先，你需要下载AChecker的源码进行部署，这个就不具体讲了，我是部署在WampServer上的，地址是localhost:8080

 

1，首先，我们需要用Selenium2来对你需要测试的网站进行登录（这一步的代码就省略了），然后获取登录后页面的cookie

//这里省略登录操作代码若干行
//...

String url = "the_page_url_which_can_access_after_login";
String cookie = ExtractCookie(url);

public String ExtractCookie(String url)
        {
            //get the cookie which contains login information
            string cookie = "Cookie: ";
            foreach (OpenQA.Selenium.Cookie c in driver.Manage().Cookies.AllCookies)
            {
                if (url.Contains(c.Domain))
                {
                    cookie += c.Name + "=" + c.Value + "; ";
                }
            }
            // cookie += "domain=limeade.info; expires=Sun, 10-Jan-2016 08:43:06 GMT; path=/";
            return cookie;
        }

 

2, 对AChecker源代码修改。我们需要对AChecker提供的RESTful Api进行一些修改，增加一个参数，用于传递cookie。找到checkacc.php文件，做如下修改（粗体标出）

//前面省略N行
// 。。。

$uri = trim(urldecode($_REQUEST['uri']));
$web_service_id = trim($_REQUEST['id']);
$guide = trim(strtolower($_REQUEST['guide']));
$output = trim(strtolower($_REQUEST['output']));
$offset = intval($_REQUEST['offset']);
$cookie = trim(urldecode($_REQUEST['cookie']));

// initialize defaults for the ones not set or not set right but with default values
if ($output <> 'html' && $output <> 'rest')
    $output = DEFAULT_WEB_SERVICE_OUTPUT;
// end of initialization

// validate parameters
if ($uri == '')
{
    $errors[] = 'AC_ERROR_EMPTY_URI';
}
else
{
    if (Utility::getValidURI($uri) === false) $errors[] = 'AC_ERROR_INVALID_URI';
}

if ($web_service_id == '')
{
    $errors[] = 'AC_ERROR_EMPTY_WEB_SERVICE_ID';
}
else
{ // validate web service id
    $usersDAO = new UsersDAO();
    $user_row = $usersDAO->getUserByWebServiceID($web_service_id);

    if (!$user_row) $errors[] = 'AC_ERROR_INVALID_WEB_SERVICE_ID';

    $user_id = $user_row['user_id'];
}

// return errors
if (is_array($errors))
{
    if ($output == 'rest') {
        header('Content-type: text/xml');
        echo RESTWebServiceOutput::generateErrorRpt($errors);
    } else {
        echo HTMLRpt::generateErrorRpt($errors);
    }

    exit;
}

// generate guidelines
$guides = explode(',',$guide);

$guidelinesDAO = new GuidelinesDAO();
foreach ($guides as $abbr)
{
    if ($abbr == '') continue;

    $row = $guidelinesDAO->getEnabledGuidelinesByAbbr($abbr);

    if ($row[0]['guideline_id'] <> '') $gids[] = $row[0]['guideline_id'];
}

// set to default guideline if no input guidelines
if (!is_array($gids)) $gids[] = DEFAULT_GUIDELINE;

// retrieve user link ID
$userLinksDAO = new UserLinksDAO();
$user_link_id = $userLinksDAO->getUserLinkID($user_id, $uri, $gids);

// set new session id
$userLinksDAO->setLastSessionID($user_link_id, Utility::getSessionID());

// validating uri content
// Create a stream
$opts = array(
  'http'=>array(
    'method'=>"GET",
    'header'=>$cookie
  )
);
$context = @stream_context_create($opts);
$validate_content = @file_get_contents($uri, false, $context);

if (isset($validate_content))

//后面省略N行
// 。。。

 

3，调用修改后的API，去请求一个需要登录的网页，进行可访问性测试 --

//request string
    string request = "http://localhost:8080/checkacc.php" +
        "?uri=" + HttpUtility.UrlEncode(url) +
        "&id=" + HttpUtility.UrlEncode("3ed23fc9d02d24fe4aa72cf63202076dae7a12fd") +
        "&output=html" +
        "&guide=" + "508,WCAG2-AA" +
        "&cookie=" + HttpUtility.UrlEncode(cookie);

    HttpWebRequest req = (HttpWebRequest)WebRequest.Create(request);
    HttpWebResponse resp = (HttpWebResponse)req.GetResponse();
    StreamReader reader = new StreamReader(resp.GetResponseStream());
    String html = reader.ReadToEnd();

这里稍微解释一下RESTful API中各个参数

uri : 就是你要进行可访问性测试的页面

id : web service服务id，需要在你自己部署的AChecker上注册一个用户，然后在profile页面就会给你一个id

output：测试结果的返回方式，html或者xml

guide：根据哪个标准进行测试，这里选了508和WCAG2-AA这2个可访问性标准。

cookie：就是我们自己加的参数。

 

最后结果放在了String html中，把它保存到.htm文件中就能看到测试结果了。