انتقل إلى المحتوى الرئيسي

كروميوم

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)
المعلمات​
الاسمالنوعالتفاصيل
enabledbooleantrue إذا كان يجب تمكين الإبلاغ التلقائي، استخدم 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)
المعلمات​
الاسمالنوعالتفاصيل
parametersobjectكائن يحتوي على 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_conditionsobjectكائن يحتوي على ظروف الشبكة وهي 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)
المعلمات​
الاسمالنوعالتفاصيل
cmdstringاسم الأمر (مثل Browser.close).
paramsobjectمعلمات الأمر. في حالة عدم وجود معلمات للأمر، حدد كائنًا فارغًا.

sendCommandAndGetResult​

إرسال أمر إلى مصحح DevTools وانتظار النتيجة.
للاطلاع على قائمة الأوامر المتاحة ومعلماتها، راجع Chrome DevTools Protocol Viewer.

أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.

الاستخدام​
browser.sendCommandAndGetResult(cmd, params)
المعلمات​
الاسمالنوعالتفاصيل
cmdstringاسم الأمر الذي يُرجع نتيجة (مثل Network.getAllCookies).
paramsobjectمعلمات الأمر. في حالة عدم وجود معلمات للأمر، حدد كائنًا فارغًا.
يرجع​
  • <*> result: إما قيمة إرجاع الأمر الخاص بك، أو الخطأ الذي كان سبب فشل الأمر.

file​

تحميل ملف إلى الجهاز البعيد الذي يعمل عليه المتصفح.

أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.

الاستخدام​
browser.file(file)
المعلمات​
الاسمالنوعالتفاصيل
filestringأرشيف zip مشفر بـ Base64 يحتوي على ملف واحد للتحميل. في حالة أن البيانات المشفرة بـ base64 لا تمثل أرشيف zip أو أن الأرشيف يحتوي على أكثر من ملف واحد، سيلقي خطأ غير معروف.
يرجع​
  • <String> path: المسار المطلق للملف المحمّل على الجهاز البعيد.

launchChromeApp​

يطلق تطبيق Chrome بواسطة معرف محدد.

أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.

الاستخدام​
browser.launchChromeApp(id)
المعلمات​
الاسمالنوعالتفاصيل
idstringمعرف الإضافة للتطبيق المراد إطلاقه، كما هو محدد في 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)
المعلمات​
الاسمالنوعالتفاصيل
elementIdStringمعرف العنصر للحصول على القيمة منه
يرجع​
  • <String|Null> value: القيمة الحالية للعنصر. في حالة أن العنصر المحدد ليس عنصر تحكم نموذج، سيُرجع null.

elementHover​

تمكين حالة التحويم لعنصر، والتي تتم إعادة تعيينها عند التفاعل التالي.

أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.

الاستخدام​
browser.elementHover(elementId)
المعلمات​
الاسمالنوعالتفاصيل
elementIdStringمعرف العنصر للتحويم عليه

touchPinch​

تحفيز تأثير التكبير بالقرص.

أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.

الاستخدام​
browser.touchPinch(x, y, scale)
المعلمات​
الاسمالنوعالتفاصيل
xnumberموضع x للقرص
ynumberموضع y للقرص
scalenumberمقياس التكبير بالقرص

freeze​

تجميد الصفحة الحالية. امتداد لـ Page Lifecycle API.

أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.

الاستخدام​
browser.freeze()

resume​

استئناف الصفحة الحالية. امتداد لـ Page Lifecycle API.

أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.

الاستخدام​
browser.resume()

getCastSinks​

يُرجع قائمة بأجهزة البث (أجهزة Cast) المتاحة لموجه وسائط Chrome.

أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.

الاستخدام​
browser.getCastSinks()
يرجع​
  • <string[]> sinks: قائمة بالأجهزة المتاحة.

selectCastSink​

يختار جهاز بث (جهاز Cast) كمستلم لمقاصد موجه الوسائط (الاتصال أو التشغيل).

أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.

الاستخدام​
browser.selectCastSink(sinkName)
المعلمات​
الاسمالنوعالتفاصيل
sinkNamestringاسم الجهاز المستهدف.

startCastTabMirroring​

يبدأ عكس علامة التبويب لعلامة تبويب المتصفح الحالية على الجهاز المحدد.

أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.

الاستخدام​
browser.startCastTabMirroring(sinkName)
المعلمات​
الاسمالنوعالتفاصيل
sinkNamestringاسم الجهاز المستهدف.

getCastIssueMessage​

يُرجع رسالة الخطأ إذا كانت هناك أي مشكلة في جلسة Cast.

أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.

الاستخدام​
browser.getCastIssueMessage()
يرجع​
  • <String> message: رسالة الخطأ، إن وجدت.

stopCasting​

يوقف البث من موجه الوسائط إلى الجهاز المحدد، إذا كان متصلاً.

أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.

الاستخدام​
browser.stopCasting(sinkName)
المعلمات​
الاسمالنوعالتفاصيل
sinkNamestringاسم الجهاز المستهدف.

shutdown​

إيقاف عملية ChromeDriver وبالتالي إنهاء جميع الجلسات النشطة.

أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.

الاستخدام​
browser.shutdown()

takeElementScreenshot​

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

أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.

الاستخدام​
browser.takeElementScreenshot(elementId, scroll)
المعلمات​
الاسمالنوعالتفاصيل
elementIdStringمعرف العنصر المُرجع في استدعاء سابق لـ Find Element(s)
scroll
اختياري		booleanالتمرير لعرض العنصر. الافتراضي: true
يرجع​
  • <String> screenshot: بيانات صورة PNG المشفرة بـ base64 التي تشكل لقطة الشاشة للمنطقة المرئية من المستطيل المحيط للعنصر بعد تمريره للعرض.

getLogTypes​

الحصول على أنواع السجلات المتاحة.

أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.

الاستخدام​
browser.getLogTypes()
يرجع​
  • <String[]> logTypes: قائمة بأنواع السجلات المتاحة، مثال: browser، driver.

getLogs​

الحصول على السجل لنوع سجل معين. يتم إعادة تعيين مخزن السجل بعد كل طلب.

أمر كروميوم غير رسمي وغير موثق. يمكن العثور على المزيد حول هذا الأمر هنا.

الاستخدام​
browser.getLogs(type)
المعلمات​
الاسمالنوعالتفاصيل
typestringنوع السجل
يرجع​
  • <Object[]> logs: قائمة بإدخالات السجل.

Welcome! How can I help?

WebdriverIO AI Copilot