chrome.networking.onc

الوصف

تُستخدَم واجهة برمجة التطبيقات chrome.networking.onc لضبط عمليات الاتصال بالشبكة (شبكة الجوّال أو إيثرنت أو شبكة VPN أو Wi-Fi). تتوفّر واجهة برمجة التطبيقات هذه في جلسات Kiosk التي يتم تشغيلها تلقائيًا على نظام التشغيل ChromeOS.

يتم تحديد إعدادات اتصال الشبكة وفقًا لمواصفات إعدادات الشبكة المفتوحة (ONC).

ملاحظة: تستخدم معظم سمات القاموس وقيم النماذج المحدّدة UpperCamelCase لمطابقة مواصفات ONC بدلاً من اصطلاح JavaScript lowerCamelCase.

الأذونات

networking.onc

مدى التوفّر

Chrome 59 والإصدارات الأحدث نظام التشغيل ChromeOS فقط

الأنواع

ActivationStateType

التعداد

"تم تفعيله"

"جارٍ تفعيل"

"NotActivated"

"PartiallyActivated"

CaptivePortalStatus

التعداد

"غير معروف"

"غير متصل بالإنترنت"

"على الإنترنت"

"البوابة"

"ProxyAuthRequired"

CellularProperties

أماكن إقامة

  • ActivationState

    ‫ActivationStateType اختياري

    حالة تفعيل حساب مشغّل شبكة الجوَّال

  • ActivationType

    سلسلة اختيارية

    نوع تفعيل شبكة الجوّال

  • AllowRoaming

    منطقي اختياري

    تشير إلى ما إذا كان يُسمح بالتجوال على الشبكة.

  • AutoConnect

    منطقي اختياري

    ما إذا كان يجب الاتصال بشبكة الجوّال تلقائيًا (عندما تكون ضمن النطاق)

  • Family

    سلسلة اختيارية

    عائلة تكنولوجيا الأجهزة الجوّالة: CDMA أو GSM

  • FirmwareRevision

    سلسلة اختيارية

    تم تحميل نسخة البرامج الثابتة في المودم الخلوي.

  • FoundNetworks

    FoundNetworkProperties[] اختياري

    قائمة الشبكات التي تم العثور عليها أثناء عملية فحص الشبكة الأخيرة

  • HardwareRevision

    سلسلة اختيارية

    تشير إلى المراجعة لجهاز المودم الخلوي.

  • HomeProvider

    ‫CellularProviderProperties اختيارية

    معلومات عن مشغّل شبكة الجوّال الذي أصدر شريحة SIM المثبّتة حاليًا في المودم

  • الشركة المصنِّعة

    سلسلة اختيارية

    الشركة المصنّعة للمودم الخلوي

  • ModelID

    سلسلة اختيارية

    رقم تعريف طراز المودم الخلوي

  • NetworkTechnology

    سلسلة اختيارية

    إذا كان المودم مسجَّلاً على شبكة، تكون تقنية الشبكة المستخدَمة حاليًا.

  • PaymentPortal

    ‫PaymentPortal اختياري

    بوابة دفع على الإنترنت يمكن للمستخدم استخدامها للاشتراك في خطة بيانات الجوّال أو تعديلها

  • RoamingState

    سلسلة اختيارية

    حالة التجوال في مودم شبكة الجوّال على الشبكة الحالية

  • SIMLockStatus

    ‫SIMLockStatus اختياري

    حالة قفل شريحة SIM لشبكات GSM العائلية

  • SIMPresent

    منطقي اختياري

    ما إذا كانت شريحة SIM متوفّرة

  • جارٍ البحث

    منطقي اختياري

    Chrome 63 والإصدارات الأحدث

    صحيح عندما يكون فحص الشبكة الجوّالة قيد التقدّم.

  • 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 62 والإصدارات الأحدث

    حالة قفل شريحة SIM إذا كان Type = Cellular وSIMPresent = True.

  • SIMPresent

    منطقي اختياري

    Chrome 62 والإصدارات الأحدث

    اضبط الحالة على "شريحة SIM متوفّرة" إذا كان نوع الجهاز هو "شبكة الجوّال".

  • جارٍ البحث

    منطقي اختياري

    حدِّد ما إذا كان الجهاز مفعّلاً. صحيح إذا كان الجهاز يمسح ضوئيًا حاليًا.

  • الحالة

    DeviceStateType

    الحالة الحالية للجهاز

  • النوع

    NetworkType

    نوع الشبكة المرتبطة بالجهاز (شبكة الجوّال أو إيثرنت أو Wi-Fi)

DeviceStateType

التعداد

"لم يتمّ إعداده"
الجهاز متاح ولكنّه لم يتمّ إعداده.

"غير مفعَّل"
تم إعداد الجهاز ولكنّه غير مفعَّل.

"جارٍ التفعيل"
تم طلب حالة "مفعَّل" ولكنّها لم تكتمل.

"مفعَّل"
تم تفعيل الجهاز.

"محظور"
الجهاز محظور.

EAPProperties

