chrome.networking.onc

شرح

از chrome.networking.onc API برای پیکربندی اتصال‌های شبکه (شبکه تلفن همراه، اترنت، VPN، یا Wi-Fi) استفاده می‌شود. این میانای برنامه‌سازی کاربردی در جلسه‌های کیوسک Chrome OS که به‌طور خودکار راه‌اندازی شده‌اند دردسترس است.

پیکربندی‌های اتصال شبکه طبق مشخصات پیکربندی شبکه باز (ONC) مشخص شده است.

NOTE: اکثر ویژگی‌های واژه‌نامه و مقادیر enum از UpperCamelCase برای مطابقت با مشخصات ONC به‌جای قرارداد lowerCamelCase جاوا اسکریپت استفاده می‌کنند.

اجازه‌ها

networking.onc

دردسترس بودن

Chrome نسخه ۵۹ و بالاتر فقط ChromeOS

انواع

ActivationStateType

شمارشی

«فعال‌شده»

«درحال فعال‌سازی»

"NotActivated"

«PartiallyActivated»

CaptivePortalStatus

شمارشی

«نامشخص»

«آفلاین»

«آنلاین»

«درگاه»

"ProxyAuthRequired"

CellularProperties

مشخصات

  • ActivationState

    ActivationStateType اختیاری

    وضعیت فعال‌سازی حساب شرکت مخابراتی.

  • ActivationType

    رشته اختیاری

    نوع فعال‌سازی شبکه تلفن همراه.

  • AllowRoaming

    بولی اختیاری

    آیا رومینگ برای شبکه مجاز است یا نه.

  • AutoConnect

    بولی اختیاری

    آیا شبکه تلفن همراه باید به‌طور خودکار متصل شود (وقتی در محدوده است).

  • خانواده

    رشته اختیاری

    خانواده فناوری دستگاه سلولی - CDMA یا GSM.

  • FirmwareRevision

    رشته اختیاری

    نسخه سفت‌افزار بارشده در مودم سلولی.

  • FoundNetworks

    FoundNetworkProperties[] اختیاری

    فهرست شبکه‌هایی که درطول آخرین اسکن شبکه پیدا شده‌اند.

  • HardwareRevision

    رشته اختیاری

    نسخه سخت‌افزار مودم سلولی.

  • HomeProvider

    CellularProviderProperties اختیاری

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

  • سازنده

    رشته اختیاری

    سازنده مودم سلولی.

  • ModelID

    رشته اختیاری

    شناسه مدل مودم سلولی.

  • NetworkTechnology

    رشته اختیاری

    اگر مودم در شبکه‌ای ثبت شده باشد، فناوری شبکه درحال‌حاضر مورداستفاده قرار می‌گیرد.

  • PaymentPortal

    PaymentPortal اختیاری

    درگاه پرداخت آنلاین که کاربر می‌تواند از آن برای ثبت‌نام یا اصلاح طرح داده تلفن همراه استفاده کند.

  • RoamingState

    رشته اختیاری

    وضعیت فراگردی مودم سلولی در شبکه فعلی.

  • SIMLockStatus

    SIMLockStatus اختیاری

    وضعیت قفل سیم‌کارت برای شبکه‌های خانواده GSM.

  • SIMPresent

    بولی اختیاری

    آیا سیم‌کارت وجود دارد یا نه.

  • اسکن کردن

    بولی اختیاری

    Chrome نسخه ۶۳ و بالاتر

    وقتی اسکن شبکه تلفن همراه درحال انجام باشد، درست است.

  • ServingOperator

    CellularProviderProperties اختیاری

    اطلاعات مربوط به اپراتوری که مودم درحال‌حاضر در شبکه آن ثبت شده است.

  • SignalStrength

    شماره اختیاری

    قدرت سیگنال شبکه فعلی.

  • SupportNetworkScan

    بولی اختیاری

    آیا شبکه تلفن همراه از اسکن پشتیبانی می‌کند یا نه.

CellularProviderProperties

مشخصات

  • کد

    رشته

    شناسه شبکه تلفن همراه به‌عنوان الحاق ساده MCC (کد کشور تلفن همراه) و MNC (کد شبکه تلفن همراه) شبکه.

  • کشور

    رشته اختیاری

    کد کشور دوحرفی.

  • نام

    رشته

    نام اپراتور.

CellularStateProperties

مشخصات

CertificatePattern

مشخصات

  • EnrollmentURI

    رشته[] اختیاری

    فهرست شناسه‌های منبع یکسانی که درصورت پیدا نشدن گواهی‌های منطبق با این الگو، کاربر می‌تواند به آن‌ها هدایت شود.

  • صادرکننده

    IssuerSubjectPattern اختیاری

    اگر تنظیم شده باشد، الگویی که تنظیمات صادرکننده X.509 باید با آن مطابقت داشته باشد.

  • IssuerCARef

    رشته[] اختیاری

    فهرست گواهینامه‌های مرکز صدور گواهی صادرکننده گواهینامه. گواهی باید توسط یکی از آن‌ها امضا شده باشد تا با این الگو مطابقت داشته باشد.

  • موضوع

    IssuerSubjectPattern اختیاری

    اگر تنظیم شده باشد، الگویی که تنظیمات موضوع X.509 باید با آن مطابقت داشته باشد.

ClientCertificateType

شمارشی

«Ref»

«الگو»

ConnectionStateType

شمارشی

«متصل»

«درحال اتصال»

"NotConnected"

DeviceStateProperties

