بروتوكول WebDriver

newSession

يقوم أمر New Session بإنشاء جلسة WebDriver جديدة مع نقطة النهاية. إذا فشل الإنشاء، يتم إرجاع خطأ بأنه لم يتم إنشاء الجلسة.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.newSession(capabilities)

المعلمات

الاسم	النوع	التفاصيل
capabilities	object	كائن JSON، مجموعة القدرات التي تم دمجها ومطابقتها في النهاية في خوارزمية معالجة القدرات

الإرجاع

• <Object> session: كائن يحتوي على معرف الجلسة وقدرات جلسة WebDriver التي تم إنشاؤها.

---

deleteSession

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

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.deleteSession(deleteSessionOpts)

المعلمات

الاسم	النوع	التفاصيل
deleteSessionOpts اختياري	object	كائن يحتوي على خيارات لأمر deleteSession، مثل { shutdownDriver: boolean }

---

status

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

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.status()

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <Object> status: كائن يحتوي على حالة برنامج التشغيل.

---

getTimeouts

يحصل أمر Get Timeouts على مدد المهلة المرتبطة بالجلسة الحالية.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.getTimeouts()

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <Object> timeouts: كائن يحتوي على مدد مهلة لمؤقتات script، وpageLoad، وimplicit.

---

setTimeouts

يقوم أمر Set Timeouts بتعيين مدد المهلة المرتبطة بالجلسة الحالية. المؤقتات التي يمكن التحكم بها مدرجة في جدول مهل الجلسة أدناه.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.setTimeouts(implicit, pageLoad, script)

المعلمات

الاسم	النوع	التفاصيل
implicit اختياري	number	عدد صحيح بالميلي ثانية لمهلة الانتظار الضمني للجلسة
pageLoad اختياري	number	عدد صحيح بالميلي ثانية لمهلة تحميل الصفحة للجلسة
script اختياري	number	عدد صحيح بالميلي ثانية لمهلة النص البرمجي للجلسة

مثال

examples.js

loading...

View on GitHub

---

getUrl

يقوم أمر Get Current URL بإرجاع عنوان URL لسياق التصفح الحالي عالي المستوى.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.getUrl()

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <string> url: عنوان URL لمستند المستند النشط لسياق التصفح الحالي عالي المستوى

---

navigateTo

يُستخدم أمر navigateTo (go) لجعل وكيل المستخدم ينتقل بسياق التصفح الحالي عالي المستوى إلى موقع جديد.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: url. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.navigateTo(url)

المعلمات

الاسم	النوع	التفاصيل
url	string	سلسلة تمثل عنوان URL مطلق (يبدأ بـ http(s))، قد يتضمن جزءًا (#...)، ويمكن أن يكون أيضًا مخططًا محليًا (about: إلخ)

مثال

examples.js

loading...

View on GitHub

---

back

يتسبب أمر Back في أن يمر المتصفح خطوة واحدة إلى الوراء في سجل الجلسة المشترك لسياق التصفح الحالي عالي المستوى. وهذا يعادل الضغط على زر الرجوع في واجهة المتصفح أو استدعاء window.history.back.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.back()

مثال

examples.js

loading...

View on GitHub

---

forward

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

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.forward()

مثال

examples.js

loading...

View on GitHub

---

refresh

يتسبب أمر Refresh في أن يقوم المتصفح بإعادة تحميل الصفحة في سياق التصفح الحالي عالي المستوى.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.refresh()

مثال

examples.js

loading...

View on GitHub

---

getTitle

يقوم أمر Get Title بإرجاع عنوان المستند لسياق التصفح الحالي عالي المستوى، وهو ما يعادل استدعاء document.title.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.getTitle()

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <string> title: يرجع سلسلة نصية مماثلة لـ document.title لسياق التصفح الحالي عالي المستوى.

---

getWindowHandle

يقوم أمر Get Window Handle بإرجاع معرف النافذة لسياق التصفح الحالي عالي المستوى. يمكن استخدامه كوسيطة لـ Switch To Window.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.getWindowHandle()

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <string> handle: يرجع سلسلة نصية وهي معرف النافذة لسياق التصفح الحالي عالي المستوى.

---

closeWindow

يقوم أمر Close Window بإغلاق سياق التصفح الحالي عالي المستوى. بمجرد الانتهاء، إذا لم تعد هناك سياقات تصفح أخرى عالية المستوى مفتوحة، فإن جلسة WebDriver نفسها تغلق.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.closeWindow()

مثال

examples.js

loading...

View on GitHub

---

switchToWindow

يُستخدم أمر Switch To Window لتحديد سياق التصفح الحالي عالي المستوى للجلسة الحالية، أي الذي سيتم استخدامه لمعالجة الأوامر.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: switchWindow. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.switchToWindow(handle)

المعلمات

الاسم	النوع	التفاصيل
handle	string	سلسلة تمثل معرف نافذة، يجب أن تكون واحدة من السلاسل التي تم إرجاعها في استدعاء getWindowHandles

مثال

examples.js

loading...

View on GitHub

---

createWindow

إنشاء سياق تصفح جديد عالي المستوى.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.createWindow(type)

المعلمات

الاسم	النوع	التفاصيل
type	string	تعيين إلى 'tab' إذا كانت النافذة المنشأة حديثًا تشارك نافذة على مستوى نظام التشغيل مع سياق التصفح الحالي، أو 'window' خلاف ذلك.

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <Object> window: كائن النافذة الجديد الذي يحتوي على 'handle' بقيمة المعرف و'type' بقيمة نوع النافذة المنشأة

---

getWindowHandles

يرجع أمر Get Window Handles قائمة بمعرفات النوافذ لكل سياق تصفح عالي المستوى مفتوح. الترتيب الذي يتم فيه إرجاع معرفات النوافذ عشوائي.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.getWindowHandles()

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <String[]> handles: مصفوفة تحتوي على قائمة معرفات النوافذ.

---

printPage

يقوم أمر Print Page بتحويل المستند إلى مستند PDF مرقم. ملاحظة: يدعم Chrome حاليًا هذه الميزة فقط في وضع headless، انظر crbug753118).

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.printPage(orientation, scale, background, width, height, top, bottom, left, right, shrinkToFit, pageRanges)

