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

کرومیوم

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