This script shows how Raakt can be used in a simple Ruby script to test a remote web page.
First, make sure you have installed Raakt (follow the installation instructions if necessary).
Then, install the WWW::Mechanize library (it will be used to fetch remote web pages) by opening a command prompt and type:
gem install mechanize
Now, open your favourite text editor and paste the following code into it:
require 'mechanize' require 'raakt' #Parse command line url argument to get URL url = ARGV[0] #Set up mechanize agent agent = WWW::Mechanize.new # Get the page page = agent.get(url) # Set up the RAAKT test and pass html and headers raakttest = Raakt::Test.new(page.body, page.header.to_hash) #Run all checks and print result to the console result = raakttest.all if result.length > 0 puts "Accessibility problems detected:" puts result else puts "No measurable accessibility problems were detected." end
Save the file as test.rb, navigate to the folder where you saved the file and type:
ruby test.rb http://www.microsoft.com
This will fetch the Microsoft.com start page and run all the Raakt tests on it.
Output will look similar to below. Each error message is reported as
Issue identifier: Issue text
For a list of error messages and their explanations see the Raakt test documentation.
Accessibility problems detected:
ambiguous_link_text: One or more links have the same link text ('Microsoft.com H
ome'). Make sure each link is unambiguous.
field_missing_label: A field (with id/name 'q') is missing a corresponding label element. Make sure a label exists for all visible fields.
wrong_h_structure: Document heading structure is wrong.