المعلمات

الاسم	النوع	التفاصيل
orientation اختياري	string	اتجاه الصفحة. الافتراضي: portrait
scale اختياري	number	مقياس الصفحة. الافتراضي: 1
background اختياري	boolean	خلفية الصفحة. الافتراضي: false
width اختياري	number	عرض الصفحة بالسنتيمتر. الافتراضي: 21.59 من الصفحة
height اختياري	number	ارتفاع الصفحة بالسنتيمتر. الافتراضي: 27.94 من الصفحة
top اختياري	number	هامش الصفحة بالسنتيمتر من الهامش العلوي. الافتراضي: 1
bottom اختياري	number	هامش الصفحة بالسنتيمتر من الهامش السفلي. الافتراضي: 1
left اختياري	number	هامش الصفحة بالسنتيمتر من الهامش الأيسر. الافتراضي: 1
right اختياري	number	هامش الصفحة بالسنتيمتر من الهامش الأيمن. الافتراضي: 1
shrinkToFit اختياري	boolean	تصغير ملف PDF ليناسب الصفحة. الافتراضي: true
pageRanges اختياري	object[]	نطاقات الصفحة. الافتراضي []

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <string> pdf: تمثيل PDF المرمز بـ base64 للمستند المرقم.

---

switchToFrame

يُستخدم أمر Switch To Frame لتحديد سياق التصفح الحالي عالي المستوى أو سياق تصفح فرعي لسياق التصفح الحالي لاستخدامه كسياق تصفح حالي للأوامر اللاحقة.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

تنبيه

هذا الأمر البروتوكولي مهمل
هذا الأمر مهمل ونشجع الجميع على استخدام switchFrame بدلاً من ذلك للتبديل بين الإطارات. اقرأ المزيد عن هذا الأمر على https://webdriver.io/docs/api/browser/switchFrame.

الاستخدام

browser.switchToFrame(id)

المعلمات

الاسم	النوع	التفاصيل
id	number, object, null	واحد من ثلاثة أنواع محتملة: null: هذا يمثل سياق التصفح عالي المستوى (أي، ليس iframe)، رقم، يمثل فهرس كائن النافذة المقابل للإطار، كائن عنصر تم استلامه باستخدام findElement.

مثال

examples.js

loading...

View on GitHub

---

switchToParentFrame

يقوم أمر Switch to Parent Frame بتعيين سياق التصفح الحالي للأوامر المستقبلية إلى الأصل لسياق التصفح الحالي.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.switchToParentFrame()

مثال

examples.js

loading...

View on GitHub

---

getWindowRect

يرجع أمر Get Window Rect حجم وموضع نافذة نظام التشغيل المقابلة لسياق التصفح الحالي عالي المستوى على الشاشة.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: getWindowSize. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.getWindowRect()

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <Object> windowRect: تمثيل JSON لكائن "مستطيل النافذة". يحتوي هذا على 4 خصائص: x، y، width، وheight.

---

setWindowRect

يقوم أمر Set Window Rect بتغيير حجم وموضع نافذة نظام التشغيل المقابلة لسياق التصفح الحالي عالي المستوى.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: setWindowSize. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.setWindowRect(x, y, width, height)

المعلمات

الاسم	النوع	التفاصيل
x	number, null	خاصية screenX لكائن النافذة
y	number, null	خاصية screenY لكائن النافذة
width	number, null	عرض الأبعاد الخارجية لسياق التصفح عالي المستوى، بما في ذلك شريط المتصفح وما إلى ذلك...
height	number, null	ارتفاع الأبعاد الخارجية لسياق التصفح عالي المستوى، بما في ذلك شريط المتصفح وما إلى ذلك...

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <Object> windowRect: تمثيل JSON لكائن "مستطيل النافذة" استنادًا إلى حالة النافذة الجديدة.

