awslabs/wdio-aws-device-farm-service

AWS Device Farm service for WebdriverIO

AWS Device Farm Service for WebdriverIO

AWS Device Farm service for WebdriverIO.

This service only supports desktop browser testing.

Upgrading to WebDriverIO v8

The package now provides support for WebDriverIO v8 starting from version v8.0.0. However, please note that WebDriverIO v7 will continue to be supported until the end of its LTS support in October 2023.

With the major version upgrade to v8, this package has transitioned to the ES module system. And it now emits both CommonJS (CJS-) and ECMAScript Modules (ESM-) compatible modules.

Installation

npm install --save-dev wdio-aws-device-farm-service

Example

You can run the provided example with npm run example. It requires:

1. An AWS Device Farm project ARN as an environment variable PROJECT_ARN
2. AWS Credentials (see docs). Note that AWS Device Farm only supports us-west-2. You can force an AWS region with the AWS_REGION environment variable.

For example, this is how it would look like using AWS temporary credentials:

export PROJECT_ARN="<your project arn>"
export AWS_ACCESS_KEY_ID="<aws access key id>"
export AWS_SECRET_ACCESS_KEY="<aws secret access key>"
export AWS_SESSION_TOKEN="<aws session token>"
export AWS_REGION="us-west-2"

npm run example

Security

See CONTRIBUTING for more information.

Getting Help

The best way to interact with our team is through GitHub. You can open an issue to get help or to report any issues you experience.

License

This project is licensed under the Apache-2.0 License.

wdio-aws-device-farm-service's Issues

Retrieve session arn or Id after test run

Hi, Is there a way to retrieve and print out the session arn or id after a test run so that we could lookup the corresponding test in Device Farm console?

Safari Support

Hello! This tool has been great so far, very straightforward to set up.

I am wondering how to enable safari support?

My capabilities & services look like this

capabilities: [
    {
      maxInstances: 5,
      browserName: "chrome",
      acceptInsecureCerts: true,
    },
    {
      maxInstances: 5,
      browserName: "firefox",
      acceptInsecureCerts: true,
    },
    {
      maxInstances: 1,
      browserName: "safari",
    },
  ],
...

services: [
    [
      launcher,
      {
        projectArn: process.env.PROJECT_ARN,
      },
    ],
    [
      "safaridriver",
      {
        outputDir: "./logs",
        logFileName: "wdio-safaridriver.log",
      },
    ],
  ],

and i receive these errors when trying to run the test

[2-0] 2022-04-13T22:26:18.017Z ERROR webdriver: invalid argument: 2 validation errors detected: Value 'safari' at 'desiredCapabilities.browserName' failed to satisfy constraint: Member must satisfy value set: [firefox, chrome, internet explorer, MicrosoftEdge]; Value 'safari' at 'capabilities.alwaysMatch.browserName' failed to satisfy constraint: Member must satisfy value set: [firefox, chrome, internet explorer, MicrosoftEdge]

[2-0] 2022-04-13T22:26:18.021Z ERROR @wdio/runner: Error: Failed to create session.
[2-0] 2 validation errors detected: Value 'safari' at 'desiredCapabilities.browserName' failed to satisfy constraint: Member must satisfy value set: [firefox, chrome, internet explorer, MicrosoftEdge]; Value 'safari' at 'capabilities.alwaysMatch.browserName' failed to satisfy constraint: Member must satisfy value set: [firefox, chrome, internet explorer, MicrosoftEdge]

at first i thought this was an error with wdio or my config, but i am able to run tests with this same config locally and things are all working with safari.

Can wdio-aws-device-farm-service be used to run appium tests?

Can wdio-aws-device-farm-service be used to run appium tests?

Use this package with appium

Hi,
Thanks for this service.
Is that possible to use it with appium?

Integração do WebdriverIO para executar os testes mobile app

Could you create some configuration that allows you to run WebdriverIO mobile tests on the AWS device farm, without running via browser?