2017 October Release

Using the WAI-ARIA ConnectorPermanent link for this heading

When using the application type “HTML Page” the web browser is hosted in a native window and the tests are carried out in this web browser. HTML tags are used to identify the several elements of the web page.

The application types “Browser (Installed)” and “Mobile Browser” (WAI-ARIA Connector) allow using the installed web browsers directly. WAI-ARIA tags are used to identify the several elements of the web page. Current versions of the following clients are supported:

  • Mozilla Firefox (MOZILLA_FIREFOX)
  • Microsoft Internet Explorer (MICROSOFT_INTERNET_EXPLORER)
  • Google Chrome (GOOGLE_CHROME)
  • Apple Safari (APPLE_SAFARI)

Needed web browser or operating system settings have to be set directly on the test clients. In particular the Fabasoft app.test web browser extension has to be installed in the corresponding web browser. The Chrome extension can be found in the Chrome Web Store:

https://chrome.google.com/webstore/detail/fabasoft-apptest/ggaddniaigmhomfjghahijocgmbimlem

The other three extensions can be found in the Eclipse installation directory:

<EclipseBasePath>/plugins/com.fabasoft.apptest.adaptorbundle.win32.win32.x86_<version>/jsadaptor (applesafari.safariextz, mozillafirefox.xpi and microsoftinternetexplorerbho.msi)

Note:

  • Make sure that the extensions are activated after installing them.
  • To be able to test HTTPS, generate an own certificate as described in chapter “Certificates” or add the following certificate to the trusted root certification authorities:
    <EclipseBasePath>/plugins/com.fabasoft.apptest.adaptorbundle.win32.win32.x86_<version>/jsadaptor/apptestca.pem
  • On Apple OS X beside apptestca.pem also apptestlocal.pem has to be added to the keychain. Select “Always Trust” for these certificates.
  • Protected mode and private browsing are not supported.

ProxyPermanent link for this heading

The address 127.0.0.1 must be reachable from the browser and therefore must not be routed through the proxy. Fabasoft app.test uses the system proxy settings when not explicitly configured otherwise.

Basic AuthenticationPermanent link for this heading

When using the WAI-ARIA Connector with a Fabasoft Folio or Fabasoft Cloud domain make sure to fully specify the URL, including the ax parameter.

Example

http://{~webserver~}/fsc/fscasp/content/bin/fscvext.dll?ax=COO.1.1001.1.32498

When using the WAI-ARIA Connector to test a custom website it is necessary to specify the Basic Authentication URL which has to contain the relative path to the apptestbasicauth.html if basic authentication is required.

CertificatesPermanent link for this heading

When testing secure web sites using HTTPS a certificate for 127.0.0.1 has to be issued to enable Fabasoft app.test to interact with the secure site. The path to this certificate in PKCS #12 format along with the corresponding password can be configured in Fabasoft app.test in the settings of the selected web browser.

While such a certificate is included in a Fabasoft app.test installation you might want to create a self-signed certificate for the test hosts yourself. This can be accomplished with the tool openssl (www.openssl.org) following these steps:

  1. Generate RSA Key
  2. Generate Certificate Signing Request (CSR)
  3. Generate self-signed public certificate
  4. Generate PKCS#12 file

Example

openssl genrsa -out cert.key 2048

openssl req -new -key cert.key -out cert.csr -config openssl.cfg

openssl x509 -req -days 9125 -in cert.csr -signkey cert.key -out cert.crt

openssl pkcs12 -keypbe PBE-SHA1-3DES -certpbe PBE-SHA1-3DES -export -in cert.crt -inkey cert.key -out cert.pkcs12 -name "Fabasoft app.test Local Test Certificate"

The resulting PKCS#12 file can then be used by Fabasoft app.test to test secure web pages.

Additionally, this certificate has to be trusted by the web browsers on the test host. It therefore has to be added to the certificate store of the web browsers you wish to use for testing.

Note: On Microsoft Windows operating systems with Microsoft Internet Explorer or Google Chrome the certificate has to be added to the test users’ personal certificate store. Mozilla Firefox has its own application specific certificate store. On Apple OS X the certificate has to be added to test users’ personal keychain and configured to always trust this certificate for SSL connections.

Also, the certificate of the website being tested has to be trusted on a browser or system level (i.e. you have to import the corresponding certificate) if your websites’ certificate is not signed by a certificate authority. Otherwise most web browsers will not allow a connection without user interaction.

Javascript CoveragePermanent link for this heading

If the tested web site or web application is enriched with coverage information using JSCover the WAI-ARIA Connector automatically collects the coverage information before closing a browser session and stores it adjacent to the report of a test run.

Determining the Language of a Web PagePermanent link for this heading

In some cases it might be useful to know the language of the web page or even of a specific control as defined in the lang or xml:lang attribute. This can be achieved with the “Language” option of a set statement.

Example

Fabasoft app.test:

<Set parameter='lang1' location='WINDOWS[0]' options='Language' />

<Set parameter='lang2' location='WINDOWS[0].alert[text "Cloud"]' options='Language' />

HTML:

<html lang="de">

<div id="pluginalertheader" role="alert">
  Fabasoft <span lang="en">Cloud</span>
</div>

Result:

lang1 = de

lang2 = en