Skip to content

Get started docs #321

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Sep 19, 2024
Merged
Show file tree
Hide file tree
Changes from 5 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,8 @@ public void storeVariables() {
@Test
public void accessibilityExample() {
driver.get("https://www.saucedemo.com/");
//store the accessibility results into an object
Results accessibilityResults = session.getAccessibilityResults();
//if you want, you can assert on the accessibilityResults
}
}
88 changes: 0 additions & 88 deletions website/docs/BROWSER_OPTIONS.md

This file was deleted.

89 changes: 0 additions & 89 deletions website/docs/SAUCE_OPTIONS.md

This file was deleted.

30 changes: 0 additions & 30 deletions website/docs/TEST_RUNNERS.md

This file was deleted.

92 changes: 29 additions & 63 deletions website/docs/core-concepts/Accessibility.md
Original file line number Diff line number Diff line change
@@ -1,34 +1,17 @@
---
id: accessibility
title: Accessibility Testing
---

As of version 1.2, Sauce Bindings supports the new Sauce Labs
As of version 1.2, Sauce Bindings supports the new Sauce Labs
[Deque axe™ Integration](https://docs.saucelabs.com/basics/integrations/deque/index.html)

* The Session classes now have a method to obtain accessibility results, which does two basic things:
* Populates the new Accessibility tab in the Sauce Labs UI for a given job
with the accessibility violations found during the test run.
* Returns the specific violations found in the code. The format of these results varies by language, and it is left to the user
to determine how best to make use of them in their code if so desired.
* The Java code is implemented using Deque's [Axe Core Maven HTML Jar](https://github.com/dequelabs/axe-core-maven-html)
* This implementation provides access to all the advanced features.
* As a wrapper, Sauce bindings provides 3 method signatures for getting accessibility results, as outlined below.
* The Ruby and Python code is implemented with the new [sa11y](https://github.com/saucelabs/sa11y) project
* Sa11y is a minimalist implementation of Deque's axe™ functionality.
* The accessibility results method allows you to specify a different js library, the ability to turn off frame support,
and the ability to turn on cross-origin frame support. Examples are provided below.

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

<Tabs
defaultValue="java"
values={[
{ label: 'Java', value: 'java', },
{ label: 'Python', value: 'python', },
{ label: 'Ruby', value: 'ruby', },
{ label: 'C#', value: 'csharp', },
{ label: 'Java', value: 'java', }
]
}>

Expand All @@ -37,61 +20,44 @@ values={[
<Tabs
defaultValue="junit5"
values={[
{ label: 'JUnit 5', value: 'junit5', },
{ label: 'JUnit 4', value: 'junit4', },
{ label: 'TestNG', value: 'testng', },
{ label: 'Direct', value: 'direct', },
{ label: 'JUnit 5', value: 'junit5', }
]
}>

<TabItem value="junit5">

```java reference
https://github.com/saucelabs/sauce_bindings/tree/website-1.2.0/java/junit5/src/test/java/com/saucelabs/saucebindings/junit5/examples/AccessibilityTest.java
```

</TabItem>
<TabItem value="junit4">

```java reference
https://github.com/saucelabs/sauce_bindings/tree/website-1.2.0/java/junit4/src/test/java/com/saucelabs/saucebindings/junit4/examples/AccessibilityTest.java
```

</TabItem>
<TabItem value="testng">

```java reference
https://github.com/saucelabs/sauce_bindings/tree/website-1.2.0/java/testng/src/test/java/com/saucelabs/saucebindings/testng/examples/AccessibilityTest.java
```

</TabItem>
<TabItem value="direct">
import com.deque.html.axecore.results.Results;
import com.saucelabs.saucebindings.SauceSession;
import com.saucelabs.saucebindings.junit5.SauceBindingsExtension;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.RegisterExtension;
import org.openqa.selenium.WebDriver;

public class AccessibilityExample {
WebDriver driver;
SauceSession session;

@RegisterExtension static SauceBindingsExtension sauceExtension = new SauceBindingsExtension();

@BeforeEach
public void storeVariables() {
session = sauceExtension.getSession();
driver = sauceExtension.getDriver();
}

@Test
public void accessibilityExample() {
driver.get("https://www.saucedemo.com/");
Results accessibilityResults = session.getAccessibilityResults();
}
}

```java reference
https://github.com/saucelabs/sauce_bindings/tree/website-1.2.0/java/main/src/test/java/com/saucelabs/saucebindings/examples/AccessibilityTest.java
```

</TabItem>
</Tabs>

</TabItem>
<TabItem value="python">

```python reference
https://github.com/saucelabs/sauce_bindings/tree/website-1.2.0/python/tests/examples/test_accessibility.py
```

</TabItem>
<TabItem value="ruby">

```ruby reference
https://github.com/saucelabs/sauce_bindings/tree/website-1.2.0/ruby/spec/examples/accessibility_spec.rb
```

</TabItem>
<TabItem value="csharp">

**C# bindings are coming soon...**

</TabItem>
</Tabs>
22 changes: 0 additions & 22 deletions website/docs/core-concepts/Roadmap.md

This file was deleted.

Loading
Loading