مشخصات

  • SIMLockStatus

    SIMLockStatus اختیاری

    Chrome نسخه ۶۲ به بالا

    وضعیت قفل سیم‌کارت اگر Type = Cellular و SIMPresent = True باشد.

  • SIMPresent

    بولی اختیاری

    Chrome نسخه ۶۲ به بالا

    اگر نوع دستگاه «شبکه تلفن همراه» است، روی وضعیت «سیم‌کارت موجود» تنظیم کنید.

  • اسکن کردن

    بولی اختیاری

    تنظیم کنید که آیا دستگاه فعال است یا نه. اگر دستگاه درحال اسکن باشد، مقدار True (درست) است.

  • ایالت

    DeviceStateType

    وضعیت فعلی دستگاه.

  • نوع

    NetworkType

    نوع شبکه مرتبط با دستگاه (تلفن همراه، اترنت، یا Wi-Fi).

DeviceStateType

شمارشی

«راه‌اندازی‌نشده»
دستگاه دردسترس است اما راه‌اندازی نشده است.

«غیرفعال»
دستگاه مقداردهی اولیه شده است اما فعال نیست.

«درحال فعال‌سازی»
وضعیت «فعال‌شده» درخواست شده است اما تکمیل نشده است.

«فعال»
دستگاه فعال است.

«ممنوع»
دستگاه ممنوع است.

EAPProperties

مشخصات

  • AnonymousIdentity

    رشته اختیاری

  • ClientCertPKCS11Id

    رشته اختیاری

    Chrome نسخه ۶۰ و بالاتر
  • ClientCertPattern

    CertificatePattern اختیاری

  • ClientCertProvisioningProfileId

    رشته اختیاری

    Chrome نسخه ۹۳ به بالا
  • ClientCertRef

    رشته اختیاری

  • ClientCertType

    ClientCertificateType

  • شناسه

    رشته اختیاری

  • داخلی

    رشته اختیاری

  • بیرونی

    رشته اختیاری

    نوع EAP خارجی. توسط ONC الزامی است، اما ممکن است هنگام ترجمه از Shill ارائه نشود.

  • گذرواژه

    رشته اختیاری

  • SaveCredentials

    بولی اختیاری

  • ServerCAPEMs

    رشته[] اختیاری

  • ServerCARefs

    رشته[] اختیاری

  • SubjectMatch

    ManagedDOMString اختیاری

    Chrome نسخه ۶۰ و بالاتر
  • UseProactiveKeyCaching

    بولی اختیاری

  • UseSystemCAs

    بولی اختیاری

EthernetProperties

مشخصات

  • اصالت‌سنجی

    رشته اختیاری

    اصالت‌سنجی مورداستفاده شبکه اترنت. مقادیر ممکن None و 8021X است.

  • AutoConnect

    بولی اختیاری

    اینکه آیا شبکه اترنت باید به‌طور خودکار متصل شود یا نه.

  • EAP

    EAPProperties اختیاری

    تنظیمات EAP شبکه. برای اصالت‌سنجی 8021X لازم است.

EthernetStateProperties

مشخصات

FoundNetworkProperties

مشخصات

  • LongName

    رشته اختیاری

    نام قالب طولانی اپراتور شبکه.

  • NetworkId

    رشته

    شناسه شبکه.

  • ShortName

    رشته اختیاری

    نام کوتاه اپراتور شبکه.

  • وضعیت

    رشته

    دسترسی‌پذیری شبکه.

  • فناوری

    رشته

    فناوری دسترسی مورداستفاده شبکه.

GlobalPolicy

مشخصات

  • AllowOnlyPolicyNetworksToAutoconnect

    بولی اختیاری

    اگر درست باشد، فقط شبکه‌های خط‌مشی می‌توانند به‌طور خودکار متصل شوند. پیش‌فرض: نادرست.

  • AllowOnlyPolicyNetworksToConnect

    بولی اختیاری

    اگر درست باشد، فقط شبکه‌های خط‌مشی می‌توانند متصل شوند و هیچ شبکه جدیدی نمی‌تواند اضافه یا پیکربندی شود. پیش‌فرض: نادرست.

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    بولی اختیاری

    Chrome نسخه ۷۰ به بالا

    اگر درست باشد و شبکه مدیریت‌شده‌ای در فهرست شبکه‌های قابل‌مشاهده دردسترس باشد، فقط شبکه‌های خط‌مشی ممکن است متصل شوند و هیچ شبکه جدیدی ممکن است اضافه یا پیکربندی نشود. پیش‌فرض: نادرست.

  • BlockedHexSSIDs

    رشته[] اختیاری

    Chrome نسخه ۸۶ و بالاتر

    فهرست شبکه‌های مسدودشده. اتصال به شبکه‌های مسدودشده ممنوع است. با مشخص کردن پیکربندی صریح شبکه، می‌توان دوباره شبکه‌ها را رفع انسداد کرد. به‌طور پیش‌فرض روی فهرست خالی تنظیم شده است.

IPConfigProperties

