كروميوم
isAlertOpen
ما إذا كان هناك مربع حوار بسيط مفتوح حاليًا.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.isAlertOpen()
مثال
console.log(browser.isAlertOpen()); // outputs: false
browser.execute('window.alert()');
console.log(browser.isAlertOpen()); // outputs: true
يرجع
- <Boolean>
isAlertOpen
:true
أوfalse
بناءً على ما إذا كان مربع الحوار البسيط موجودًا أم لا.
isAutoReporting
ما إذا كان يجب رفع الأخطاء تلقائيًا في سجلات المتصفح.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.isAutoReporting()
يرجع
- <Boolean>
isAutoReporting
:true
أوfalse
بناءً على ما إذا كان الإبلاغ التلقائي ممكّنًا.
setAutoReporting
تبديل ما إذا كان سيتم إرجاع استجابة مع خطأ غير معروف مع أول خطأ متصفح (على سبيل المثال، فشل في تحميل المورد بسبب استجابة 403/404) لجميع الأوامر اللاحقة (بمجرد تمكينها).
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.setAutoReporting(enabled)
المعلمات
الاسم | النوع | التفاصيل |
---|---|---|
enabled | boolean | true إذا كان يجب تمكين الإبلاغ التلقائي، استخدم false لتعطيل الإبلاغ التلقائي الممكّن مسبقًا. |
أمثلة
// Enable auto reporting first thing after session was initiated with empty browser logs
console.log(browser.setAutoReporting(true)); // outputs: null
// Upon requesting an non-existing resource it will abort execution due to thrown unknown error
browser.url('https://webdriver.io/img/404-does-not-exist.png');
// During the session do some operations which populate the browser logs
browser.url('https://webdriver.io/img/404-does-not-exist.png');
browser.url('https://webdriver.io/403/no-access');
// Enable auto reporting which throws an unknown error for first browser log (404 response)
browser.setAutoReporting(true);
يرجع
- <Object|Null>
firstBrowserError
: في حالة حدوث خطأ متصفح أول مرة قبل تنفيذ هذا الأمر، سيلقي خطأ غير معروف كاستجابة، وهو كائن مع مفتاح 'message' يصف الخطأ الأول للمتصفح. وإلا فإنه يرجعnull
عند النجاح.
isLoading
يحدد حالة التحميل لمقبض النافذة النشط.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.isLoading()
مثال
console.log(browser.isLoading()); // outputs: false
browser.newWindow('https://webdriver.io');
console.log(browser.isLoading()); // outputs: true
يرجع
- <Boolean>
isLoading
:true
أوfalse
بناءً على ما إذا كان مقبض النافذة النشط قيد التحميل أم لا.
takeHeapSnapshot
يأخذ لقطة للكومة من سياق التنفيذ الحالي.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.takeHeapSnapshot()
يرجع
- <Object>
heapSnapshot
: تمثيل JSON للقطة الكومة. يمكن فحصها عن طريق تحميلها كملف في أدوات مطوري Chrome.
getNetworkConnection
الحصول على نوع الاتصال لمحاكاة الشبكة. هذا الأمر قابل للتطبيق فقط عندما يرد الطرف البعيد مع إعداد قدرة networkConnectionEnabled
على true
.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.getNetworkConnection()
مثال
const browser = remote({
capabilities: {
browserName: 'chrome',
'goog:chromeOptions': {
// Network emulation requires device mode, which is only enabled when mobile emulation is on
mobileEmulation: { deviceName: 'iPad' },
},
}
});
console.log(browser.getNetworkConnection()); // outputs: 6 (Both Wi-Fi and data)
يرجع
- <Number>
connectionType
: قناع بتي لتمثيل نوع اتصال الشبكة. وضع الطائرة (1
)، Wi-Fi فقط (2
)، Wi-Fi وبيانات (6
)، 4G (8
)، 3G (10
)، 2G (20
). بشكل افتراضي Wi-Fi والبيانات ممكّنان.
setNetworkConnection
تغيير نوع الاتصال لاتصال الشبكة. هذا الأمر قابل للتطبيق فقط عندما يرد الطرف البعيد مع إعداد قدرة networkConnectionEnabled
على true
.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.setNetworkConnection(parameters)
المعلمات
الاسم | النوع | التفاصيل |
---|---|---|
parameters | object | كائن يحتوي على ConnectionType، قم بتعيين قناع بتي كقيمة لمفتاح type في الكائن. وضع الطائرة (1 )، Wi-Fi فقط (2 )، Wi-Fi وبيانات (6 )، 4G (8 )، 3G (10 )، 2G (20 ). |
مثال
const browser = remote({
capabilities: {
browserName: 'chrome',
'goog:chromeOptions': {
// Network emulation requires device mode, which is only enabled when mobile emulation is on
mobileEmulation: { deviceName: 'iPad' },
},
}
});
console.log(browser.setNetworkConnection({ type: 1 })); // outputs: 1 (Airplane Mode)
يرجع
- <Number>
connectionType
: قناع بتي لتمثيل نوع اتصال الشبكة. يجب أن تتطابق القيمة معtype
المحدد في الكائن، ومع ذلك قد لا يكون الجهاز قادرًا على نوع اتصال الشبكة المطلوب.
getNetworkConditions
الحصول على ظروف الشبكة الحالية المستخدمة للمحاكاة.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.getNetworkConditions()
يرجع
- <Object>
networkConditions
: كائن يحتوي على ظروف الشبكة لـoffline
،latency
،download_throughput
وupload_throughput
. يجب تعيين ظروف الشبكة قبل أن يمكن استردادها.
setNetworkConditions
تعيين ظروف الشبكة المستخدمة للمحاكاة عن طريق تقييد الاتصال.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.setNetworkConditions(network_conditions, network_name)
المعلمات
الاسم | النوع | التفاصيل |
---|---|---|
network_conditions | object | كائن يحتوي على ظروف الشبكة وهي latency ، throughput (أو download_throughput /upload_throughput ) و offline (اختياري). |
network_name اختياري | string | اسم إعداد خنق الشبكة المسبق. GPRS ، Regular 2G ، Good 2G ، Regular 3G ، Good 3G ، Regular 4G ، DSL ، WiFi أو No throttling للتعطيل. عند تحديد الإعداد المسبق، لا يتم احترام القيم المرسلة في الوسيطة الأولى. |
أمثلة
// Use different download (25kb/s) and upload (50kb/s) throughput values for throttling with a latency of 1000ms
browser.setNetworkConditions({ latency: 1000, download_throughput: 25600, upload_throughput: 51200 });
// Force disconnected from network by setting 'offline' to true
browser.setNetworkConditions({ latency: 0, throughput: 0, offline: true });
// When preset name (e.g. 'DSL') is specified it does not respect values in object (e.g. 'offline')
browser.setNetworkConditions({ latency: 0, throughput: 0, offline: true }, 'DSL');
// Best practice for specifying network throttling preset is to use an empty object
browser.setNetworkConditions({}, 'Good 3G');
deleteNetworkConditions
تعطيل أي خنق للشبكة قد يكون تم تعيينه. مكافئ لتعيين إعداد No throttling
المسبق.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.deleteNetworkConditions()
sendCommand
إرسال أمر إلى مصحح DevTools.
للاطلاع على قائمة الأوامر المتاحة ومعلماتها، راجع Chrome DevTools Protocol Viewer.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.sendCommand(cmd, params)
المعلمات
الاسم | النوع | التفاصيل |
---|---|---|
cmd | string | اسم الأمر (مثل Browser.close ). |
params | object | معلمات الأمر. في حالة عدم وجود معلمات للأمر، حدد كائنًا فارغًا. |
sendCommandAndGetResult
إرسال أمر إلى مصحح DevTools وانتظار النتيجة.
للاطلاع على قائمة الأوامر المتاحة ومعلماتها، راجع Chrome DevTools Protocol Viewer.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.sendCommandAndGetResult(cmd, params)
المعلمات
الاسم | النوع | التفاصيل |
---|---|---|
cmd | string | اسم الأمر الذي يُرجع نتيجة (مثل Network.getAllCookies ). |
params | object | معلمات الأمر. في حالة عدم وجود معلمات للأمر، حدد كائنًا فارغًا. |
يرجع
- <*>
result
: إما قيمة إرجاع الأمر الخاص بك، أو الخطأ الذي كان سبب فشل الأمر.
file
تحميل ملف إلى الجهاز البعيد الذي يعمل عليه المتصفح.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.file(file)
المعلمات
الاسم | النوع | التفاصيل |
---|---|---|
file | string | أرشيف zip مشفر بـ Base64 يحتوي على ملف واحد للتحميل. في حالة أن البيانات المشفرة بـ base64 لا تمثل أرشيف zip أو أن الأرشيف يحتوي على أكثر من ملف واحد، سيلقي خطأ غير معروف. |
يرجع
- <String>
path
: المسار المطلق للملف المحمّل على الجهاز البعيد.
launchChromeApp
يطلق تطبيق Chrome بواسطة معرف محدد.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.launchChromeApp(id)
المعلمات
الاسم | النوع | التفاصيل |
---|---|---|
id | string | معرف الإضافة للتطبيق المراد إطلاقه، كما هو محدد في chrome://extensions. |
مثال
import fs from 'fs'
const browser = remote({
capabilities: {
browserName: 'chrome',
'goog:chromeOptions': {
// Install upon starting browser in order to launch it
extensions: [
// Entry should be a base64-encoded packed Chrome app (.crx)
fs.readFileSync('/absolute/path/app.crx').toString('base64')
]
}
}
});
browser.launchChromeApp('aohghmighlieiainnegkcijnfilokake')); // Google Docs (https://chrome.google.com/webstore/detail/docs/aohghmighlieiainnegkcijnfilokake)
getElementValue
يسترجع قيمة عنصر تحكم النموذج المعطى.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.getElementValue(elementId)
المعلمات
الاسم | النوع | التفاصيل |
---|---|---|
elementId | String | معرف العنصر للحصول على القيمة منه |
يرجع
- <String|Null>
value
: القيمة الحالية للعنصر. في حالة أن العنصر المحدد ليس عنصر تحكم نموذج، سيُرجعnull
.
elementHover
تمكين حالة التحويم لعنصر، والتي تتم إعادة تعيينها عند التفاعل التالي.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.elementHover(elementId)
المعلمات
الاسم | النوع | التفاصيل |
---|---|---|
elementId | String | معرف العنصر للتحويم عليه |
touchPinch
تحفيز تأثير التكبير بالقرص.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.touchPinch(x, y, scale)
المعلمات
الاسم | النوع | التفاصيل |
---|---|---|
x | number | موضع x للقرص |
y | number | موضع y للقرص |
scale | number | مقياس التكبير بالقرص |
freeze
تجميد الصفحة الحالية. امتداد لـ Page Lifecycle API.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.freeze()
resume
استئناف الصفحة الحالية. امتداد لـ Page Lifecycle API.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.resume()
getCastSinks
يُرجع قائمة بأجهزة البث (أجهزة Cast) المتاحة لموجه وسائط Chrome.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.getCastSinks()
يرجع
- <string[]>
sinks
: قائمة بالأجهزة المتاحة.
selectCastSink
يختار جهاز بث (جهاز Cast) كمستلم لمقاصد موجه الوسائط (الاتصال أو التشغيل).
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.selectCastSink(sinkName)
المعلمات
الاسم | النوع | التفاصيل |
---|---|---|
sinkName | string | اسم الجهاز المستهدف. |
startCastTabMirroring
يبدأ عكس علامة التبويب لعلامة تبويب المتصفح الحالية على الجهاز المحدد.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.startCastTabMirroring(sinkName)
المعلمات
الاسم | النوع | التفاصيل |
---|---|---|
sinkName | string | اسم الجهاز المستهدف. |
getCastIssueMessage
يُرجع رسالة الخطأ إذا كانت هناك أي مشكلة في جلسة Cast.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.getCastIssueMessage()
يرجع
- <String>
message
: رسالة الخطأ، إن وجدت.
stopCasting
يوقف البث من موجه الوسائط إلى الجهاز المحدد، إذا كان متصلاً.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.stopCasting(sinkName)
المعلمات
الاسم | النوع | التفاصيل |
---|---|---|
sinkName | string | اسم الجهاز المستهدف. |
shutdown
إيقاف عملية ChromeDriver وبالتالي إنهاء جميع الجلسات النشطة.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.shutdown()
takeElementScreenshot
يأخذ أمر Take Element Screenshot لقطة شاشة للمنطقة المرئية التي يشملها المستطيل المحيط للعنصر.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.takeElementScreenshot(elementId, scroll)
المعلمات
الاسم | النوع | التفاصيل |
---|---|---|
elementId | String | معرف العنصر المُرجع في استدعاء سابق لـ Find Element(s) |
scroll اختياري | boolean | التمرير لعرض العنصر. الافتراضي: true |
يرجع
- <String>
screenshot
: بيانات صورة PNG المشفرة بـ base64 التي تشكل لقطة الشاشة للمنطقة المرئية من المستطيل المحيط للعنصر بعد تمريره للعرض.
getLogTypes
الحصول على أنواع السجلات المتاحة.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.getLogTypes()
يرجع
- <String[]>
logTypes
: قائمة بأنواع السجلات المتاحة، مثال: browser، driver.
getLogs
الحصول على السجل لنوع سجل معين. يتم إعادة تعيين مخزن السجل بعد كل طلب.
أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.
الاستخدام
browser.getLogs(type)
المعلمات
الاسم | النوع | التفاصيل |
---|---|---|
type | string | نوع السجل |
يرجع
- <Object[]>
logs
: قائمة بإدخالات السجل.