أماكن إقامة

  • AnonymousIdentity

    سلسلة اختيارية

  • ClientCertPKCS11Id

    سلسلة اختيارية

    الإصدار 60 من Chrome والإصدارات الأحدث
  • ClientCertPattern

    ‫CertificatePattern اختياري

  • ClientCertProvisioningProfileId

    سلسلة اختيارية

    Chrome 93 والإصدارات الأحدث
  • ClientCertRef

    سلسلة اختيارية

  • ClientCertType

    ClientCertificateType

  • الهوية

    سلسلة اختيارية

  • داخلي

    سلسلة اختيارية

  • خارجي

    سلسلة اختيارية

    نوع EAP الخارجي مطلوب من قِبل ONC، ولكن قد لا يتم توفيره عند الترجمة من Shill.

  • كلمة المرور

    سلسلة اختيارية

  • SaveCredentials

    منطقي اختياري

  • ServerCAPEMs

    سلسلة اختيارية

  • ServerCARefs

    سلسلة اختيارية

  • SubjectMatch

    ‫ManagedDOMString اختياري

    الإصدار 60 من Chrome والإصدارات الأحدث
  • UseProactiveKeyCaching

    منطقي اختياري

  • UseSystemCAs

    منطقي اختياري

EthernetProperties

أماكن إقامة

  • المصادقة

    سلسلة اختيارية

    المصادقة المستخدَمة من قِبل شبكة إيثرنت القيم المحتمَلة هي None و8021X.

  • AutoConnect

    منطقي اختياري

    ما إذا كان يجب الاتصال بشبكة Ethernet تلقائيًا

  • EAP

    ‫EAPProperties اختيارية

    إعدادات بروتوكول EAP للشبكة مطلوب لمصادقة 8021X.

EthernetStateProperties

أماكن إقامة

FoundNetworkProperties

أماكن إقامة

  • LongName

    سلسلة اختيارية

    اسم مشغّل الشبكة بالتنسيق الطويل.

  • NetworkId

    سلسلة

    رقم تعريف الشبكة

  • ShortName

    سلسلة اختيارية

    الاسم المختصر لمشغّل الشبكة

  • الحالة

    سلسلة

    مدى توفّر الشبكة

  • تكنولوجيا

    سلسلة

    تكنولوجيا الوصول المستخدَمة من قِبل الشبكة

GlobalPolicy

أماكن إقامة

  • AllowOnlyPolicyNetworksToAutoconnect

    منطقي اختياري

    إذا كان هذا الخيار صحيحًا، يمكن للشبكات الخاضعة للسياسة فقط الاتصال تلقائيًا. القيمة التلقائية هي false.

  • AllowOnlyPolicyNetworksToConnect

    منطقي اختياري

    إذا كانت القيمة "صحيح"، يمكن الاتصال بشبكات السياسات فقط ولا يمكن إضافة شبكات جديدة أو ضبطها. القيمة التلقائية هي false.

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    منطقي اختياري

    الإصدار 70 من Chrome والإصدارات الأحدث

    إذا كان هذا الحقل صحيحًا وكانت هناك شبكة مُدارة متوفّرة في قائمة الشبكات المرئية، يمكن الاتصال بشبكات السياسات فقط ولا يمكن إضافة شبكات جديدة أو ضبطها. القيمة التلقائية هي false.

  • BlockedHexSSIDs

    سلسلة اختيارية

    الإصدار 86 من Chrome والإصدارات الأحدث

    قائمة الشبكات المحظورة يُحظر الاتصال بالشبكات المحظورة. يمكن إزالة حظر الشبكات مرة أخرى من خلال تحديد إعدادات شبكة صريحة. يتم ضبط هذه الخاصية تلقائيًا على قائمة فارغة.

IPConfigProperties

أماكن إقامة

  • ExcludedRoutes

    سلسلة اختيارية

    Chrome 76 والإصدارات الأحدث

    صفيف من مجموعات عناوين IP بتدوين نظام ترقيم الإنترنت المخصّص للشبكات (CIDR)، اطّلِع على onc_spec.md لمعرفة التفاصيل.

  • البوابة

    سلسلة اختيارية

    عنوان البوابة المستخدَم لإعدادات IP.

  • IPAddress

    سلسلة اختيارية

    عنوان IP للاتصال يمكن أن يكون عنوان IPv4 أو IPv6، استنادًا إلى قيمة Type.

  • IncludedRoutes

    سلسلة اختيارية

    Chrome 76 والإصدارات الأحدث

    صفيف من مجموعات عناوين IP بتدوين نظام ترقيم الإنترنت المخصّص للشبكات (CIDR)، اطّلِع على onc_spec.md لمعرفة التفاصيل.

  • NameServers

    سلسلة اختيارية

    صفيف العناوين المستخدَمة لخوادم الأسماء

  • RoutingPrefix

    رقم اختياري

    بادئة التوجيه

  • SearchDomains

    سلسلة اختيارية

    Chrome 76 والإصدارات الأحدث

    صفيف من السلاسل لتحديد الأسماء، يُرجى الاطّلاع على onc_spec.md للاطّلاع على التفاصيل.

  • النوع

    سلسلة اختيارية

    نوع إعدادات عنوان IP يمكن أن يكون IPv4 أو IPv6.

  • WebProxyAutoDiscoveryUrl

    سلسلة اختيارية

    عنوان URL لبروتوكول اكتشاف الخادم الوكيل للويب تلقائيًا، كما تم الإبلاغ عنه عبر بروتوكول DHCP

