من الإصدار v5 إلى v6

هذا البرنامج التعليمي مخصص للأشخاص الذين ما زالوا يستخدمون v5 من WebdriverIO ويرغبون في الترقية إلى v6 أو إلى أحدث إصدار من WebdriverIO. كما ذكرنا في منشور مدونة الإصدار يمكن تلخيص التغييرات لترقية هذا الإصدار على النحو التالي:

• قمنا بتوحيد المعلمات لبعض الأوامر (مثل newWindow, react$, react$$, waitUntil, dragAndDrop, moveTo, waitForDisplayed, waitForEnabled, waitForExist) ونقلنا جميع المعلمات الاختيارية إلى كائن واحد، على سبيل المثال:

  // v5
  browser.newWindow(
      'https://webdriver.io',
      'WebdriverIO window',
      'width=420,height=230,resizable,scrollbars=yes,status=1'
  )
  // v6
  browser.newWindow('https://webdriver.io', {
      windowName: 'WebdriverIO window',
      windowFeature: 'width=420,height=230,resizable,scrollbars=yes,status=1'
  })

• انتقلت إعدادات الخدمات إلى قائمة الخدمات، على سبيل المثال:

  // v5
  exports.config = {
      services: ['sauce'],
      sauceConnect: true,
      sauceConnectOpts: { foo: 'bar' },
  }
  // v6
  exports.config = {
      services: [['sauce', {
          sauceConnect: true,
          sauceConnectOpts: { foo: 'bar' }
      }]],
  }

• تمت إعادة تسمية بعض خيارات الخدمة لأغراض التبسيط

• قمنا بإعادة تسمية الأمر launchApp إلى launchChromeApp لجلسات Chrome WebDriver

معلومات

إذا كنت تستخدم WebdriverIO v4 أو أقل، يرجى الترقية إلى v5 أولاً.

في حين أننا نود أن يكون لدينا عملية آلية بالكامل لهذا، إلا أن الواقع يبدو مختلفًا. كل شخص لديه إعداد مختلف. يجب اعتبار كل خطوة كدليل وليس كتعليمات خطوة بخطوة. إذا كانت لديك مشكلات في عملية الترقية، فلا تتردد في الاتصال بنا.

الإعداد

بشكل مشابه للترقيات الأخرى، يمكننا استخدام codemod الخاص بـ WebdriverIO. لتثبيت codemod، قم بتشغيل:

npm install jscodeshift @wdio/codemod

ترقية تبعيات WebdriverIO

نظرًا لأن جميع إصدارات WebdriverIO مرتبطة ببعضها البعض، فمن الأفضل دائمًا الترقية إلى علامة محددة، مثل 6.12.0. إذا قررت الترقية من v5 مباشرة إلى v7 فيمكنك ترك العلامة وتثبيت أحدث إصدارات لجميع الحزم. للقيام بذلك، نقوم بنسخ جميع التبعيات المتعلقة بـ WebdriverIO من ملف package.json الخاص بنا وإعادة تثبيتها عبر:

npm i --save-dev @wdio/allure-reporter@6 @wdio/cli@6 @wdio/cucumber-framework@6 @wdio/local-runner@6 @wdio/spec-reporter@6 @wdio/sync@6 wdio-chromedriver-service@6 webdriverio@6

عادةً ما تكون تبعيات WebdriverIO جزءًا من تبعيات التطوير، وهذا قد يختلف حسب مشروعك. بعد هذا، يجب تحديث ملفات package.json و package-lock.json الخاصة بك. ملاحظة: هذه تبعيات نموذجية، قد تختلف التبعيات الخاصة بك. تأكد من العثور على أحدث إصدار v6 عن طريق الاستدعاء، على سبيل المثال:

npm show webdriverio versions

حاول تثبيت أحدث إصدار 6 متاح لجميع حزم WebdriverIO الأساسية. بالنسبة للحزم المجتمعية، يمكن أن يختلف هذا من حزمة إلى أخرى. هنا نوصي بالتحقق من سجل التغييرات للحصول على معلومات حول الإصدار الذي لا يزال متوافقًا مع v6.

تحويل ملف التكوين

خطوة أولى جيدة هي البدء بملف التكوين. يمكن حل جميع التغييرات الكاسرة باستخدام codemod بشكل تلقائي بالكامل:

npx jscodeshift -t ./node_modules/@wdio/codemod/v6 ./wdio.conf.js

تنبيه

لا يدعم codemod بعد مشاريع TypeScript. انظر @webdriverio/codemod#10. نحن نعمل على تنفيذ الدعم لها قريبًا. إذا كنت تستخدم TypeScript، يرجى المشاركة!

تحديث ملفات المواصفات وكائنات الصفحة

لتحديث جميع تغييرات الأوامر، قم بتشغيل codemod على جميع ملفات e2e التي تحتوي على أوامر WebdriverIO، على سبيل المثال:

npx jscodeshift -t ./node_modules/@wdio/codemod/v6 ./e2e/*

هذا كل شيء! لا مزيد من التغييرات الضرورية 🎉

الختام

نأمل أن يرشدك هذا البرنامج التعليمي قليلاً خلال عملية الترقية إلى WebdriverIO v6. نوصي بشدة بمواصلة الترقية إلى أحدث إصدار نظرًا لأن التحديث إلى v7 أمر بسيط بسبب عدم وجود تغييرات كاسرة تقريبًا. يرجى الاطلاع على دليل الترقية للترقية إلى v7.

يواصل المجتمع تحسين codemod أثناء اختباره مع فرق مختلفة في مؤسسات متنوعة. لا تتردد في طرح مشكلة إذا كان لديك تعليقات أو بدء مناقشة إذا كنت تواجه صعوبة أثناء عملية الترقية.