مشخصات

  • ExcludedRoutes

    رشته[] اختیاری

    Chrome نسخه ۷۶ و بالاتر

    آرایه بلوک‌های IP در نماد CIDR، برای جزئیات onc_spec.md را ببینید.

  • دروازه

    رشته اختیاری

    نشانی درگاه مورداستفاده برای پیکربندی IP.

  • IPAddress

    رشته اختیاری

    نشانی IP برای اتصال. بسته به مقدار Type، می‌تواند نشانی پروتکل اینترنتی نسخه ۴ یا پروتکل اینترنتی نسخه ۶ باشد.

  • IncludedRoutes

    رشته[] اختیاری

    Chrome نسخه ۷۶ و بالاتر

    آرایه بلوک‌های IP در نماد CIDR، برای جزئیات onc_spec.md را ببینید.

  • NameServers

    رشته[] اختیاری

    آرایه نشانی‌های استفاده‌شده برای سرورهای نام.

  • RoutingPrefix

    شماره اختیاری

    پیشوند مسیریابی.

  • SearchDomains

    رشته[] اختیاری

    Chrome نسخه ۷۶ و بالاتر

    آرایه رشته‌ها برای تفکیک نام، برای جزئیات onc_spec.md را ببینید.

  • نوع

    رشته اختیاری

    نوع پیکربندی IP. می‌تواند IPv4 یا IPv6 باشد.

  • WebProxyAutoDiscoveryUrl

    رشته اختیاری

    نشانی وب برای «کشف خودکار پراکسی وب»، همان‌طور که ازطریق DHCP گزارش شده است.

IPConfigType

شمارشی

"DHCP"

«ایستا»

IssuerSubjectPattern

مشخصات

  • CommonName

    رشته اختیاری

    اگر تنظیم شود، مقداری که نام مشترک موضوع گواهینامه با آن مطابقت داده می‌شود.

  • ناحیه

    رشته اختیاری

    اگر تنظیم شود، مقداری که مکان مشترک موضوع گواهینامه با آن مطابقت داده می‌شود.

  • سازمان

    رشته اختیاری

    اگر تنظیم شده باشد، مقداری که سازمان‌های موضوع گواهی با آن مطابقت داده می‌شود. حداقل یک سازمان باید با این مقدار مطابقت داشته باشد.

  • OrganizationalUnit

    رشته اختیاری

    اگر تنظیم شود، مقداری که واحدهای سازمانی موضوع گواهی با آن مطابقت داده می‌شود. حداقل یک واحد سازمانی باید با مقدار مطابقت داشته باشد.

ManagedBoolean

مشخصات

  • فعال

    بولی اختیاری

    مقدار فعالی که درحال‌حاضر توسط مدیر پیکربندی شبکه (مثلاً Shill) استفاده می‌شود.

  • DeviceEditable

    بولی اختیاری

    آیا DevicePolicy برای ویژگی وجود دارد و اجازه می‌دهد ویژگی ویرایش شود (یعنی خط‌مشی مقدار ویژگی توصیه‌شده را تنظیم کرده است). پیش‌فرض‌ها به false.

  • DevicePolicy

    بولی اختیاری

    مقدار ویژگی ارائه‌شده توسط خط‌مشی دستگاه.

  • تأثیرگذار

    رشته اختیاری

    منبعی که مقدار خصوصیت مؤثر از آن تعیین شده است.

  • SharedSetting

    بولی اختیاری

    مقدار تنظیم‌شده برای همه کاربران دستگاه. فقط درصورتی ارائه می‌شود که DeviceEditiable، true باشد.

  • UserEditable

    بولی اختیاری

    اینکه UserPolicy برای دارایی وجود دارد و اجازه می‌دهد دارایی ویرایش شود (یعنی خط‌مشی مقدار دارایی توصیه‌شده را تنظیم می‌کند). پیش‌فرض‌ها به false.

  • UserPolicy

    بولی اختیاری

    مقدار مشخصه ارائه‌شده توسط خط‌مشی کاربر.

  • UserSetting

    بولی اختیاری

    مقدار مشخصه تنظیم‌شده توسط کاربر واردشده به سیستم. فقط درصورتی ارائه می‌شود که UserEditable، true باشد.

ManagedCellularProperties

مشخصات

ManagedDOMString

مشخصات

  • فعال

    رشته اختیاری

    مقدار فعالی که درحال‌حاضر توسط مدیر پیکربندی شبکه (مثلاً Shill) استفاده می‌شود.

  • DeviceEditable

    بولی اختیاری

    آیا DevicePolicy برای ویژگی وجود دارد و اجازه می‌دهد ویژگی ویرایش شود (یعنی خط‌مشی مقدار ویژگی توصیه‌شده را تنظیم کرده است). پیش‌فرض‌ها به false.

  • DevicePolicy

    رشته اختیاری

    مقدار ویژگی ارائه‌شده توسط خط‌مشی دستگاه.

  • تأثیرگذار

    رشته اختیاری

    منبعی که مقدار خصوصیت مؤثر از آن تعیین شده است.

  • SharedSetting

    رشته اختیاری

    مقدار تنظیم‌شده برای همه کاربران دستگاه. فقط درصورتی ارائه می‌شود که DeviceEditiable، true باشد.

  • UserEditable

    بولی اختیاری

    اینکه UserPolicy برای دارایی وجود دارد و اجازه می‌دهد دارایی ویرایش شود (یعنی خط‌مشی مقدار دارایی توصیه‌شده را تنظیم می‌کند). پیش‌فرض‌ها به false.

  • UserPolicy

    رشته اختیاری

    مقدار مشخصه ارائه‌شده توسط خط‌مشی کاربر.

  • UserSetting

    رشته اختیاری

    مقدار مشخصه تنظیم‌شده توسط کاربر واردشده به سیستم. فقط درصورتی ارائه می‌شود که UserEditable، true باشد.

ManagedDOMStringList