IPConfigType

التعداد

"DHCP"

"ثابت"

IssuerSubjectPattern

أماكن إقامة

  • CommonName

    سلسلة اختيارية

    في حال ضبطها، هي القيمة التي تتم مطابقتها مع الاسم الشائع لموضوع الشهادة.

  • منطقة محلية

    سلسلة اختيارية

    في حال ضبط هذه القيمة، يجب أن تتطابق مع الموقع الجغرافي الشائع لموضوع الشهادة.

  • المؤسسة

    سلسلة اختيارية

    في حال ضبطها، هي القيمة التي يتم مطابقة المؤسسات التي يملكها صاحب الشهادة معها. يجب أن تتطابق قيمة مع مؤسسة واحدة على الأقل.

  • OrganizationalUnit

    سلسلة اختيارية

    في حال ضبطها، هي القيمة التي تتم مطابقتها مع الوحدات التنظيمية لموضوع الشهادة. يجب أن تتطابق وحدة تنظيمية واحدة على الأقل مع القيمة.

ManagedBoolean

أماكن إقامة

  • نشِط

    منطقي اختياري

    القيمة النشطة المستخدَمة حاليًا من قِبل مدير إعدادات الشبكة (مثل Shill)

  • DeviceEditable

    منطقي اختياري

    ما إذا كانت هناك سياسة جهاز للموقع الإلكتروني وتسمح بتعديله (أي أنّ السياسة قد ضبطت قيمة الموقع الإلكتروني المقترَحة). الإعداد التلقائي هو false.

  • DevicePolicy

    منطقي اختياري

    قيمة السمة المقدَّمة من سياسة الجهاز

  • فعّال

    سلسلة اختيارية

    المصدر الذي تم من خلاله تحديد قيمة السمة الفعالة.

  • SharedSetting

    منطقي اختياري

    القيمة التي تم ضبطها لجميع مستخدمي الجهاز لا يتم تقديمها إلا إذا كانت قيمة DeviceEditiable هي true.

  • UserEditable

    منطقي اختياري

    ما إذا كانت هناك سياسة مستخدِم للموقع تسمح بتعديله (أي أنّ السياسة قد ضبطت قيمة الموقع المقترَحة). الإعداد التلقائي هو false.

  • UserPolicy

    منطقي اختياري

    قيمة السمة المقدَّمة من سياسة المستخدِم

  • UserSetting

    منطقي اختياري

    قيمة السمة التي ضبطها المستخدِم الذي سجّل الدخول لا يتم تقديمها إلا إذا كانت قيمة UserEditable هي true.

ManagedCellularProperties

أماكن إقامة

ManagedDOMString

أماكن إقامة

  • نشِط

    سلسلة اختيارية

    القيمة النشطة المستخدَمة حاليًا من قِبل مدير إعدادات الشبكة (مثل Shill)

  • DeviceEditable

    منطقي اختياري

    ما إذا كانت هناك سياسة جهاز للموقع الإلكتروني وتسمح بتعديله (أي أنّ السياسة قد ضبطت قيمة الموقع الإلكتروني المقترَحة). الإعداد التلقائي هو false.

  • DevicePolicy

    سلسلة اختيارية

    قيمة السمة المقدَّمة من سياسة الجهاز

  • فعّال

    سلسلة اختيارية

    المصدر الذي تم من خلاله تحديد قيمة السمة الفعالة.

  • SharedSetting

    سلسلة اختيارية

    القيمة التي تم ضبطها لجميع مستخدمي الجهاز لا يتم تقديمها إلا إذا كانت قيمة DeviceEditiable هي true.

  • UserEditable

    منطقي اختياري

    ما إذا كانت هناك سياسة مستخدِم للموقع تسمح بتعديله (أي أنّ السياسة قد ضبطت قيمة الموقع المقترَحة). الإعداد التلقائي هو false.

  • UserPolicy

    سلسلة اختيارية

    قيمة السمة المقدَّمة من سياسة المستخدِم

  • UserSetting

    سلسلة اختيارية

    قيمة السمة التي ضبطها المستخدِم الذي سجّل الدخول لا يتم تقديمها إلا إذا كانت قيمة UserEditable هي true.

ManagedDOMStringList

