التبديل بين الإطارات

يقوم بتبديل السياق النشط إلى إطار، مثل iframe في الصفحة. هناك عدة طرق يمكنك من خلالها الاستعلام عن إطار في الصفحة:

• إذا تم إعطاء سلسلة نصية، فإنه يقوم بالتبديل إلى الإطار الذي له معرف سياق مطابق، أو عنوان URL أو عنوان URL يحتوي على تلك السلسلة

  // التبديل إلى إطار له عنوان URL محدد أو يحتوي على سلسلة في العنوان
  await browser.url('https://www.w3schools.com/tags/tryit.asp?filename=tryhtml_iframe')
  // ملاحظة: يوجد هذا الإطار في iframe متداخل، ومع ذلك تحتاج فقط إلى توفير
  // عنوان URL للإطار المطلوب
  await browser.switchFrame('https://www.w3schools.com')
  // التحقق من عنوان الصفحة
  console.log(await browser.execute(() => [document.title, document.URL]))
  // المخرجات: [ 'W3Schools Online Web Tutorials', 'https://www.w3schools.com/' ]

• إذا كان لديك معرف السياق للإطار، يمكنك استخدامه مباشرة

  // التبديل إلى إطار له معرف سياق معين
  await browser.switchFrame('A5734774C41F8C91D483BDD4022B2EF3')

• إذا تم إعطاء عنصر WebdriverIO يشير إلى عنصر iframe، فسيتم التبديل إلى ذلك الإطار

  // التبديل إلى عنصر إطار تم الاستعلام عنه من السياق الحالي
  await browser.switchFrame($('iframe'))

• إذا تم إعطاء دالة، فسيتم التكرار عبر جميع إطارات iframe في الصفحة واستدعاء الدالة داخل كائن السياق. يجب أن تعيد الدالة قيمة منطقية تشير إلى ما إذا كان يجب تحديد الإطار. سيتم تنفيذ الدالة داخل المتصفح وتسمح بالوصول إلى جميع واجهات برمجة تطبيقات الويب، على سبيل المثال:

  // التبديل إلى أول إطار يحتوي على عنصر بمعرف "#frameContent"
  await browser.switchFrame(() => Boolean(document.querySelector('#frameContent')))
  // التبديل إلى أول إطار يحتوي على "webdriver" في العنوان
  await browser.switchFrame(() => document.URL.includes('webdriver'))

• إذا تم إعطاء null، فسيتم التبديل إلى الإطار الرئيسي

  // أولاً قم بالتبديل إلى إطار
  await browser.switchFrame($('iframe'))
  // قم بمزيد من عمليات الأتمتة داخل ذلك الإطار، ثم...
  
  // التبديل إلى الإطار الرئيسي
  await browser.switchFrame(null)

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

الاستخدام

browser.switchFrame(context)

المعاملات

الاسم	النوع	التفاصيل
context	string, object, function

القيمة المرجعة

• <Promise<string>> returns: معرف السياق النشط الحالي