مشخصات

  • فعال

    رشته[] اختیاری

    مقدار فعالی که درحال‌حاضر توسط مدیر پیکربندی شبکه (مثلاً Shill) استفاده می‌شود.

  • DeviceEditable

    بولی اختیاری

    آیا DevicePolicy برای ویژگی وجود دارد و اجازه می‌دهد ویژگی ویرایش شود (یعنی خط‌مشی مقدار ویژگی توصیه‌شده را تنظیم کرده است). پیش‌فرض‌ها به false.

  • DevicePolicy

    رشته[] اختیاری

    مقدار ویژگی ارائه‌شده توسط خط‌مشی دستگاه.

  • تأثیرگذار

    رشته اختیاری

    منبعی که مقدار خصوصیت مؤثر از آن تعیین شده است.

  • SharedSetting

    رشته[] اختیاری

    مقدار تنظیم‌شده برای همه کاربران دستگاه. فقط درصورتی ارائه می‌شود که DeviceEditiable، true باشد.

  • UserEditable

    بولی اختیاری

    اینکه UserPolicy برای دارایی وجود دارد و اجازه می‌دهد دارایی ویرایش شود (یعنی خط‌مشی مقدار دارایی توصیه‌شده را تنظیم می‌کند). پیش‌فرض‌ها به false.

  • UserPolicy

    رشته[] اختیاری

    مقدار مشخصه ارائه‌شده توسط خط‌مشی کاربر.

  • UserSetting

    رشته[] اختیاری

    مقدار مشخصه تنظیم‌شده توسط کاربر واردشده به سیستم. فقط درصورتی ارائه می‌شود که UserEditable، true باشد.

ManagedEthernetProperties

مشخصات

ManagedIPConfigProperties

مشخصات

ManagedIPConfigType

مشخصات

  • فعال

    IPConfigType اختیاری

    مقدار فعالی که درحال‌حاضر توسط مدیر پیکربندی شبکه (مثلاً Shill) استفاده می‌شود.

  • DeviceEditable

    بولی اختیاری

    آیا DevicePolicy برای ویژگی وجود دارد و اجازه می‌دهد ویژگی ویرایش شود (یعنی خط‌مشی مقدار ویژگی توصیه‌شده را تنظیم کرده است). پیش‌فرض‌ها به false.

  • DevicePolicy

    IPConfigType اختیاری

    مقدار ویژگی ارائه‌شده توسط خط‌مشی دستگاه.

  • تأثیرگذار

    رشته اختیاری

    منبعی که مقدار خصوصیت مؤثر از آن تعیین شده است.

  • SharedSetting

    IPConfigType اختیاری

    مقدار تنظیم‌شده برای همه کاربران دستگاه. فقط درصورتی ارائه می‌شود که DeviceEditiable، true باشد.

  • UserEditable

    بولی اختیاری

    اینکه UserPolicy برای دارایی وجود دارد و اجازه می‌دهد دارایی ویرایش شود (یعنی خط‌مشی مقدار دارایی توصیه‌شده را تنظیم می‌کند). پیش‌فرض‌ها به false.

  • UserPolicy

    IPConfigType اختیاری

    مقدار مشخصه ارائه‌شده توسط خط‌مشی کاربر.

  • UserSetting

    IPConfigType اختیاری

    مقدار مشخصه تنظیم‌شده توسط کاربر واردشده به سیستم. فقط درصورتی ارائه می‌شود که UserEditable، true باشد.

ManagedLong

مشخصات

  • فعال

    شماره اختیاری

    مقدار فعالی که درحال‌حاضر توسط مدیر پیکربندی شبکه (مثلاً Shill) استفاده می‌شود.

  • DeviceEditable

    بولی اختیاری

    آیا DevicePolicy برای ویژگی وجود دارد و اجازه می‌دهد ویژگی ویرایش شود (یعنی خط‌مشی مقدار ویژگی توصیه‌شده را تنظیم کرده است). پیش‌فرض‌ها به false.

  • DevicePolicy

    شماره اختیاری

    مقدار ویژگی ارائه‌شده توسط خط‌مشی دستگاه.

  • تأثیرگذار

    رشته اختیاری

    منبعی که مقدار خصوصیت مؤثر از آن تعیین شده است.

  • SharedSetting

    شماره اختیاری

    مقدار تنظیم‌شده برای همه کاربران دستگاه. فقط درصورتی ارائه می‌شود که DeviceEditiable، true باشد.

  • UserEditable

    بولی اختیاری

    اینکه UserPolicy برای دارایی وجود دارد و اجازه می‌دهد دارایی ویرایش شود (یعنی خط‌مشی مقدار دارایی توصیه‌شده را تنظیم می‌کند). پیش‌فرض‌ها به false.

  • UserPolicy

    شماره اختیاری

    مقدار مشخصه ارائه‌شده توسط خط‌مشی کاربر.

  • UserSetting

    شماره اختیاری

    مقدار مشخصه تنظیم‌شده توسط کاربر واردشده به سیستم. فقط درصورتی ارائه می‌شود که UserEditable، true باشد.

ManagedManualProxySettings

مشخصات

ManagedProperties

مشخصات

ManagedProxyLocation

مشخصات

ManagedProxySettings

مشخصات

ManagedProxySettingsType