أماكن إقامة

  • نشِط

    سلسلة اختيارية

    القيمة النشطة المستخدَمة حاليًا من قِبل مدير إعدادات الشبكة (مثل Shill)

  • DeviceEditable

    منطقي اختياري

    ما إذا كانت هناك سياسة جهاز للموقع الإلكتروني وتسمح بتعديله (أي أنّ السياسة قد ضبطت قيمة الموقع الإلكتروني المقترَحة). الإعداد التلقائي هو false.

  • DevicePolicy

    سلسلة اختيارية

    قيمة السمة المقدَّمة من سياسة الجهاز

  • فعّال

    سلسلة اختيارية

    المصدر الذي تم من خلاله تحديد قيمة السمة الفعالة.

  • SharedSetting

    سلسلة اختيارية

    القيمة التي تم ضبطها لجميع مستخدمي الجهاز لا يتم تقديمها إلا إذا كانت قيمة DeviceEditiable هي true.

  • UserEditable

    منطقي اختياري

    ما إذا كانت هناك سياسة مستخدِم للموقع تسمح بتعديله (أي أنّ السياسة قد ضبطت قيمة الموقع المقترَحة). الإعداد التلقائي هو false.

  • UserPolicy

    سلسلة اختيارية

    قيمة السمة المقدَّمة من سياسة المستخدِم

  • UserSetting

    سلسلة اختيارية

    قيمة السمة التي ضبطها المستخدِم الذي سجّل الدخول لا يتم تقديمها إلا إذا كانت قيمة UserEditable هي true.

ManagedEthernetProperties

أماكن إقامة

ManagedIPConfigProperties

أماكن إقامة

ManagedIPConfigType

أماكن إقامة

  • نشِط

    ‫IPConfigType اختياري

    القيمة النشطة المستخدَمة حاليًا من قِبل مدير إعدادات الشبكة (مثل Shill)

  • DeviceEditable

    منطقي اختياري

    ما إذا كانت هناك سياسة جهاز للموقع الإلكتروني وتسمح بتعديله (أي أنّ السياسة قد ضبطت قيمة الموقع الإلكتروني المقترَحة). الإعداد التلقائي هو false.

  • DevicePolicy

    ‫IPConfigType اختياري

    قيمة السمة المقدَّمة من سياسة الجهاز

  • فعّال

    سلسلة اختيارية

    المصدر الذي تم من خلاله تحديد قيمة السمة الفعالة.

  • SharedSetting

    ‫IPConfigType اختياري

    القيمة التي تم ضبطها لجميع مستخدمي الجهاز لا يتم تقديمها إلا إذا كانت قيمة DeviceEditiable هي true.

  • UserEditable

    منطقي اختياري

    ما إذا كانت هناك سياسة مستخدِم للموقع تسمح بتعديله (أي أنّ السياسة قد ضبطت قيمة الموقع المقترَحة). الإعداد التلقائي هو false.

  • UserPolicy

    ‫IPConfigType اختياري

    قيمة السمة المقدَّمة من سياسة المستخدِم

  • UserSetting

    ‫IPConfigType اختياري

    قيمة السمة التي ضبطها المستخدِم الذي سجّل الدخول لا يتم تقديمها إلا إذا كانت قيمة UserEditable هي true.

ManagedLong

أماكن إقامة

  • نشِط

    رقم اختياري

    القيمة النشطة المستخدَمة حاليًا من قِبل مدير إعدادات الشبكة (مثل Shill)

  • DeviceEditable

    منطقي اختياري

    ما إذا كانت هناك سياسة جهاز للموقع الإلكتروني وتسمح بتعديله (أي أنّ السياسة قد ضبطت قيمة الموقع الإلكتروني المقترَحة). الإعداد التلقائي هو false.

  • DevicePolicy

    رقم اختياري

    قيمة السمة المقدَّمة من سياسة الجهاز

  • فعّال

    سلسلة اختيارية

    المصدر الذي تم من خلاله تحديد قيمة السمة الفعالة.

  • SharedSetting

    رقم اختياري

    القيمة التي تم ضبطها لجميع مستخدمي الجهاز لا يتم تقديمها إلا إذا كانت قيمة DeviceEditiable هي true.

  • UserEditable

    منطقي اختياري

    ما إذا كانت هناك سياسة مستخدِم للموقع تسمح بتعديله (أي أنّ السياسة قد ضبطت قيمة الموقع المقترَحة). الإعداد التلقائي هو false.

  • UserPolicy

    رقم اختياري

    قيمة السمة المقدَّمة من سياسة المستخدِم

  • UserSetting

    رقم اختياري

    قيمة السمة التي ضبطها المستخدِم الذي سجّل الدخول لا يتم تقديمها إلا إذا كانت قيمة UserEditable هي true.

ManagedManualProxySettings

أماكن إقامة

ManagedProperties

أماكن إقامة

ManagedProxyLocation

أماكن إقامة

ManagedProxySettings

أماكن إقامة

ManagedProxySettingsType

أماكن إقامة

  • نشِط

    ‫ProxySettingsType اختياري

    القيمة النشطة المستخدَمة حاليًا من قِبل مدير إعدادات الشبكة (مثل Shill)

  • DeviceEditable

    منطقي اختياري

    ما إذا كانت هناك سياسة جهاز للموقع الإلكتروني وتسمح بتعديله (أي أنّ السياسة قد ضبطت قيمة الموقع الإلكتروني المقترَحة). الإعداد التلقائي هو false.

  • DevicePolicy

    ‫ProxySettingsType اختياري

    قيمة السمة المقدَّمة من سياسة الجهاز

  • فعّال

    سلسلة اختيارية

    المصدر الذي تم من خلاله تحديد قيمة السمة الفعالة.

  • SharedSetting

    ‫ProxySettingsType اختياري

    القيمة التي تم ضبطها لجميع مستخدمي الجهاز لا يتم تقديمها إلا إذا كانت قيمة DeviceEditiable هي true.

  • UserEditable

    منطقي اختياري

    ما إذا كانت هناك سياسة مستخدِم للموقع تسمح بتعديله (أي أنّ السياسة قد ضبطت قيمة الموقع المقترَحة). الإعداد التلقائي هو 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

