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文件中就能看到測試結果了。