مشخصات

  • فعال

    ProxySettingsType اختیاری

    مقدار فعالی که درحال‌حاضر توسط مدیر پیکربندی شبکه (مثلاً Shill) استفاده می‌شود.

  • DeviceEditable

    بولی اختیاری

    آیا DevicePolicy برای ویژگی وجود دارد و اجازه می‌دهد ویژگی ویرایش شود (یعنی خط‌مشی مقدار ویژگی توصیه‌شده را تنظیم کرده است). پیش‌فرض‌ها به false.

  • DevicePolicy

    ProxySettingsType اختیاری

    مقدار ویژگی ارائه‌شده توسط خط‌مشی دستگاه.

  • تأثیرگذار

    رشته اختیاری

    منبعی که مقدار خصوصیت مؤثر از آن تعیین شده است.

  • SharedSetting

    ProxySettingsType اختیاری

    مقدار تنظیم‌شده برای همه کاربران دستگاه. فقط درصورتی ارائه می‌شود که DeviceEditiable، true باشد.

  • UserEditable

    بولی اختیاری

    اینکه UserPolicy برای دارایی وجود دارد و اجازه می‌دهد دارایی ویرایش شود (یعنی خط‌مشی مقدار دارایی توصیه‌شده را تنظیم می‌کند). پیش‌فرض‌ها به false.

  • UserPolicy

    ProxySettingsType اختیاری

    مقدار مشخصه ارائه‌شده توسط خط‌مشی کاربر.

  • UserSetting

    ProxySettingsType اختیاری

    مقدار مشخصه تنظیم‌شده توسط کاربر واردشده به سیستم. فقط درصورتی ارائه می‌شود که UserEditable، true باشد.

ManagedThirdPartyVPNProperties

مشخصات

ManagedVPNProperties

مشخصات

ManagedWiFiProperties

مشخصات

ManualProxySettings

مشخصات

  • FTPProxy

    ProxyLocation اختیاری

    تنظیمات پراکسی FTP.

  • HTTPProxy

    ProxyLocation اختیاری

    تنظیمات پراکسی HTTP.

  • SOCKS

    ProxyLocation اختیاری

    تنظیمات پراکسی SOCKS.

  • SecureHTTPProxy

    ProxyLocation اختیاری

    تنظیمات پراکسی HTTP ایمن.

NetworkConfigProperties

مشخصات

NetworkFilter

مشخصات

  • پیکربندی‌شده

    بولی اختیاری

    اگر درست باشد، فقط شبکه‌های پیکربندی‌شده (ذخیره‌شده) را شامل می‌شود. پیش‌فرض: «false».

  • حد

    شماره اختیاری

    حداکثر تعداد شبکه‌ها برای برگرداندن. اگر مشخص نشده باشد، به‌طور پیش‌فرض ۱۰۰۰ است. برای بدون محدودیت، از ۰ استفاده کنید.

  • networkType

    NetworkType

    نوع شبکه‌هایی که باید برگردانده شود.

  • قابل رؤیت

    بولی اختیاری

    اگر درست باشد، فقط شبکه‌های نمایان (متصل فیزیکی یا در محدوده) را شامل می‌شود. پیش‌فرض: «false».

NetworkProperties

مشخصات

  • شبکه همراه

    CellularProperties اختیاری

    برای شبکه‌های تلفن همراه، ویژگی‌های شبکه تلفن همراه.

  • قابل‌اتصال

    بولی اختیاری

    آیا شبکه قابل‌اتصال است یا نه.

  • ConnectionState

    ConnectionStateType اختیاری

    وضعیت اتصال فعلی شبکه.

  • ErrorState

    رشته اختیاری

    آخرین حالت خطای شبکه ثبت‌شده.

  • اترنت

    EthernetProperties اختیاری

    برای شبکه‌های اترنت، ویژگی‌های شبکه اترنت.

  • GUID

    رشته

    شناسه یکتای سراسری شبکه.

  • IPAddressConfigType

    IPConfigType اختیاری

    نوع پیکربندی نشانی IP شبکه.

  • IPConfigs

    IPConfigProperties[] اختیاری

    پیکربندی IP شبکه.

  • MacAddress

    رشته اختیاری

    مک آدرس شبکه.

  • محدودشده

    بولی اختیاری

    Chrome نسخه ۸۵ و بالاتر

    اینکه شبکه با حجم محدود است یا نه.

  • نام

    رشته اختیاری

    نام شبکه کاربرپسند.

  • NameServersConfigType

    IPConfigType اختیاری

    نوع پیکربندی IP برای سرورهای نامی که شبکه استفاده می‌کند.

  • اولویت

    شماره اختیاری

    اولویت شبکه.

  • ProxySettings

    ProxySettings اختیاری

    تنظیمات پراکسی شبکه.

  • RestrictedConnectivity

    بولی اختیاری

    برای شبکه متصل، اینکه آیا اتصال شبکه به اینترنت محدود است یا نه، مثلاً اگر شبکه پشت درگاه باشد یا شبکه تلفن همراه فعال نشده باشد.

  • SavedIPConfig

    IPConfigProperties اختیاری

    پیکربندی IP که قبل‌از اعمال پیکربندی IP ایستا از سرور DHCP دریافت شده است.

  • منبع

    رشته اختیاری

    نشان می‌دهد که آیا شبکه پیکربندی شده است یا نه و چگونه پیکربندی شده است. مقادیر ممکن عبارت‌اند از:

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    «هیچ‌کدام» با تولید کد افزونه تداخل دارد، بنابراین باید به‌جای SourceType enum از رشته برای «منبع» استفاده کنیم.

  • StaticIPConfig

    IPConfigProperties اختیاری

    پیکربندی IP ثابت شبکه.

  • TrafficCounterResetTime

    شماره اختیاری

    Chrome نسخه ۱۲۵ و بالاتر

    آخرین باری که شمارنده‌های ترافیک بازنشانی شدند.

  • نوع

    NetworkType

    نوع شبکه.

  • VPN

    VPNProperties اختیاری

    برای شبکه‌های VPN، ویژگی‌های VPN شبکه.

  • Wi-Fi

    WiFiProperties اختیاری

    برای شبکه‌های Wi-Fi، ویژگی‌های Wi-Fi شبکه.

NetworkStateProperties

مشخصات