---

maximizeWindow

يستدعي أمر Maximize Window عملية "تكبير" محددة لمدير النوافذ، إن وجدت، على النافذة التي تحتوي على سياق التصفح الحالي عالي المستوى. هذا عادة ما يزيد النافذة إلى الحجم الأقصى المتاح دون الدخول في وضع ملء الشاشة.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.maximizeWindow()

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <Object> windowRect: تمثيل JSON لكائن "مستطيل النافذة" استنادًا إلى حالة النافذة الجديدة.

---

minimizeWindow

يستدعي أمر Minimize Window عملية "تصغير" محددة لمدير النوافذ، إن وجدت، على النافذة التي تحتوي على سياق التصفح الحالي عالي المستوى. هذا عادة ما يخفي النافذة في شريط النظام.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.minimizeWindow()

الإرجاع

• <Object> windowRect: تمثيل JSON لكائن "مستطيل النافذة" لسياق التصفح (الجديد) الحالي عالي المستوى.

---

fullscreenWindow

يستدعي أمر Fullscreen Window عملية "ملء الشاشة" المحددة لمدير النوافذ، إن وجدت، على النافذة التي تحتوي على سياق التصفح الحالي عالي المستوى. هذا عادة ما يزيد النافذة إلى حجم العرض الفعلي ويمكن أن يخفي عناصر واجهة المتصفح مثل شريط الأدوات.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.fullscreenWindow()

الإرجاع

• <Object> windowRect: تمثيل JSON لكائن "مستطيل النافذة" لسياق التصفح (الجديد) الحالي عالي المستوى.

---

findElement

يستخدم أمر Find Element للعثور على عنصر في سياق التصفح الحالي يمكن استخدامه للأوامر المستقبلية. يعيد هذا الأمر تمثيل JSON للعنصر الذي يمكن تمريره إلى أمر $ لتحويل المرجع إلى عنصر WebdriverIO موسع.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: $. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.findElement(using, value)

المعلمات