أماكن إقامة

  • تم إعداد

    منطقي اختياري

    إذا كان صحيحًا، يتم تضمين الشبكات التي تم ضبطها (حفظها) فقط. القيمة التلقائية هي "خطأ".

  • الحدّ الأقصى المسموح به

    رقم اختياري

    الحد الأقصى لعدد الشبكات المطلوب عرضها يتم ضبط القيمة تلقائيًا على 1000 في حال عدم تحديد أي قيمة. استخدِم القيمة 0 إذا لم يكن هناك حدّ أقصى.

  • networkType

    NetworkType

    نوع الشبكات المطلوب عرضها.

  • مرئي

    منطقي اختياري

    إذا كان صحيحًا، لا يتم تضمين سوى الشبكات المرئية (المتصلة جسديًا أو ضمن النطاق). القيمة التلقائية هي "خطأ".

NetworkProperties

أماكن إقامة

  • شبكة الجوّال

    ‫CellularProperties اختيارية

    بالنسبة إلى شبكات الجوّال، تكون خصائص شبكات الجوّال.

  • قابل للربط

    منطقي اختياري

    ما إذا كان بالإمكان الاتصال بالشبكة

  • ConnectionState

    ‫ConnectionStateType اختياري

    حالة الاتصال الحالية بالشبكة

  • ErrorState

    سلسلة اختيارية

    حالة الخطأ الأخير المسجَّل في الشبكة.

  • إيثرنت

    ‫EthernetProperties اختيارية

    بالنسبة إلى شبكات إيثرنت، تكون خصائص شبكة إيثرنت.

  • GUID

    سلسلة

    المعرّف الفريد العام للشبكة

  • IPAddressConfigType

    ‫IPConfigType اختياري

    نوع ضبط عنوان IP للشبكة

  • IPConfigs

    IPConfigProperties[] اختياري

    إعدادات عنوان IP للشبكة

  • MacAddress

    سلسلة اختيارية

    عنوان MAC للشبكة

  • تفرض تكلفة استخدام

    منطقي اختياري

    الإصدار 85 من Chrome والإصدارات الأحدث

    ما إذا كانت الشبكة تفرض تكلفة استخدام

  • الاسم

    سلسلة اختيارية

    اسم شبكة سهل على المستخدمين فهمه

  • NameServersConfigType

    ‫IPConfigType اختياري

    نوع إعدادات عنوان IP لخوادم الأسماء التي تستخدمها الشبكة.

  • Priority

    رقم اختياري

    أولوية الشبكة

  • ProxySettings

    ‫ProxySettings اختياري

    إعدادات الخادم الوكيل للشبكة

  • RestrictedConnectivity

    منطقي اختياري

    بالنسبة إلى الشبكة المتصلة، ما إذا كان الاتصال بالإنترنت محدودًا، مثلاً إذا كانت الشبكة محمية ببوابة أو لم تكن شبكة الجوّال مفعَّلة

  • SavedIPConfig

    ‫IPConfigProperties اختيارية

    إعدادات IP التي تم استلامها من خادم بروتوكول التهيئة الآلية للمضيفين (DHCP) قبل تطبيق إعدادات عنوان IP الثابت

  • المصدر

    سلسلة اختيارية

    يشير إلى ما إذا تم ضبط الشبكة وكيفية ضبطها. القيم المحتملة هي:

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    يتعارض العنصر None مع إنشاء رمز الإضافة، لذا يجب استخدام سلسلة لـ Source بدلاً من قائمة SourceType المحددة مسبقًا.

  • StaticIPConfig

    ‫IPConfigProperties اختيارية

    إعدادات عنوان IP الثابت للشبكة

  • TrafficCounterResetTime

    رقم اختياري

    الإصدار 125 من Chrome والإصدارات الأحدث

    وقت إعادة ضبط عدّادات عدد الزيارات آخر مرة

  • النوع

    NetworkType

    نوع الشبكة

  • شبكة VPN

    VPNProperties اختيارية

    بالنسبة إلى شبكات VPN، تكون خصائص شبكة VPN.

  • Wi-Fi

    ‫WiFiProperties اختيارية

    بالنسبة إلى شبكات Wi-Fi، تكون خصائص شبكة Wi-Fi.

NetworkStateProperties

أماكن إقامة

NetworkType

التعداد

"الكل"

"الشبكة الخلوية"

"Ethernet"

"ربط الجهاز بالشبكة"

"VPN"

"لاسلكي"

"WiFi"

PaymentPortal

أماكن إقامة

  • الطريقة

    سلسلة

    طريقة HTTP المُستخدَمة في بوابة الدفع

  • PostData

    سلسلة اختيارية

    بيانات النشر المطلوب إرسالها إلى بوابة الدفع يتم تجاهلها ما لم تكن قيمة Method هي POST.

  • عنوان URL

    سلسلة اختيارية

    عنوان URL لبوابة الدفع