NetworkType

شمارشی

«همه»

«Cellular» (سلولی)

«اترنت»

«Tether»

«وی‌پی‌ان»

«بی‌سیم»

«WiFi»

PaymentPortal

مشخصات

  • روش

    رشته

    روش HTTP برای استفاده در درگاه پرداخت.

  • PostData

    رشته اختیاری

    داده‌های پست برای ارسال به درگاه پرداخت. نادیده گرفته می‌شود مگراینکه Method، POST باشد.

  • نشانی وب

    رشته اختیاری

    نشانی وب درگاه پرداخت.

ProxyLocation

مشخصات

  • میزبان

    رشته

    میزبان نشانی IP پراکسی.

  • درگاه

    شماره

    درگاهی که برای پراکسی استفاده می‌شود.

ProxySettings

مشخصات

  • ExcludeDomains

    رشته[] اختیاری

    دامنه‌ها و میزبان‌هایی که تنظیمات پراکسی دستی برای آن‌ها مستثنی شده است.

  • دستی

    ManualProxySettings اختیاری

    تنظیمات پراکسی دستی - فقط برای تنظیمات پراکسی Manual استفاده می‌شود.

  • کمیته اقدامات سیاسی

    رشته اختیاری

    نشانی وب برای فایل پیکربندی خودکار پراکسی.

  • نوع تنظیمات پراکسی.

ProxySettingsType

شمارشی

«مستقیم»

«دستی»

«PAC»

«WPAD»

SIMLockStatus

مشخصات

  • LockEnabled

    بولی

    آیا قفل سیم‌کارت فعال است یا نه.

  • LockType

    رشته

    وضعیت قفل سیم‌کارت - مقادیر ممکن عبارتند از 'sim-pin'، 'sim-puk'، و ''.

  • RetriesLeft

    شماره اختیاری

    تعداد دفعات مجاز برای وارد کردن پین قفل قبل‌از اینکه برای باز کردن قفل سیم‌کارت به PUK نیاز باشد.

ThirdPartyVPNProperties

مشخصات

  • ExtensionID

    رشته

    شناسه افزونه ارائه‌دهنده VPN طرف سوم.

  • ProviderName

    رشته اختیاری

    نام ارائه‌دهنده وی‌پی‌ان.

VPNProperties

مشخصات

  • AutoConnect

    بولی اختیاری

    اینکه شبکه VPN باید به‌طور خودکار متصل شود یا نه.

  • میزبان

    رشته اختیاری

    میزبان وی‌پی‌ان.

  • نوع

    رشته اختیاری

    نوع VPN. این نمی‌تواند enum باشد چون «L2TP-IPSec» است. این مورد برای NetworkConfigProperties اختیاری است که به setProperties ارسال می‌شود و ممکن است فقط برای تنظیم ویژگی‌های خاصی استفاده شود.

VPNStateProperties

مشخصات

WiFiProperties

مشخصات

  • AllowGatewayARPPolling

    بولی اختیاری

    از Chrome 131 منسوخ شده است

    در M131 برداشته شده است. درحال‌حاضر نظرسنجی ARP فعالی وجود ندارد.

  • AutoConnect

    بولی اختیاری

    آیا شبکه Wi-Fi باید هنگام قرار گرفتن در محدوده به‌طور خودکار متصل شود.

  • شناسه مجموعه سرویس‌های اصلی

    رشته اختیاری

    BSSID نقطه دسترسی مربوطه.

  • EAP

    EAPProperties اختیاری

    ویژگی‌های EAP شبکه. برای شبکه‌های WEP-8021X و WPA-EAP لازم است.

  • بسامد

    شماره اختیاری

    فرکانس عملکرد سرویس WiFi برحسب مگاهرتز. برای شبکه‌های متصل، فرکانس فعلی که شبکه روی آن متصل است. درغیراین‌صورت، فرکانس بهترین BSS دردسترس.

  • FrequencyList

    number[] اختیاری

    حاوی همه فرکانس‌های عملیاتی است که اخیراً برای شبکه WiFi دیده شده است.

  • HexSSID

    رشته اختیاری

    نسخه کدبندی‌شده HEX از SSID شبکه.

  • HiddenSSID

    بولی اختیاری

    آیا SSID شبکه همه‌فرستی خواهد شد یا نه.

  • گذرعبارت

    رشته اختیاری

    Chrome نسخه ۶۶ و بالاتر

    گذرعبارت برای اتصال‌های WEP/WPA/WPA2. این ویژگی فقط می‌تواند تنظیم شود - ویژگی‌های برگردانده‌شده توسط getProperties حاوی این مقدار نخواهند بود.

  • RoamThreshold

    شماره اختیاری

    منسوخ‌شده، نادیده گرفته شد.

  • SSID

    رشته اختیاری

    SSID شبکه.

  • امنیت

    رشته اختیاری

    نوع امنیت شبکه.

  • SignalStrength

    شماره اختیاری

    قدرت سیگنال شبکه.

WiFiStateProperties

مشخصات

WiMAXProperties

مشخصات

  • AutoConnect

    بولی اختیاری

    آیا شبکه باید به‌طور خودکار متصل شود یا نه.

  • EAP

    EAPProperties اختیاری

    ویژگی‌های EAP شبکه.

روش‌ها

createNetwork()

قول 
chrome.networking.onc.createNetwork(
  shared: boolean,
  properties: NetworkConfigProperties,
  callback?: function,
): Promise<string>