الاسم	النوع	التفاصيل
using	string	إستراتيجية تحديد موقع عنصر صالحة
value	string	المحدد الفعلي الذي سيتم استخدامه للعثور على عنصر

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <object> element: تمثيل JSON لكائن عنصر، مثل { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

findElementFromShadowRoot

يُستخدم أمر Find Element From Shadow Root للعثور على عنصر داخل جذر الظل لعنصر يمكن استخدامه للأوامر المستقبلية. يعيد هذا الأمر تمثيل JSON للعنصر الذي يمكن تمريره إلى أمر $ لتحويل المرجع إلى عنصر WebdriverIO موسع.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: shadow$. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.findElementFromShadowRoot(shadowId, using, value)

المعلمات

الاسم	النوع	التفاصيل
shadowId	String	معرف عنصر لعنصر جذر الظل
using	string	إستراتيجية تحديد موقع عنصر صالحة
value	string	المحدد الفعلي الذي سيتم استخدامه للعثور على عنصر

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <object> element: تمثيل JSON لكائن ظل عنصر، مثل { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

findElements

يستخدم أمر Find Elements للعثور على عناصر في سياق التصفح الحالي يمكن استخدامها للأوامر المستقبلية. يعيد هذا الأمر مصفوفة من تمثيل JSON للعناصر التي يمكن تمريرها إلى أمر $ لتحويل المرجع إلى عنصر WebdriverIO موسع (انظر findElement).

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: $$. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.findElements(using, value)

المعلمات

الاسم	النوع	التفاصيل
using	string	إستراتيجية تحديد موقع عنصر صالحة
value	string	المحدد الفعلي الذي سيتم استخدامه للعثور على عنصر

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <object[]> elements: قائمة JSON (قد تكون فارغة) من تمثيلات كائن العنصر، مثل [{ 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }].

---

findElementsFromShadowRoot

يُستخدم أمر Find Elements للعثور على عناصر داخل جذر الظل لعنصر يمكن استخدامه للأوامر المستقبلية. يعيد هذا الأمر مصفوفة من تمثيل JSON للعناصر التي يمكن تمريرها إلى أمر $ لتحويل المرجع إلى عنصر WebdriverIO موسع (انظر findElement).

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: shadow$$. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.findElementsFromShadowRoot(shadowId, using, value)

المعلمات

الاسم	النوع	التفاصيل
shadowId	String	معرف عنصر لعنصر جذر الظل
using	string	إستراتيجية تحديد موقع عنصر صالحة
value	string	المحدد الفعلي الذي سيتم استخدامه للعثور على عنصر

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <object[]> elements: قائمة JSON (قد تكون فارغة) من تمثيلات كائن العنصر، مثل { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

findElementFromElement

يُستخدم أمر Find Element From Element للعثور على عنصر من عنصر ويب في سياق التصفح الحالي يمكن استخدامه للأوامر المستقبلية. يعيد هذا الأمر تمثيل JSON للعنصر الذي يمكن تمريره إلى أمر $ لتحويل المرجع إلى عنصر WebdriverIO موسع (انظر findElement).

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: $. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.findElementFromElement(elementId, using, value)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)
using	string	إستراتيجية تحديد موقع عنصر صالحة
value	string	المحدد الفعلي الذي سيتم استخدامه للعثور على عنصر

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <object> element: تمثيل JSON لكائن عنصر، مثل { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

findElementsFromElement

يُستخدم أمر Find Elements From Element للعثور على عناصر من عنصر ويب في سياق التصفح الحالي يمكن استخدامها للأوامر المستقبلية. يعيد هذا الأمر مصفوفة من تمثيل JSON للعناصر التي يمكن تمريرها إلى أمر $ لتحويل المرجع إلى عنصر WebdriverIO موسع (انظر findElement).

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: $$. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.findElementsFromElement(elementId, using, value)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)
using	string	إستراتيجية تحديد موقع عنصر صالحة
value	string	المحدد الفعلي الذي سيتم استخدامه للعثور على عنصر

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <object[]> elements: قائمة JSON (قد تكون فارغة) من تمثيلات كائن العنصر، مثل [{ 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }].

---

getElementShadowRoot

احصل على كائن جذر الظل لعنصر. يمكن استخدام كائن النتيجة لجلب العناصر داخل جذر الظل هذا باستخدام findElementFromShadowRoots أو findElementsFromShadowRoots على سبيل المثال.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: shadow$. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.getElementShadowRoot(elementId)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <string> shadowRoot: تمثيل JSON لجذر ظل عنصر، مثل { 'shadow-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

getActiveElement

يعيد Get Active Element العنصر النشط لعنصر المستند الخاص بسياق التصفح الحالي. يعيد هذا الأمر تمثيل JSON للعنصر الذي يمكن تمريره إلى أمر $ لتحويل المرجع إلى عنصر WebdriverIO موسع (انظر findElement).

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.getActiveElement()

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <string> element: تمثيل JSON لكائن عنصر، مثل { 'element-6066-11e4-a52e-4f735466cecf': 'ELEMENT_1' }.

---

isElementSelected

يحدد Is Element Selected ما إذا كان العنصر المشار إليه محددًا أم لا. هذه العملية لها معنى فقط على عناصر الإدخال من حالة مربع الاختيار وزر الراديو، أو عناصر الخيار.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: isSelected. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.isElementSelected(elementId)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <Boolean> isSelected: true أو false بناءً على حالة التحديد.

---

isElementDisplayed

يحدد Is Element Displayed رؤية عنصر ما والتي يتم توجيهها بما هو مرئي إدراكيًا للعين البشرية. في هذا السياق، لا ترتبط رؤية العنصر بخصائص النمط visibility أو display.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: isDisplayed. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.isElementDisplayed(elementId)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <Boolean> isDisplayed: true أو false بناءً على حالة الرؤية.

---

getElementAttribute

سيعيد أمر Get Element Attribute سمة عنصر ويب.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: getAttribute. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.getElementAttribute(elementId, name)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)
name	String	اسم قيمة السمة المراد استردادها

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <string> attribute: السمة المسماة للعنصر.

---

getElementProperty

سيقوم أمر Get Element Property بإرجاع نتيجة الحصول على خاصية عنصر.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: getProperty. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.getElementProperty(elementId, name)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)
name	String	اسم خاصية السمة المراد استردادها

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <string> property: الخاصية المسماة للعنصر، التي تم الوصول إليها عن طريق استدعاء GetOwnProperty على كائن العنصر.

---

getElementCSSValue

يسترجع أمر Get Element CSS Value القيمة المحسوبة لخاصية CSS المعطاة للعنصر الويب المعطى.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: getCSSProperty. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.getElementCSSValue(elementId, propertyName)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)
propertyName	String	اسم خاصية CSS المراد استردادها

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <string> cssValue: القيمة المحسوبة للمعلمة المقابلة لاسم الخاصية من إعلانات نمط العنصر (ما لم يكن نوع المستند هو xml، وفي هذه الحالة تكون قيمة الإرجاع ببساطة سلسلة فارغة).

---

getElementText

يهدف أمر Get Element Text إلى إرجاع نص العنصر "كما يتم عرضه". يستخدم أيضًا نص العنصر المعروض لتحديد موقع العناصر بواسطة نص الرابط الخاص بهم ونص الرابط الجزئي.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.getElementText(elementId)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <string> text: النص المرئي للعنصر (بما في ذلك العناصر الفرعية)، باتباع الخوارزمية المحددة في Selenium Atoms لـ bot.dom.getVisibleText.