ProxyLocation

أماكن إقامة

  • المضيف

    سلسلة

    مضيف عنوان IP للخادم الوكيل

  • المنفذ

    الرقم

    المنفذ الذي سيتم استخدامه للخادم الوكيل.

ProxySettings

أماكن إقامة

  • ExcludeDomains

    سلسلة اختيارية

    النطاقات والمضيفات التي يتم استبعاد إعدادات الخادم الوكيل اليدوية لها

  • يدوي

    ‫ManualProxySettings اختياري

    إعدادات الخادم الوكيل اليدوية: تُستخدَم فقط لإعدادات الخادم الوكيل في Manual.

  • لجنة العمل السياسي (PAC)

    سلسلة اختيارية

    عنوان URL لملف الإعداد التلقائي للخادم الوكيل

  • النوع

    ProxySettingsType

    نوع إعدادات الخادم الوكيل

ProxySettingsType

التعداد

"مباشر"

"دليل المستخدم"

"PAC"

"WPAD"

SIMLockStatus

أماكن إقامة

  • LockEnabled

    قيمة منطقية

    ما إذا كان قفل شريحة SIM مفعَّلاً

  • LockType

    سلسلة

    حالة قفل شريحة SIM: القيم المحتمَلة هي 'sim-pin' و'sim-puk' و''.

  • RetriesLeft

    رقم اختياري

    عدد محاولات قفل رقم التعريف الشخصي المسموح بها قبل أن يصبح رمز PUK مطلوبًا لفتح قفل شريحة SIM

ThirdPartyVPNProperties

أماكن إقامة

  • ExtensionID

    سلسلة

    رقم تعريف إضافة موفِّر شبكة VPN التابع لجهة خارجية

  • ProviderName

    سلسلة اختيارية

    اسم موفِّر شبكة VPN

VPNProperties

أماكن إقامة

  • AutoConnect

    منطقي اختياري

    ما إذا كان يجب الاتصال بشبكة VPN تلقائيًا

  • المضيف

    سلسلة اختيارية

    مضيف شبكة VPN

  • النوع

    سلسلة اختيارية

    نوع شبكة VPN لا يمكن أن يكون هذا فهرسًا بسبب L2TP-IPSec. هذا الإجراء اختياري لـ NetworkConfigProperties التي يتم تمريرها إلى setProperties التي يمكن استخدامها لضبط سمات محدّدة فقط.

VPNStateProperties

أماكن إقامة

WiFiProperties

أماكن إقامة

  • AllowGatewayARPPolling

    منطقي اختياري

    تم إيقافها نهائيًا منذ الإصدار 131 من Chrome

    تمت إزالته في الإصدار M131. لا تتوفّر حاليًا عملية فحص ARP نشطة.

  • AutoConnect

    منطقي اختياري

    ما إذا كان يجب الاتصال بشبكة Wi-Fi تلقائيًا عند الاقتراب من النطاق

  • معرّف مجموعة الخدمات الأساسية (BSSID)

    سلسلة اختيارية

    معرّف مجموعة الخدمات الأساسي (BSSID) لنقطة الوصول المرتبطة

  • EAP

    ‫EAPProperties اختيارية

    سمات بروتوكول المصادقة القابلة للتوسيع (EAP) للشبكة مطلوب لشبكتَي WEP-8021X وWPA-EAP.

  • التردد

    رقم اختياري

    تردد تشغيل خدمة Wi-Fi بالميغاهرتز. بالنسبة إلى الشبكات المتصلة، يشير ذلك إلى التردد الحالي الذي تم الاتصال بالشبكة من خلاله. بخلاف ذلك، يكون معدّل تردد أفضل وحدة أساسية للشبكة (BSS) متاحة.

  • FrequencyList

    عدد اختياري

    يحتوي على جميع ترددات التشغيل التي تم رصدها مؤخرًا لشبكة WiFi.

  • HexSSID

    سلسلة اختيارية

    نسخة بترميز HEX لمعرّف SSID للشبكة

  • HiddenSSID

    منطقي اختياري

    ما إذا كان سيتم بث معرّف SSID للشبكة

  • عبارة المرور

    سلسلة اختيارية

    Chrome 66 والإصدارات الأحدث

    عبارة المرور لاتصالات WEP/WPA/WPA2 لا يمكن ضبط هذه السمة إلا على القيمة "true"، ولن تحتوي المواقع التي يعرضها getProperties على هذه القيمة.

  • RoamThreshold

    رقم اختياري

    متوقف نهائيًا، وتم تجاهله.

  • SSID

    سلسلة اختيارية

    معرّف SSID للشبكة

  • الأمان

    سلسلة اختيارية

    نوع أمان الشبكة

  • SignalStrength

    رقم اختياري

    قوة إشارة الشبكة

WiFiStateProperties

