2019 November Release

Using the WAI-ARIA ConnectorPermanent link for this heading

The application types “Browser (Installed)” and “Mobile Browser” (WAI-ARIA Connector) allow using the installed web browsers directly. WAI-ARIA tags identify the several elements of the web page. Currently Fabasoft app.test can use the following browsers

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

InstallationPermanent link for this heading

There are a few settings required on the browsers or systems. Apply the settings on the test clients directly. For each browser there is a  Fabasoft app.test web browser extension.

All required files for installation are either available via a public repository or are located inside the folder jsadaptor  of the installation directory of the app.test agent or the eclipse installation

<EclipseBasePath>/plugins/com.fabasoft.apptest.adaptorbundle.win32.win32.x64_<version>

To be able to test HTTPS, generate an own certificate as described in chapter “Certificates” or add apptestca.pem to the trusted root certification authorities.

Note:

  • Make sure to activate all installed extensions.
  • It is not possible to use protected mode or private browsing.

Google ChromePermanent link for this heading

The Chrome extension is in the Chrome Web Store:

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

EdgePermanent link for this heading

The Edge extension is in the Microsoft App Store:

https://www.microsoft.com/store/productId/9P2JC2VH71D7

The Selenium Edge Driver is a component of Windows. To install it see https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/.

Connecting to localhost must be possible. Enable this with this command:

CheckNetIsolation LoopbackExempt -a -n="Microsoft.MicrosoftEdge_8wekyb3d8bbwe"

Mozilla FirefoxPermanent link for this heading

The Mozilla Firefox extension is called mozillafirefoxwebextension.xpi.

Microsoft Internet ExplorerPermanent link for this heading

The Microsoft Internet Explorer extension is installed by starting microsoftinternetexplorerbho.msi.

Apple SafariPermanent link for this heading

Install the plugin by dragging the file Fabasoft app.test Safari Extension.app into the Application folder.

Add apptestlocal.pem to the keychain. Select “Always Trust” for these certificates.

Note:

  • When connecting the first time with Fabasoft app.test, Fabasoft app.test requests the permission to control Apple Safari. Please confirm this.

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 specify the full 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 containing the relative path to the apptestbasicauth.html.

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