---

getElementTagName

يعيد أمر Get Element Tag Name اسم العنصر المؤهل لعنصر الويب المعطى.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: getTagName. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.getElementTagName(elementId)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <string> text: سمة tagName للعنصر.

---

getElementRect

يعيد أمر Get Element Rect أبعاد وإحداثيات عنصر الويب المعطى.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطرق المريحة التالية: getSize، getLocation. يوصى باستخدام هذه الأوامر بدلاً من ذلك.

الاستخدام

browser.getElementRect(elementId)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <Object> elementRect: كائن JSON يمثل موضع ومستطيل الحدود للعنصر.

---

isElementEnabled

يحدد Is Element Enabled ما إذا كان العنصر المشار إليه ممكّنًا أم لا. هذه العملية لها معنى فقط في عناصر التحكم في النموذج.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: isEnabled. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.isElementEnabled(elementId)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <Boolean> isEnabled: إذا كان العنصر في مستند xml، أو كان عنصر تحكم نموذج معطلًا: false، وإلا true.

---

elementClick

يقوم أمر Element Click بالتمرير إلى العرض للعنصر إذا لم يكن قابلاً للتفاعل بالمؤشر بالفعل، وينقر على نقطة المركز المرئية الخاصة به. إذا كانت نقطة مركز العنصر محجوبة بواسطة عنصر آخر، يتم إرجاع خطأ اعتراض نقرة العنصر. إذا كان العنصر خارج إطار العرض، يتم إرجاع خطأ عنصر غير قابل للتفاعل.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: click. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.elementClick(elementId)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)

مثال

examples.js

loading...

View on GitHub

---

elementClear

يقوم أمر Element Clear بالتمرير إلى العرض لعنصر قابل للتحرير أو إعادة الضبط ثم يحاول مسح الملفات المحددة أو محتوى النص الخاص به.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: clearValue. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.elementClear(elementId)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)

مثال

examples.js

loading...

View on GitHub

---

elementSendKeys

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

يمكن مسح حالة إدخال المفتاح المستخدمة للإدخال في منتصف "الكتابة" عن طريق إرسال المفتاح الفارغ، وهو U+E000 (NULL).

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطرق المريحة التالية: addValue، setValue. يوصى باستخدام هذه الأوامر بدلاً من ذلك.

الاستخدام

browser.elementSendKeys(elementId, text)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)
text	string	سلسلة لإرسالها كضربات مفاتيح إلى العنصر

مثال

examples.js

loading...

View on GitHub

---

getPageSource

يعيد أمر Get Page Source تسلسل سلسلة لـ DOM لمستند سياق التصفح الحالي النشط.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.getPageSource()

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <string> pageSource: DOM لمستند سياق التصفح الحالي النشط

---

executeScript

ينفذ أمر Execute Script دالة JavaScript في سياق سياق التصفح الحالي ويعيد قيمة الإرجاع للدالة.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: execute. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.executeScript(script, args)

المعلمات

الاسم	النوع	التفاصيل
script	string	سلسلة، جسم دالة JavaScript التي تريد تنفيذها
args	string, object, number, boolean, null, undefined[]	مصفوفة من قيم JSON التي سيتم فك تسلسلها وتمريرها كوسائط لدالتك

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <*> result: إما قيمة الإرجاع لنصك البرمجي، أو وفاء الوعد الذي أعاده نصك البرمجي، أو الخطأ الذي كان سبب رفض الوعد المرتجع من نصك البرمجي.

---

executeAsyncScript

يتسبب أمر Execute Async Script في تنفيذ JavaScript كدالة مجهولة. على عكس أمر Execute Script، يتم تجاهل نتيجة الدالة. بدلاً من ذلك، يتم توفير وسيطة إضافية كوسيطة نهائية للدالة. هذه دالة، عند استدعائها، تعيد الوسيطة الأولى كاستجابة.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

معلومات

هذا الأمر البروتوكولي مدمج في الطريقة المريحة التالية: executeAsync. يوصى باستخدام هذا الأمر بدلاً من ذلك.

الاستخدام

browser.executeAsyncScript(script, args)

المعلمات

الاسم	النوع	التفاصيل
script	string	سلسلة، جسم دالة JavaScript التي تريد تنفيذها
args	string, object, number, boolean, null, undefined[]	مصفوفة من قيم JSON التي سيتم فك تسلسلها وتمريرها كوسائط لدالتك

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <*> result: إما قيمة الإرجاع لنصك البرمجي، أو وفاء الوعد الذي أعاده نصك البرمجي، أو الخطأ الذي كان سبب رفض الوعد المرتجع من نصك البرمجي.

---

getAllCookies

يُرجع أمر Get All Cookies جميع ملفات تعريف الارتباط المرتبطة بعنوان المستند النشط لسياق التصفح الحالي.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.getAllCookies()

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <Object[]> cookies: قائمة من ملفات تعريف الارتباط المسلسلة. كل ملف تعريف ارتباط مسلسل له عدد من الحقول الاختيارية التي قد يتم إرجاعها أو لا يتم إرجاعها بالإضافة إلى name وvalue.