أماكن إقامة

  • معرّف مجموعة الخدمات الأساسية (BSSID)

    سلسلة اختيارية

    يُرجى الاطّلاع على WiFiProperties.BSSID.

  • التردد

    رقم اختياري

    يُرجى الاطّلاع على WiFiProperties.Frequency.

  • HexSSID

    سلسلة اختيارية

    Chrome 62 والإصدارات الأحدث

    يُرجى الاطّلاع على WiFiProperties.HexSSID.

  • SSID

    سلسلة اختيارية

    Chrome 62 والإصدارات الأحدث

    يُرجى الاطّلاع على WiFiProperties.SSID.

  • الأمان

    سلسلة

    يُرجى الاطّلاع على WiFiProperties.Security.

  • SignalStrength

    رقم اختياري

    يُرجى الاطّلاع على WiFiProperties.SignalStrength.

WiMAXProperties

أماكن إقامة

  • AutoConnect

    منطقي اختياري

    ما إذا كان يجب الاتصال بالشبكة تلقائيًا

  • EAP

    ‫EAPProperties اختيارية

    سمات بروتوكول المصادقة القابلة للتوسيع (EAP) للشبكة

الطُرق

createNetwork()

الوعد 
chrome.networking.onc.createNetwork(
  shared: boolean,
  properties: NetworkConfigProperties,
  callback?: function,
)

تُنشئ إعدادات شبكة جديدة من المواقع. إذا كانت هناك شبكة تم ضبطها تتطابق مع الشبكة المطلوبة، لن تنجح هذه العملية. بخلاف ذلك، يتم عرض المعرّف الفريد العام للشبكة الجديدة.

المعلمات

  • تمت المشاركة

    قيمة منطقية

    إذا كان الأمر كذلك، يمكنك مشاركة إعدادات الشبكة هذه مع مستخدمين آخرين.true

    لا يظهر هذا الخيار إلا في واجهة مستخدم الويب في Chrome.* عندما تستدعي التطبيقات هذا المتغير، تكون false هي القيمة الوحيدة المسموح بها.

  • المواقع

    NetworkConfigProperties

    المواقع التي سيتم ضبط الشبكة الجديدة باستخدامها

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (result: string) => void

    • نتيجة

      سلسلة

المرتجعات

  • Promise<string>

    الإصدار 125 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى طلبات الاستدعاء.

disableNetworkType()

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

يؤدي هذا الخيار إلى إيقاف أي أجهزة تتطابق مع نوع الشبكة المحدّد. يُرجى الاطّلاع على ملاحظة enableNetworkType.

المعلمات

  • networkType

    NetworkType

    نوع الشبكة المطلوب إيقافها

enableNetworkType()

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

تفعِّل أي أجهزة تتطابق مع نوع الشبكة المحدَّد. يُرجى العِلم أنّ النوع قد يمثّل أنواع شبكات متعددة (مثل "لاسلكي").

المعلمات

  • networkType

    NetworkType

    نوع الشبكة المطلوب تفعيلها

forgetNetwork()

الوعد 
chrome.networking.onc.forgetNetwork(
  networkGuid: string,
  callback?: function,
)

لحذف إعدادات شبكة من خلال محو أيّ مواقع تم ضبطها للشبكة التي تحمل المعرّف الفريد العام networkGuid. وقد يشمل ذلك أيضًا أي شبكات أخرى تتضمّن معرّفات مطابقة (مثل معرّف SSID وأمان شبكة Wi-Fi). في حال عدم توفّر مثل هذه الإعدادات، سيتم ضبط خطأ وستتعذّر العملية.

في جلسات وضع "الكشك"، لن تتمكّن هذه الطريقة من حذف إعدادات الشبكة المشتركة.

المعلمات

  • networkGuid

    سلسلة

    المعرّف الفريد العام للشبكة المطلوب حذفها

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    الإصدار 125 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى طلبات الاستدعاء.

getCaptivePortalStatus()

الوعد 
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
)

تعرِض حالة المدخل المشروط الوصول إليه للشبكة التي تتطابق مع "networkGuid".

المعلمات

  • networkGuid

    سلسلة

    المعرّف الفريد العام للشبكة التي تريد الحصول على حالة المدخل المشروط الوصول إليه لها.

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (result: CaptivePortalStatus) => void

المرتجعات

  • الإصدار 125 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى طلبات الاستدعاء.

getDeviceStates()

الوعد 
chrome.networking.onc.getDeviceStates(
  callback?: function,
)

عرض حالات أجهزة الشبكات المتاحة

المعلمات

المرتجعات

  • الإصدار 125 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى طلبات الاستدعاء.

getGlobalPolicy()

الوعد 
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
)

تحصل على سمات السياسة الشاملة. من غير المتوقّع أن تتغيّر هذه السمات خلال جلسة.

المعلمات

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (result: GlobalPolicy) => void

المرتجعات

  • Promise<GlobalPolicy>

    الإصدار 125 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى طلبات الاستدعاء.

getManagedProperties()

الوعد 
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
)

تحصل على الخصائص المدمجة للشبكة التي تحمل رقم التعريف networkGuid من المصادر التالية: إعدادات المستخدم والإعدادات المشتركة وسياسة المستخدم وسياسة الجهاز والإعدادات النشطة حاليًا.

