وضع الاختبارات كمعلمات

يمكنك ببساطة وضع الاختبارات كمعلمات على مستوى الاختبار، عبر حلقات for البسيطة مثل:

const people = ['Alice', 'Bob']
describe('my tests', () => {
    for (const name of people) {
        it(`testing with ${name}`, async () => {
            // ...
        })
    }
})

أو عن طريق استخراج الاختبارات إلى دوال ديناميكية، مثل:

import { browser } from '@wdio/globals'

function testComponent(componentName, options) {
  it(`should test my ${componentName}`, async () => {
    await browser.url(`/${componentName}`)
    await expect($('input')).toHaveValue(options.expectedValue)
  })
}

describe('page components', () => {
    testComponent('component-a', { expectedValue: 'some expected value' })
    testComponent('component-b', { expectedValue: 'some other expected value' })
})

تمرير متغيرات البيئة

يمكنك استخدام متغيرات البيئة لتكوين الاختبارات من سطر الأوامر.

على سبيل المثال، انظر إلى ملف الاختبار التالي الذي يحتاج إلى اسم مستخدم وكلمة مرور. عادة ما تكون فكرة جيدة عدم تخزين أسرارك في كود المصدر، لذلك سنحتاج إلى طريقة لتمرير الأسرار من الخارج.

it(`example test`, async () => {
  // ...
  await $('#username').setValue(process.env.USERNAME)
  await $('#password').setValue(process.env.PASSWORD)
})

يمكنك تشغيل هذا الاختبار باستخدام اسم المستخدم السري وكلمة المرور المحددة في سطر الأوامر.

Bash

USERNAME=me PASSWORD=secret npx wdio run wdio.conf.js

Powershell

$env:USERNAME=me
$env:PASSWORD=secret
npx wdio run wdio.conf.js

Batch

set USERNAME=me
set PASSWORD=secret
npx wdio run wdio.conf.js

وبالمثل، يمكن لملف التكوين أيضًا قراءة متغيرات البيئة التي يتم تمريرها عبر سطر الأوامر.

export const config = {
  // ...
  baseURL: process.env.STAGING === '1'
    ? 'http://staging.example.test/'
    : 'http://example.test/',
  // ...
}

الآن، يمكنك تشغيل الاختبارات ضد بيئة الإنتاج أو التجريب:

Bash

STAGING=1 npx wdio run wdio.conf.js

Powershell

$env:STAGING=1
npx wdio run wdio.conf.js

Batch

set STAGING=1
npx wdio run wdio.conf.js

ملفات .env

لتسهيل إدارة متغيرات البيئة، فكر في استخدام ملفات .env. يقوم WebdriverIO بتحميل ملفات .env تلقائيًا في بيئتك. بدلاً من تحديد متغير البيئة كجزء من استدعاء الأمر، يمكنك تحديد ملف .env التالي:

.env

# .env file
STAGING=0
USERNAME=me
PASSWORD=secret

قم بتشغيل الاختبارات كالمعتاد، وسيتم التقاط متغيرات البيئة الخاصة بك.

npx wdio run wdio.conf.js

إنشاء اختبارات عبر ملف CSV

يعمل مشغل اختبار WebdriverIO في Node.js، وهذا يعني أنه يمكنك قراءة الملفات مباشرة من نظام الملفات وتحليلها باستخدام مكتبة CSV التي تفضلها.

انظر على سبيل المثال إلى ملف CSV هذا، في مثالنا input.csv:

"test_case","some_value","some_other_value"
"value 1","value 11","foobar1"
"value 2","value 22","foobar21"
"value 3","value 33","foobar321"
"value 4","value 44","foobar4321"

بناءً على هذا، سنقوم بإنشاء بعض الاختبارات باستخدام مكتبة csv-parse من NPM:

import fs from 'node:fs'
import path from 'node:path'
import { parse } from 'csv-parse/sync'

const records = parse(fs.readFileSync(path.join(__dirname, 'input.csv')), {
  columns: true,
  skip_empty_lines: true
})

describe('my test suite', () => {
    for (const record of records) {
        it(`foo: ${record.test_case}`, async () => {
            console.log(record.test_case, record.some_value, record.some_other_value)
        })
    }
})