---

addCookie

يضيف أمر Add Cookie ملف تعريف ارتباط واحد إلى مخزن ملفات تعريف الارتباط المرتبطة بعنوان المستند النشط.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.addCookie(cookie)

المعلمات

الاسم	النوع	التفاصيل
cookie	object	كائن JSON يمثل ملف تعريف ارتباط. يجب أن يكون لديه على الأقل حقول الاسم والقيمة ويمكن أن يكون لديه المزيد، بما في ذلك وقت انتهاء الصلاحية وما إلى ذلك

مثال

examples.js

loading...

View on GitHub

---

deleteAllCookies

يسمح أمر Delete All Cookies بحذف جميع ملفات تعريف الارتباط المرتبطة بعنوان المستند النشط.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.deleteAllCookies()

مثال

examples.js

loading...

View on GitHub

---

getNamedCookie

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

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.getNamedCookie(name)

المعلمات

الاسم	النوع	التفاصيل
name	String	اسم ملف تعريف الارتباط المراد استرداده

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <Object> cookie: ملف تعريف ارتباط مسلسل، مع حقول الاسم والقيمة. هناك عدد من الحقول الاختيارية مثل path وdomain وexpiry-time التي قد تكون موجودة أيضًا.

---

deleteCookie

يسمح لك أمر Delete Cookie بحذف إما ملف تعريف ارتباط واحد بواسطة اسم المعلمة، أو جميع ملفات تعريف الارتباط المرتبطة بعنوان المستند النشط إذا كان الاسم غير محدد.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.deleteCookie(name)

المعلمات

الاسم	النوع	التفاصيل
name	String	اسم ملف تعريف الارتباط المراد حذفه

مثال

examples.js

loading...

View on GitHub

---

performActions

يستخدم أمر Perform Actions لتنفيذ إجراءات المستخدم المعقدة. راجع المواصفات لمزيد من التفاصيل.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.performActions(actions)

المعلمات

الاسم	النوع	التفاصيل
actions	object[]	قائمة من الكائنات، كل منها يمثل مصدر إدخال والإجراءات المرتبطة به

---

releaseActions

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

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.releaseActions()

---

dismissAlert

يقوم أمر Dismiss Alert برفض مربع حوار بسيط إذا كان موجودًا، وإلا فهو خطأ. يكون لطلب رفض مطالبة تنبيه المستخدم، والتي قد لا يكون لها بالضرورة زر رفض، نفس تأثير قبولها.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.dismissAlert()

مثال

examples.js

loading...

View on GitHub

---

acceptAlert

يقبل أمر Accept Alert مربع حوار بسيط إذا كان موجودًا، وإلا فهو خطأ.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.acceptAlert()

---

getAlertText

يعيد أمر Get Alert Text رسالة مطالبة المستخدم الحالية. إذا لم تكن هناك مطالبة مستخدم حالية، فإنه يعيد خطأ.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.getAlertText()

مثال

examples.js

loading...

View on GitHub

الإرجاع

• <string> alertText: رسالة مطالبة المستخدم.

---

sendAlertText

يقوم أمر Send Alert Text بتعيين حقل النص لمطالبة مستخدم window.prompt إلى القيمة المعطاة.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.sendAlertText(text)

المعلمات

الاسم	النوع	التفاصيل
text	string	سلسلة لتعيين المطالبة عليها

---

takeScreenshot

يأخذ أمر Take Screenshot لقطة شاشة لإطار عرض سياق التصفح العلوي.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.takeScreenshot()

الإرجاع

• <string> screenshot: بيانات صورة PNG المرمزة بـ base64 التي تشكل لقطة شاشة لإطار العرض الأولي.

---

takeElementScreenshot

يأخذ أمر Take Element Screenshot لقطة شاشة للمنطقة المرئية التي يشملها المستطيل المحيط بعنصر.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.takeElementScreenshot(elementId, scroll)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)
scroll اختياري	boolean	التمرير لعرض العنصر. الافتراضي: true

الإرجاع

• <string> screenshot: بيانات صورة PNG المرمزة بـ base64 التي تشكل لقطة شاشة للمنطقة المرئية من مستطيل العنصر المحيط بعد أن تم التمرير لعرضه.

---

getElementComputedRole

الحصول على دور WAI-ARIA المحسوب لعنصر.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.getElementComputedRole(elementId)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)

الإرجاع

• <string> role: نتيجة حساب دور WAI-ARIA للعنصر.

---

getElementComputedLabel

الحصول على الاسم الذي يمكن الوصول إليه للعنصر.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.getElementComputedLabel(elementId)

المعلمات

الاسم	النوع	التفاصيل
elementId	String	معرف عنصر تم إرجاعه في استدعاء سابق لـ Find Element(s)