پیکربندی شبکه جدیدی از ویژگی‌ها ایجاد می‌کند. اگر شبکه پیکربندی‌شده منطبقی ازقبل وجود داشته باشد، این کار ناموفق خواهد بود. درغیراین‌صورت، GUID شبکه جدید را برمی‌گرداند.

پارامترها

  • هم‌رسانی‌شده

    بولی

    اگر true، این پیکربندی شبکه را با کاربران دیگر هم‌رسانی کنید.

    این گزینه فقط در واسط کاربر وب Chrome نمایش داده می‌شود.* وقتی توسط برنامه‌ها فراخوانی می‌شود، false تنها مقدار مجاز است.

  • اقامتگاه‌ها

    NetworkConfigProperties

    ویژگی‌هایی که شبکه جدید با آن‌ها پیکربندی می‌شود.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (result: string) => void

    • نتیجه

      رشته

بازگشتی‌ها

  • Promise<string>

    Chrome نسخه ۱۲۵ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

disableNetworkType()

chrome.networking.onc.disableNetworkType(
  networkType: NetworkType,
): void

هر دستگاهی را که با نوع شبکه مشخص‌شده مطابقت داشته باشد غیرفعال می‌کند. یادداشت مربوط به enableNetworkType را ببینید.

پارامترها

  • networkType

    NetworkType

    نوع شبکه‌ای که باید غیرفعال شود.

enableNetworkType()

chrome.networking.onc.enableNetworkType(
  networkType: NetworkType,
): void

هر دستگاهی را که با نوع شبکه مشخص‌شده مطابقت داشته باشد فعال می‌کند. توجه: این نوع ممکن است نشان‌دهنده چندین نوع شبکه باشد (مثلاً «بی‌سیم»).

پارامترها

  • networkType

    NetworkType

    نوع شبکه‌ای که باید فعال شود.

forgetNetwork()

قول 
chrome.networking.onc.forgetNetwork(
  networkGuid: string,
  callback?: function,
): Promise<void>

با پاک کردن هرگونه ویژگی پیکربندی‌شده برای شبکه با GUID networkGuid، پیکربندی شبکه را فراموش می‌کند. این ممکن است شامل هر شبکه دیگری با شناسه‌های منطبق (مثلاً SSID و امنیت WiFi) نیز باشد. اگر چنین پیکربندی‌ای وجود نداشته باشد، خطایی تنظیم می‌شود و عملیات ناموفق خواهد بود.

در جلسه‌های کیوسک، این روش نمی‌تواند پیکربندی‌های شبکه مشترک را فراموش کند.

پارامترها

  • networkGuid

    رشته

    GUID شبکه‌ای که باید فراموش شود.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    () => void

بازگشتی‌ها

  • Promise<void>

    Chrome نسخه ۱۲۵ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getCaptivePortalStatus()

قول 
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
): Promise<CaptivePortalStatus>

وضعیت درگاه مهمان را برای شبکه منطبق با «networkGuid» برمی‌گرداند.

پارامترها

  • networkGuid

    رشته

    شناسه منحصربه‌فرد سراسری شبکه برای دریافت وضعیت درگاه مهمان.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (result: CaptivePortalStatus) => void

بازگشتی‌ها

  • Chrome نسخه ۱۲۵ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getDeviceStates()

قول 
chrome.networking.onc.getDeviceStates(
  callback?: function,
): Promise<DeviceStateProperties[]>

وضعیت دستگاه‌های شبکه‌سازی دردسترس را برمی‌گرداند.

پارامترها

بازگشتی‌ها

  • Chrome نسخه ۱۲۵ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getGlobalPolicy()

قول 
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
): Promise<GlobalPolicy>

ویژگی‌های خط‌مشی جهانی را دریافت می‌کند. انتظار نمی‌رود این ویژگی‌ها درطول جلسه تغییر کند.

پارامترها

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (result: GlobalPolicy) => void

بازگشتی‌ها

  • Promise<GlobalPolicy>

    Chrome نسخه ۱۲۵ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getManagedProperties()

قول 
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
): Promise<ManagedProperties>

ویژگی‌های ادغام‌شده شبکه را با شناسه networkGuid از منابع زیر دریافت می‌کند: تنظیمات کاربر، تنظیمات هم‌رسانی‌شده، خط‌مشی کاربر، خط‌مشی دستگاه، و تنظیمات فعال کنونی.

پارامترها

  • networkGuid

    رشته

    GUID شبکه‌ای که می‌خواهید خصوصیات آن را دریافت کنید.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (result: ManagedProperties) => void

بازگشتی‌ها

  • Chrome نسخه ۱۲۵ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getNetworks()

قول 
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
): Promise<NetworkStateProperties[]>

فهرستی از اشیاء شبکه با همان ویژگی‌های ارائه‌شده توسط getState را برمی‌گرداند. فیلتری برای مشخص کردن نوع شبکه‌های برگردانده‌شده و محدود کردن تعداد شبکه‌ها ارائه شده است. شبکه‌ها براساس اولویتشان توسط سیستم مرتب می‌شوند و شبکه‌های متصل یا درحال اتصال ابتدا فهرست می‌شوند.

پارامترها

  • فیلتر کردن

    NetworkFilter

    توصیف می‌کند کدام شبکه‌ها برگردانده شوند.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (result: NetworkStateProperties[]) => void

بازگشتی‌ها

  • Chrome نسخه ۱۲۵ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getProperties()

قول 
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
): Promise<NetworkProperties>

همه ویژگی‌های شبکه را با شناسه networkGuid دریافت می‌کند. شامل همه ویژگی‌های شبکه (مقادیر فقط خواندنی و خواندن/نوشتن).