المعلمات

  • networkGuid

    سلسلة

    المعرّف الفريد العام للشبكة التي تريد الحصول على مواقع لها.

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (result: ManagedProperties) => void

المرتجعات

  • الإصدار 125 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى طلبات الاستدعاء.

getNetworks()

الوعد 
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
)

تعرِض هذه الدالة قائمة بعناصر الشبكة التي تتضمّن السمات نفسها المقدَّمة من getState. يتم توفير فلتر لتحديد نوع الشبكات المعروضة والحد من عددها. يرتّب النظام الشبكات حسب أولويتها، مع إدراج الشبكات المتصلة أو التي يتم ربطها أولاً.

المعلمات

المرتجعات

  • الإصدار 125 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى طلبات الاستدعاء.

getProperties()

الوعد 
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
)

تحصل على جميع مواقع الشبكة التي تحمل معرّف networkGuid. يتضمّن جميع سمات الشبكة (القيم للقراءة فقط والقراءة/الكتابة).

المعلمات

  • networkGuid

    سلسلة

    المعرّف الفريد العام للشبكة التي تريد الحصول على مواقع لها.

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (result: NetworkProperties) => void

المرتجعات

  • الإصدار 125 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى طلبات الاستدعاء.

getState()

الوعد 
chrome.networking.onc.getState(
  networkGuid: string,
  callback?: function,
)

تحصل على المواقع المتوفّرة للقراءة فقط والمخزّنة مؤقتًا للشبكة التي تحمل رقم التعريف networkGuid. ومن المفترض أن تكون هذه الوظيفة ذات أداء أعلى من getProperties، التي تتطلّب تنقلات البيانات ذهابًا وإيابًا لطلب المعلومات من النظام الفرعي للشبكة. يتم عرض السمات التالية لجميع الشبكات: GUID وType وName وWiFi.Security. يتم توفير سمات إضافية للشبكات المرئية: ConnectionState وErrorState وWiFi.SignalStrength وCellular.NetworkTechnology وCellular.ActivationState وCellular.RoamingState.

المعلمات

  • networkGuid

    سلسلة

    المعرّف الفريد العام للشبكة التي تريد الحصول على مواقع لها.

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (result: NetworkStateProperties) => void

المرتجعات

  • الإصدار 125 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى طلبات الاستدعاء.

requestNetworkScan()

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

يطلب من النظام الفرعي للشبكات البحث عن شبكات جديدة وتعديل القائمة التي يعرضها getVisibleNetworks. هذا طلب فقط: يمكن للنظام الفرعي للشبكة اختيار تجاهله. في حال تعديل القائمة، سيتم تشغيل الحدث onNetworkListChanged.

المعلمات

  • networkType

    ‫NetworkType اختياري

    Chrome 63 والإصدارات الأحدث

    في حال توفّر هذا العنصر، يطلب إجراء فحص خاص بالنوع. بالنسبة إلى شبكة الجوّال، سيتم طلب البحث عن شبكة جوّال إذا كان ذلك متاحًا.

setProperties()

الوعد 
chrome.networking.onc.setProperties(
  networkGuid: string,
  properties: NetworkConfigProperties,
  callback?: function,
)

لضبط سمات الشبكة التي تحمل رقم التعريف networkGuid. لا يكون هذا الخيار صالحًا إلا للشبكات التي تم ضبطها (Source != None). يجب أن تستخدم الشبكات المرئية غير المُعدَّة createNetwork بدلاً من ذلك. في جلسات وضع Kiosk، لن تنجح عملية استدعاء هذه الطريقة على شبكة مشترَكة.

المعلمات

  • networkGuid

    سلسلة

    المعرّف الفريد العام للشبكة المطلوب ضبط السمات لها.

  • المواقع

    NetworkConfigProperties

    الخصائص المطلوب ضبطها

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    الإصدار 125 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى طلبات الاستدعاء.

startConnect()

الوعد 
chrome.networking.onc.startConnect(
  networkGuid: string,
  callback?: function,
)

يبدأ الاتصال بالشبكة باستخدام networkGuid.

المعلمات

  • networkGuid

    سلسلة

    المعرّف الفريد العام للشبكة المطلوب الاتصال بها

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    الإصدار 125 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى طلبات الاستدعاء.

startDisconnect()

الوعد 
chrome.networking.onc.startDisconnect(
  networkGuid: string,
  callback?: function,
)

يبدأ عملية قطع الاتصال بالشبكة باستخدام networkGuid.

المعلمات

  • networkGuid

    سلسلة

    المعرّف الفريد العام للشبكة المطلوب قطع الاتصال بها

  • ردّ الاتصال

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    الإصدار 125 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى طلبات الاستدعاء.

الفعاليات

onDeviceStateListChanged

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

يتم تشغيله عند تغيير قائمة الأجهزة أو تغيير أيّ من خصائص حالة الجهاز.

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    () => void

onNetworkListChanged

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

يتم تشغيله عند تغيير قائمة الشبكات. تُرسِل هذه القيمة قائمة كاملة بأرقام التعريف الفريد لجميع الشبكات الحالية.

المعلمات

  • ردّ الاتصال

    دالة

    تظهر المَعلمة 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