الإرجاع

• <string> label: نتيجة حساب الاسم والوصف الذي يمكن الوصول إليه للاسم الذي يمكن الوصول إليه للعنصر.

---

setPermissions

يحاكي تعديل المستخدم لحالة إذن PermissionDescriptor. ملاحظة: لم تصل هذه الميزة إلى جميع المتصفحات بعد.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.setPermissions(descriptor, state, oneRealm)

المعلمات

الاسم	النوع	التفاصيل
descriptor	object	لكل ميزة قوية جانب واحد أو أكثر يمكن للمواقع طلب الإذن للوصول إليها. لوصف هذه الجوانب، تحدد كل ميزة نوعًا فرعيًا من PermissionDescriptor ليكون نوع واصف الإذن الخاص بها. ملاحظة: لم تصل هذه الميزة إلى جميع المتصفحات بعد.
state	string	يحدد ما إذا كان الإذن ممنوحًا أو مرفوضًا أو مطالبًا به.
oneRealm اختياري	boolean	ما إذا كان سيتم تطبيق الأذونات على جميع سياقات التنفيذ أم لا.

أمثلة

// تعيين أذونات midi
browser.setPermissions(
  { name: 'midi', sysex: true },
  'granted' // يمكن أن تكون أيضًا "denied" أو "prompt"
);

// تعيين أذونات الحافظة
browser.setPermissions({ name: 'clipboard-read' }, 'granted');
// الآن يمكنك قراءة الحافظة عبر، على سبيل المثال
const clipboardText = await browser.execute(() => navigator.clipboard.readText());

---

generateTestReport

ينشئ تقريرًا للاختبار. امتداد لـ Reporting API. ملاحظة: لم تصل هذه الميزة إلى جميع المتصفحات بعد.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.generateTestReport(message, group)

المعلمات

الاسم	النوع	التفاصيل
message	string	الرسالة التي سيتم عرضها في التقرير.
group اختياري	string	يحدد مجموعة نقطة النهاية لتسليم التقرير إليها.

---

createMockSensor

ينشئ مستشعرًا وهميًا لمحاكاة أجهزة استشعار مثل مستشعر الضوء المحيط. ملاحظة: لم تصل هذه الميزة إلى جميع المتصفحات بعد.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.createMockSensor(mockSensorType, maxSamplingFrequency, minSamplingFrequency)

المعلمات

الاسم	النوع	التفاصيل
mockSensorType	string	نوع واجهة برمجة تطبيقات المستشعر للمحاكاة، مثل 'ambient-light'
maxSamplingFrequency اختياري	number	رقم مزدوج يمثل التردد بالهرتز ويستخدم لتعيين الحد الأقصى لتردد أخذ العينات المدعوم للمستشعر الوهمي المرتبط.
minSamplingFrequency اختياري	number	رقم مزدوج يمثل التردد بالهرتز ويستخدم لتعيين الحد الأدنى لتردد أخذ العينات المدعوم للمستشعر الوهمي المرتبط.

---

getMockSensor

يسترجع معلومات حول نوع معين من المستشعر الوهمي. ملاحظة: لم تصل هذه الميزة إلى جميع المتصفحات بعد.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.getMockSensor(type)

المعلمات

الاسم	النوع	التفاصيل
type	String	نوع المستشعر الوهمي لاسترجاع المعلومات منه.

الإرجاع

• <object> sensorReading: قيم قراءة المستشعر الوهمي.

---

updateMockSensor

يحدث نوع المستشعر الوهمي. ملاحظة: لم تصل هذه الميزة إلى جميع المتصفحات بعد.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.updateMockSensor(type, mockSensorType, maxSamplingFrequency, minSamplingFrequency)

المعلمات

الاسم	النوع	التفاصيل
type	String	نوع المستشعر الوهمي لتحديث المعلومات له.
mockSensorType	string	نوع واجهة برمجة تطبيقات المستشعر للمحاكاة، مثل 'ambient-light'
maxSamplingFrequency اختياري	number	رقم مزدوج يمثل التردد بالهرتز ويستخدم لتعيين الحد الأقصى لتردد أخذ العينات المدعوم للمستشعر الوهمي المرتبط.
minSamplingFrequency اختياري	number	رقم مزدوج يمثل التردد بالهرتز ويستخدم لتعيين الحد الأدنى لتردد أخذ العينات المدعوم للمستشعر الوهمي المرتبط.

---

deleteMockSensor

يغلق أمر Delete Session أي سياق تصفح عالي المستوى مرتبط بالجلسة الحالية، وينهي الاتصال، وأخيرًا يغلق الجلسة الحالية. ملاحظة: لم تصل هذه الميزة إلى جميع المتصفحات بعد.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.deleteMockSensor(type)

المعلمات

الاسم	النوع	التفاصيل
type	String	نوع المستشعر الوهمي المراد حذفه.

