Testbeispiel in JavaScript
Not for use with personal data
Sehen Sie sich unbedingt den vollständigen Appium-Einrichtungsleitfaden mit axe DevTools Mobile an, wenn Sie gerade erst anfangen, oder stöbern Sie durch weitere Beispiele für axe DevTools Mobile mit Appium in anderen Sprachen.
Vollständiges Beispiel mit UIAutomator2
const webdriverio = require('webdriverio')
describe('DebugTest', () => {
let driver
//The axeSettings object still accepts apiKey and axeServiceUrl but is not required if you are going to make one time beforeAll annotated call to 'mobile: axeStartSession'
const axeSettings = {
tags: ['appium', 'qa'],
uploadToDashboard: true,
ignoreRules: ['ScreenOrientation'],
}
const apiKey = '<YOUR_API_KEY>'
const projectId = '<YOUR_DEV_HUB_PROJECT_ID>'
//It is very important to make a call to 'mobile: axeStartSession' inside beforeAll annotated methods to setup your session for posting to axe Developer Hub.
beforeAll(async () => {
const capabilities = {
platformName: 'Android',
'appium:deviceName': 'Android',
'appium:appPackage': '<YOUR_APP_PACKAGE_NAME>',
'appium:appActivity': '.MainActivity',
'appium:automationName': 'AxeUiAutomator2',
'appium:uiautomator2ServerLaunchTimeout': 60000,
'appium:uiautomator2ServerInstallTimeout': 60000,
'appium:adbExecTimeout': 60000,
'appium:ignoreHiddenApiPolicyError': true,
'appium:disableWindowAnimation': true,
'appium:waitForIdle': true,
'appium:commandTimeout': 300,
'appium:noReset': false,
'appium:fullReset': false,
}
driver = await webdriverio.remote({
protocol: 'http',
hostname: 'localhost',
port: 4723,
path: '/',
capabilities,
})
//Make one time call to setup your session for posting to Dev Hub.
//This also accepts axeServiceUrl in case of private instance.
const axeAuthSettings = {
apiKey: apiKey,
projectId: projectId,
}
await driver.execute('mobile: axeStartSession', axeAuthSettings)
}, 60000)
afterAll(async () => {
if (driver) {
await driver.deleteSession()
}
})
const dismissSystemUIError = async () => {
try {
const systemPopup = await driver.$('//*[contains(@text, "System UI")]')
await systemPopup.waitForDisplayed({ timeout: 5000 })
if (await systemPopup.isDisplayed()) {
const waitButton = await driver.$('//*[contains(@text, "Wait")]')
await waitButton.waitForDisplayed({ timeout: 5000 })
await waitButton.click()
console.log("Dismissed the System UI error popup by clicking 'Wait'.")
}
} catch (e) {
console.log('No System UI error popup appeared.')
}
}
const launchApp = async () => {
try {
await driver.terminateApp('<YOUR_APP_PACKAGE_NAME>')
await driver.pause(1000) // Give the app time to fully terminate
} catch (e) {
console.log(`App was not running or failed to terminate: ${e.message}`)
}
await driver.activateApp('<YOUR_APP_PACKAGE_NAME>')
try {
const element = await driver.$('//*[contains(@text, "Screen Name")]')
await element.waitForDisplayed({ timeout: 30000 })
} catch (e) {
await dismissSystemUIError()
// Try again after dismissing the error (if not, then fail)
const element = await driver.$('//*[contains(@text, "Screen Name")]')
await element.waitForDisplayed({ timeout: 30000 })
}
}
beforeEach(async () => {
await launchApp()
})
//Now since your session is authenticated you can keep making 'mobile: axeScan' call like below in test1 and test2. The scans will be uploaded to the dashboard and axe Developer Hub.
it('test1', async () => {
const element = await driver.$('//*[contains(@text, "Screen Name")]')
await element.waitForDisplayed({ timeout: 10000 })
console.log(await element.getText())
const appiumScanResult = await driver.execute(
'mobile: axeScan',
axeSettings
)
const results = appiumScanResult.axeRuleResults
console.log('debug: Total results: ' + results.length)
})
it('test2', async () => {
const element = await driver.$('//*[contains(@text, "Screen Name")]')
await element.waitForDisplayed({ timeout: 10000 })
element.click()
await driver.$('//*[contains(@text, "announced by a screen")]')
const appiumScanResult = await driver.execute(
'mobile: axeScan',
axeSettings
)
const results = appiumScanResult.axeRuleResults
console.log('debug: Total results: ' + results.length)
})
})Vollständiges Beispiel mit XCUITest
const { remote } = require('webdriverio')
describe('iOS Maps DebugTest', () => {
let driver
//The axeSettings object still accepts apiKey and axeServiceUrl but is not required if you are going to make one time beforeAll annotated call to 'mobile: axeStartSession'
const axeSettings = {
tags: ['appium', 'qa', 'ios'],
uploadToDashboard: true,
ignoreRules: ['ScreenOrientation'],
}
const apiKey = '<YOUR_API_KEY>'
const projectId = '<YOUR_DEV_HUB_PROJECT_ID>'
//It is very important to make a call to 'mobile: axeStartSession' inside beforeAll annotated method to setup your session for posting to axe Developer Hub.
beforeAll(async () => {
// Matching the working sample - minimal capabilities
const wdOpts = {
hostname: '127.0.0.1',
port: 4723,
logLevel: 'info',
capabilities: {
platformName: 'iOS',
'appium:automationName': 'AxeXCUITest',
'appium:udid': '<YOUR_DEVICE_OR_SIMULATOR_UDID>',
'appium:bundleId': 'com.apple.Maps',
'appium:wdaLaunchTimeout': 960000, // 16 minutes like the working sample
},
}
driver = await remote(wdOpts)
//Make one time call to setup your session for posting to Dev Hub.
//This also accepts axeServiceUrl in case of private instance.
const axeAuthSettings = {
apiKey: apiKey,
projectId: projectId,
axeServiceUrl: '<YOUR_PRIVATE_INSTANCE_URL>', // Optional
}
await driver.execute('mobile: axeStartSession', axeAuthSettings)
}, 1000000)
afterAll(async () => {
if (driver) {
await driver.pause(1000)
await driver.deleteSession()
}
})
const launchApp = async () => {
await driver.activateApp('com.apple.Maps')
}
beforeEach(async () => {
await launchApp()
})
//Now since your session is authenticated you can keep making 'mobile: axeScan' call like below in test1 and test2. The scans will be uploaded to the dashboard and axe Developer Hub.
it('test1 - scan main screen', async () => {
const appiumScanResult = await driver.execute(
'mobile: axeScan',
axeSettings
)
const results = appiumScanResult.axeRuleResults
}, 10000)
it('test2 - click search and scan', async () => {
const appiumScanResult = await driver.execute(
'mobile: axeScan',
axeSettings
)
const results = appiumScanResult.axeRuleResults
}, 10000)
})