پرش به محتوای اصلی

کرومیوم

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 DevTools بررسی کنید.

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
optional		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​

فعال کردن حالت hover برای یک عنصر، که در تعامل بعدی ریست می‌شود.

دستور غیر رسمی و مستند نشده کرومیوم. اطلاعات بیشتر در مورد این دستور را می‌توانید اینجا پیدا کنید.

استفاده​
browser.elementHover(elementId)
پارامترها​
نامنوعجزئیات
elementIdStringشناسه عنصری که می‌خواهید روی آن hover کنید

touchPinch​

فعال کردن یک اثر زوم پینچ.

دستور غیر رسمی و مستند نشده کرومیوم. اطلاعات بیشتر در مورد این دستور را می‌توانید اینجا پیدا کنید.

استفاده​
browser.touchPinch(x, y, scale)
پارامترها​
نامنوعجزئیات
xnumberموقعیت x برای pinch
ynumberموقعیت y برای pinch
scalenumberمقیاس زوم pinch

freeze​

صفحه فعلی را منجمد می‌کند. گسترش برای Page Lifecycle API.

دستور غیر رسمی و مستند نشده کرومیوم. اطلاعات بیشتر در مورد این دستور را می‌توانید اینجا پیدا کنید.

استفاده​
browser.freeze()

resume​

صفحه فعلی را از حالت انجماد خارج می‌کند. گسترش برای Page Lifecycle API.

دستور غیر رسمی و مستند نشده کرومیوم. اطلاعات بیشتر در مورد این دستور را می‌توانید اینجا پیدا کنید.

استفاده​
browser.resume()

getCastSinks​

لیست سینک‌های cast (دستگاه‌های Cast) موجود برای مسیریاب رسانه Chrome را برمی‌گرداند.

دستور غیر رسمی و مستند نشده کرومیوم. اطلاعات بیشتر در مورد این دستور را می‌توانید اینجا پیدا کنید.

استفاده​
browser.getCastSinks()
مقادیر بازگشتی​
  • <string[]> sinks: لیست سینک‌های موجود.

selectCastSink​

یک سینک cast (دستگاه 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
optional		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