---

setTimeZone

يحاكي تغيير المنطقة الزمنية لأغراض الاختبار. ملاحظة: لم تصل هذه الميزة إلى جميع المتصفحات بعد.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.setTimeZone(time_zone)

المعلمات

الاسم	النوع	التفاصيل
time_zone	string	اسم المنطقة الزمنية، مثل Asia/Tokyo

---

addVirtualAuthenticator

ينشئ مصادق افتراضي برمجي.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.addVirtualAuthenticator(protocol, transport, hasResidentKey, hasUserVerification, isUserConsenting, isUserVerified, extensions, uvm)

المعلمات

الاسم	النوع	التفاصيل
protocol اختياري	string	القيم الصالحة: 'ctap1/u2f'، 'ctap2'، 'ctap2_1'.
transport اختياري	string	القيم الصالحة: 'usb'، 'nfc'، 'ble' أو 'internal'.
hasResidentKey اختياري	boolean	القيم الصالحة: true، false.
hasUserVerification اختياري	boolean	القيم الصالحة: true، false.
isUserConsenting اختياري	boolean	القيم الصالحة: true، false.
isUserVerified اختياري	boolean	القيم الصالحة: مصفوفة تحتوي على معرفات الامتداد.
extensions اختياري	string[]	القيم الصالحة: ما يصل إلى 3 إدخالات لطريقة التحقق من المستخدم.
uvm اختياري	object[]

الإرجاع

• <string> authenticatorId: يعيد معرف سلسلة المصادق.

---

removeVirtualAuthenticator

يزيل مصادقًا افتراضيًا تم إنشاؤه مسبقًا.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.removeVirtualAuthenticator(authenticatorId)

المعلمات

الاسم	النوع	التفاصيل
authenticatorId	String	معرف المصادق

---

addCredential

يحقن مصدر بيانات اعتماد المفتاح العام في مصادق افتراضي موجود.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.addCredential(authenticatorId, credentialId, isResidentCredential, rpId, privateKey, userHandle, signCount, largeBlob)

المعلمات

الاسم	النوع	التفاصيل
authenticatorId	String	معرف المصادق
credentialId	string	معرف بيانات الاعتماد المرمز باستخدام ترميز Base64url.
isResidentCredential	boolean	إذا تم تعيينه إلى true، يتم إنشاء بيانات اعتماد قابلة للاكتشاف من جانب العميل. إذا تم تعيينه إلى false، يتم إنشاء بيانات اعتماد من جانب الخادم بدلاً من ذلك.
rpId	string	معرف الطرف المعتمد الذي تقتصر عليه بيانات الاعتماد.
privateKey	string	حزمة مفتاح غير متماثل تحتوي على مفتاح خاص واحد لكل [RFC5958]، مرمزة باستخدام ترميز Base64url.
userHandle	string	معالج المستخدم المرتبط ببيانات الاعتماد المرمزة باستخدام ترميز Base64url. قد لا يتم تعريف هذه الخاصية.
signCount	number	القيمة الأولية لعداد التوقيع المرتبط بمصدر بيانات اعتماد المفتاح العام.
largeBlob اختياري	string	الكتلة الكبيرة، لكل بيانات اعتماد المرتبطة بمصدر بيانات اعتماد المفتاح العام، مرمزة باستخدام ترميز Base64url. قد لا يتم تعريف هذه الخاصية.

---

getCredentials

يعيد كائن معلمات بيانات الاعتماد واحد لكل مصدر بيانات اعتماد المفتاح العام المخزن في مصادق افتراضي، بغض النظر عما إذا كانت مخزنة باستخدام Add Credential أو navigator.credentials.create().

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.getCredentials(authenticatorId)

المعلمات

الاسم	النوع	التفاصيل
authenticatorId	String	معرف المصادق

الإرجاع

• <object[]> credentials: يعيد مصفوفة من بيانات الاعتماد.

---

removeAllCredentials

يزيل جميع مصادر بيانات اعتماد المفتاح العام المخزنة على مصادق افتراضي.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.removeAllCredentials(authenticatorId)

المعلمات

الاسم	النوع	التفاصيل
authenticatorId	String	معرف المصادق

---

removeCredential

يزيل مصدر بيانات اعتماد المفتاح العام المخزن على مصادق افتراضي.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.removeCredential(authenticatorId, credentialId)

المعلمات

الاسم	النوع	التفاصيل
authenticatorId	String	معرف المصادق
credentialId	String	معرف بيانات الاعتماد

---

setUserVerified

يقوم أمر امتداد Set User Verified بتعيين خاصية isUserVerified على المصادق الافتراضي.

أمر بروتوكول WebDriver. يمكن العثور على مزيد من التفاصيل في وثائق البروتوكول الرسمية.

الاستخدام

browser.setUserVerified(authenticatorId)

المعلمات

الاسم	النوع	التفاصيل
authenticatorId	String	معرف المصادق