پارامترها

  • networkGuid

    رشته

    GUID شبکه‌ای که می‌خواهید خصوصیات آن را دریافت کنید.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (result: NetworkProperties) => void

بازگشتی‌ها

  • Chrome نسخه ۱۲۵ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getState()

قول 
chrome.networking.onc.getState(
  networkGuid: string,
  callback?: function,
): Promise<NetworkStateProperties>

ویژگی‌های فقط خواندنی ذخیره‌شده شبکه را با شناسه networkGuid دریافت می‌کند. این عملکرد برای داشتن عملکردی بالاتر از getProperties طراحی شده است که برای پرس‌وجو از زیرسیستم شبکه‌سازی به رفت‌وبرگشت نیاز دارد. ویژگی‌های زیر برای همه شبکه‌ها برگردانده می‌شود: GUID، نوع، نام، WiFi.Security. ویژگی‌های اضافی برای شبکه‌های قابل‌مشاهده ارائه شده است: ConnectionState،‏ ErrorState،‏ WiFi.SignalStrength،‏ Cellular.NetworkTechnology،‏ Cellular.ActivationState،‏ Cellular.RoamingState.

پارامترها

  • networkGuid

    رشته

    GUID شبکه‌ای که می‌خواهید خصوصیات آن را دریافت کنید.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    (result: NetworkStateProperties) => void

بازگشتی‌ها

  • Chrome نسخه ۱۲۵ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

requestNetworkScan()

chrome.networking.onc.requestNetworkScan(
  networkType?: NetworkType,
): void

درخواست می‌کند که زیرسیستم شبکه‌سازی شبکه‌های جدید را اسکن کند و فهرست برگردانده‌شده توسط getVisibleNetworks را به‌روز کند. این فقط یک درخواست است: زیرسیستم شبکه می‌تواند آن را نادیده بگیرد. اگر فهرست به‌روز شود، رویداد onNetworkListChanged اجرا خواهد شد.

پارامترها

  • networkType

    NetworkType اختیاری

    Chrome نسخه ۶۳ و بالاتر

    درصورت ارائه، اسکن مختص آن نوع را درخواست می‌کند. برای «شبکه تلفن همراه»، درصورت پشتیبانی، اسکن شبکه تلفن همراه درخواست خواهد شد.

setProperties()

قول 
chrome.networking.onc.setProperties(
  networkGuid: string,
  properties: NetworkConfigProperties,
  callback?: function,
): Promise<void>

ویژگی‌های شبکه را با شناسه networkGuid تنظیم می‌کند. این فقط برای شبکه‌های پیکربندی‌شده معتبر است (منبع != هیچ‌کدام). شبکه‌های قابل‌مشاهده پیکربندی‌نشده باید از createNetwork استفاده کنند. در جلسه‌های کیوسک، فراخوانی این روش در شبکه هم‌رسانی‌شده ناموفق خواهد بود.

پارامترها

  • networkGuid

    رشته

    GUID شبکه‌ای که خصوصیات برای آن تنظیم می‌شود.

  • اقامتگاه‌ها

    NetworkConfigProperties

    خصوصیت‌هایی که باید تنظیم شود.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    () => void

بازگشتی‌ها

  • Promise<void>

    Chrome نسخه ۱۲۵ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

startConnect()

قول 
chrome.networking.onc.startConnect(
  networkGuid: string,
  callback?: function,
): Promise<void>

اتصال به شبکه را با networkGuid شروع می‌کند.

پارامترها

  • networkGuid

    رشته

    GUID شبکه‌ای که باید به آن متصل شد.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    () => void

بازگشتی‌ها

  • Promise<void>

    Chrome نسخه ۱۲۵ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

startDisconnect()

قول 
chrome.networking.onc.startDisconnect(
  networkGuid: string,
  callback?: function,
): Promise<void>

قطع اتصال از شبکه را با networkGuid شروع می‌کند.

پارامترها

  • networkGuid

    رشته

    GUID شبکه‌ای که باید اتصال از آن قطع شود.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    () => void

بازگشتی‌ها

  • Promise<void>

    Chrome نسخه ۱۲۵ و بالاتر

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

رویدادها

onDeviceStateListChanged

chrome.networking.onc.onDeviceStateListChanged.addListener(
  callback: function,
)

وقتی فهرست دستگاه‌ها تغییر کرده باشد یا هرکدام از ویژگی‌های وضعیت دستگاه تغییر کرده باشد، فعال می‌شود.

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است: 

    () => void

onNetworkListChanged

chrome.networking.onc.onNetworkListChanged.addListener(
  callback: function,
)

وقتی فهرست شبکه‌ها تغییر کرده باشد، فعال می‌شود. فهرست کاملی از GUIDها را برای همه شبکه‌های فعلی ارسال می‌کند.

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است: 

    (changes: string[]) => void

    • تغییرات

      string[]

onNetworksChanged

chrome.networking.onc.onNetworksChanged.addListener(
  callback: function,
)

وقتی ویژگی‌ها در هریک از شبکه‌ها تغییر کند، فعال می‌شود. فهرستی از GUID برای شبکه‌هایی که ویژگی‌هایشان تغییر کرده است ارسال می‌کند.

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است: 

    (changes: string[]) => void

    • تغییرات

      string[]

onPortalDetectionCompleted

chrome.networking.onc.onPortalDetectionCompleted.addListener(
  callback: function,
)

وقتی شناسایی درگاه برای شبکه‌ای تکمیل شود، فعال می‌شود. شناسه یکتای سراسری شبکه و وضعیت درگاه مهمان مربوطه را ارسال می‌کند.

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است: 

    (networkGuid: string, status: CaptivePortalStatus) => void