chrome.networking.onc

الوصف

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

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

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

الأذونات

networking.onc

مدى التوفّر

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

الأنواع

ActivationStateType

Enum

"تم التفعيل"

"جارٍ التفعيل"

"NotActivated"

"PartiallyActivated"

CaptivePortalStatus

Enum

"غير معروف"

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

"Online"

"Portal"

"ProxyAuthRequired"

CellularProperties

الخصائص

  • ActivationState

    ActivationStateType اختياري

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

  • ActivationType

    string اختياري

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

  • AllowRoaming

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

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

  • AutoConnect

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

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

  • محتوى للعائلة

    string اختياري

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

  • FirmwareRevision

    string اختياري

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

  • FoundNetworks

    FoundNetworkProperties[] اختيارية

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

  • HardwareRevision

    string اختياري

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

  • HomeProvider

    CellularProviderProperties اختيارية

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

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

    string اختياري

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

  • ModelID

    string اختياري

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

  • NetworkTechnology

    string اختياري

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

  • PaymentPortal

    PaymentPortal اختياري

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

  • RoamingState

    string اختياري

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

  • SIMLockStatus

    SIMLockStatus اختيارية

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

  • SIMPresent

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

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

  • جارٍ البحث

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

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

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

  • ServingOperator

    CellularProviderProperties اختيارية

    معلومات عن المشغّل الذي تم تسجيل المودم على شبكته حاليًا

  • SignalStrength

    number اختيارية

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

  • SupportNetworkScan

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

    ما إذا كانت شبكة الجوّال تتيح المسح الضوئي

CellularProviderProperties

الخصائص

  • الرمز

    سلسلة

    رقم تعريف شبكة الجوّال كعملية دمج بسيطة لرمز البلد حيث يتم تشغيل شبكة الجوّال (MCC) ورمز شبكة الجوّال (MNC).

  • البلد

    string اختياري

    رمز البلد المكوّن من حرفَين

  • الاسم

    سلسلة

    اسم المشغّل

CellularStateProperties

الخصائص

CertificatePattern

الخصائص

  • EnrollmentURI

    string[] اختياري

    قائمة بمعرّفات الموارد المنتظمة (URI) التي يمكن توجيه المستخدم إليها في حال عدم العثور على شهادات تطابق هذا النمط.

  • جهة الإصدار

    IssuerSubjectPattern اختياري

    في حال ضبط هذا الإعداد، يتم تحديد النمط الذي يجب أن تتطابق معه إعدادات جهة إصدار شهادات X.509.

  • IssuerCARef

    string[] اختياري

    قائمة بشهادات CA لجهات إصدار الشهادات يجب أن يوقّع أحدهما على الشهادة لمطابقة هذا النمط.

  • الموضوع

    IssuerSubjectPattern اختياري

    في حال ضبط هذا الإعداد، يتم تحديد النمط الذي يجب أن تتطابق معه إعدادات موضوع معيار X.509.

ClientCertificateType

Enum

"Ref"

"النقش"

ConnectionStateType

Enum

"متصل"

"جارٍ الربط"

"NotConnected"

DeviceStateProperties

الخصائص

  • SIMLockStatus

    SIMLockStatus اختيارية

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

    حالة قفل شريحة SIM إذا كان النوع = شبكة الجوّال وSIMPresent = صحيح

  • SIMPresent

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

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

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

  • جارٍ البحث

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

    يتم ضبط هذه السمة إذا كان الجهاز مفعَّلاً. "صحيح" إذا كان الجهاز يجري مسحًا ضوئيًا حاليًا

  • ولاية

    DeviceStateType

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

  • النوع

    NetworkType

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

DeviceStateType

Enum

"غير مهيَّأ"
الجهاز متاح ولكن لم تتم تهيئته.

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

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

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

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

EAPProperties

الخصائص

  • AnonymousIdentity

    string اختياري

  • ClientCertPKCS11Id

    string اختياري

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

    CertificatePattern اختياري

  • ClientCertProvisioningProfileId

    string اختياري

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

    string اختياري

  • ClientCertType

    ClientCertificateType

  • الهوية

    string اختياري

  • داخلي

    string اختياري

  • خارجي

    string اختياري

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

  • كلمة المرور

    string اختياري

  • SaveCredentials

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

  • ServerCAPEMs

    string[] اختياري

  • ServerCARefs

    string[] اختياري

  • SubjectMatch

    ManagedDOMString اختياري

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

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

  • UseSystemCAs

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

EthernetProperties

الخصائص

  • المصادقة

    string اختياري

    المصادقة التي تستخدمها شبكة Ethernet القيمتان المحتملتان هما None و8021X.

  • AutoConnect

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

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

  • برنامج استخدام المنتج قبل إطلاقه (EAP)

    EAPProperties اختياري

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

EthernetStateProperties

الخصائص

FoundNetworkProperties

الخصائص

  • LongName

    string اختياري

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

  • NetworkId

    سلسلة

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

  • ShortName

    string اختياري

    الاسم القصير لمشغّل الشبكة

  • الحالة

    سلسلة

    توفّر الشبكة

  • تكنولوجيا

    سلسلة

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

GlobalPolicy

الخصائص

  • AllowOnlyPolicyNetworksToAutoconnect

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

    في حال ضبط السياسة على "صحيح"، يمكن فقط للشبكات التي تم ضبطها من خلال السياسة الاتصال تلقائيًا. الخيار التلقائي هو "خطأ".

  • AllowOnlyPolicyNetworksToConnect

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

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

  • AllowOnlyPolicyNetworksToConnectIfAvailable

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

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

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

  • BlockedHexSSIDs

    string[] اختياري

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

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

IPConfigProperties

الخصائص

  • ExcludedRoutes

    string[] اختياري

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

    مصفوفة من مجموعات عناوين IP في تدوين CIDR، راجِع onc_spec.md لمعرفة التفاصيل.

  • البوابة

    string اختياري

    عنوان البوابة المستخدَم لضبط عنوان IP

  • IPAddress

    string اختياري

    عنوان IP للاتصال يمكن أن يكون عنوان IPv4 أو IPv6، حسب قيمة Type.

  • IncludedRoutes

    string[] اختياري

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

    مصفوفة من مجموعات عناوين IP في تدوين CIDR، راجِع onc_spec.md لمعرفة التفاصيل.

  • NameServers

    string[] اختياري

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

  • RoutingPrefix

    number اختيارية

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

  • SearchDomains

    string[] اختياري

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

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

  • النوع

    string اختياري

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

  • WebProxyAutoDiscoveryUrl

    string اختياري

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

IPConfigType

Enum

"DHCP"

"ثابت"

IssuerSubjectPattern

الخصائص

  • CommonName

    string اختياري

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

  • منطقة محلية

    string اختياري

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

  • المؤسسة

    string اختياري

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

  • OrganizationalUnit

    string اختياري

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

ManagedBoolean

الخصائص

  • نشط

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

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

  • DeviceEditable

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

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

  • DevicePolicy

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

    قيمة السمة التي توفّرها سياسة الجهاز

  • فعّال

    string اختياري

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

  • SharedSetting

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

    القيمة المحدّدة لجميع مستخدمي الجهاز يتم توفيرها فقط إذا كانت قيمة DeviceEditiable هي true.

  • UserEditable

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

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

  • UserPolicy

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

    قيمة السمة التي توفّرها سياسة المستخدم

  • UserSetting

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

    قيمة الموقع التي حدّدها المستخدم الذي سجّل الدخول يتم توفيرها فقط إذا كانت قيمة UserEditable هي true.

ManagedCellularProperties

الخصائص

ManagedDOMString

الخصائص

  • نشط

    string اختياري

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

  • DeviceEditable

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

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

  • DevicePolicy

    string اختياري

    قيمة السمة التي توفّرها سياسة الجهاز

  • فعّال

    string اختياري

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

  • SharedSetting

    string اختياري

    القيمة المحدّدة لجميع مستخدمي الجهاز يتم توفيرها فقط إذا كانت قيمة DeviceEditiable هي true.

  • UserEditable

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

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

  • UserPolicy

    string اختياري

    قيمة السمة التي توفّرها سياسة المستخدم

  • UserSetting

    string اختياري

    قيمة الموقع التي حدّدها المستخدم الذي سجّل الدخول يتم توفيرها فقط إذا كانت قيمة UserEditable هي true.

ManagedDOMStringList

الخصائص

  • نشط

    string[] اختياري

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

  • DeviceEditable

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

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

  • DevicePolicy

    string[] اختياري

    قيمة السمة التي توفّرها سياسة الجهاز

  • فعّال

    string اختياري

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

  • SharedSetting

    string[] اختياري

    القيمة المحدّدة لجميع مستخدمي الجهاز يتم توفيرها فقط إذا كانت قيمة DeviceEditiable هي true.

  • UserEditable

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

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

  • UserPolicy

    string[] اختياري

    قيمة السمة التي توفّرها سياسة المستخدم

  • UserSetting

    string[] اختياري

    قيمة الموقع التي حدّدها المستخدم الذي سجّل الدخول يتم توفيرها فقط إذا كانت قيمة UserEditable هي true.

ManagedEthernetProperties

الخصائص

ManagedIPConfigProperties

الخصائص

ManagedIPConfigType

الخصائص

  • نشط

    IPConfigType اختياري

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

  • DeviceEditable

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

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

  • DevicePolicy

    IPConfigType اختياري

    قيمة السمة التي توفّرها سياسة الجهاز

  • فعّال

    string اختياري

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

  • SharedSetting

    IPConfigType اختياري

    القيمة المحدّدة لجميع مستخدمي الجهاز يتم توفيرها فقط إذا كانت قيمة DeviceEditiable هي true.

  • UserEditable

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

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

  • UserPolicy

    IPConfigType اختياري

    قيمة السمة التي توفّرها سياسة المستخدم

  • UserSetting

    IPConfigType اختياري

    قيمة الموقع التي حدّدها المستخدم الذي سجّل الدخول يتم توفيرها فقط إذا كانت قيمة UserEditable هي true.

ManagedLong

الخصائص

  • نشط

    number اختيارية

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

  • DeviceEditable

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

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

  • DevicePolicy

    number اختيارية

    قيمة السمة التي توفّرها سياسة الجهاز

  • فعّال

    string اختياري

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

  • SharedSetting

    number اختيارية

    القيمة المحدّدة لجميع مستخدمي الجهاز يتم توفيرها فقط إذا كانت قيمة DeviceEditiable هي true.

  • UserEditable

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

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

  • UserPolicy

    number اختيارية

    قيمة السمة التي توفّرها سياسة المستخدم

  • UserSetting

    number اختيارية

    قيمة الموقع التي حدّدها المستخدم الذي سجّل الدخول يتم توفيرها فقط إذا كانت قيمة UserEditable هي true.

ManagedManualProxySettings

الخصائص

ManagedProperties

الخصائص

ManagedProxyLocation

الخصائص

ManagedProxySettings

الخصائص

ManagedProxySettingsType

الخصائص

  • نشط

    ProxySettingsType اختياري

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

  • DeviceEditable

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

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

  • DevicePolicy

    ProxySettingsType اختياري

    قيمة السمة التي توفّرها سياسة الجهاز

  • فعّال

    string اختياري

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

  • 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".

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

    number اختيارية

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

  • networkType

    NetworkType

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

  • مرئي

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

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

NetworkProperties

الخصائص

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

    CellularProperties اختياري

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

  • يمكن ربطه

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

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

  • ConnectionState

    ConnectionStateType اختيارية

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

  • ErrorState

    string اختياري

    آخر حالة خطأ في الشبكة تم تسجيلها

  • إيثرنت

    EthernetProperties اختيارية

    بالنسبة إلى شبكات Ethernet، خصائص شبكة Ethernet

  • GUID

    سلسلة

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

  • IPAddressConfigType

    IPConfigType اختياري

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

  • IPConfigs

    ‫IPConfigProperties[] اختيارية

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

  • MacAddress

    string اختياري

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

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

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

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

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

  • الاسم

    string اختياري

    اسم شبكة سهل الاستخدام

  • NameServersConfigType

    IPConfigType اختياري

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

  • الأولوية

    number اختيارية

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

  • ProxySettings

    ProxySettings اختياري

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

  • RestrictedConnectivity

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

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

  • SavedIPConfig

    IPConfigProperties اختياري

    إعدادات IP التي تم تلقّيها من خادم DHCP قبل تطبيق إعدادات IP الثابتة

  • المصدر

    string اختياري

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

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

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

  • StaticIPConfig

    IPConfigProperties اختياري

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

  • TrafficCounterResetTime

    number اختيارية

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

    يشير هذا الحقل إلى آخر مرة تمت فيها إعادة ضبط عدّادات الزيارات.

  • النوع

    NetworkType

    نوع الشبكة

  • شبكة VPN

    VPNProperties اختياري

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

  • Wi-Fi

    WiFiProperties اختياري

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

NetworkStateProperties

الخصائص

NetworkType

Enum

"الكل"

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

"Ethernet"

"Tether"

"شبكة VPN"

"الشبكات اللاسلكية"

"شبكة Wi-Fi"

PaymentPortal

الخصائص

  • الطريقة

    سلسلة

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

  • PostData

    string اختياري

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

  • عنوان URL

    string اختياري

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

ProxyLocation

الخصائص

  • المضيف

    سلسلة

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

  • المنفذ

    الرقم

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

ProxySettings

الخصائص

  • ExcludeDomains

    string[] اختياري

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

  • يدوي

    ManualProxySettings اختيارية

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

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

    string اختياري

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

  • النوع

    ProxySettingsType

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

ProxySettingsType

Enum

"مباشر"

"يدوي"

"PAC"

"WPAD"

SIMLockStatus

الخصائص

  • LockEnabled

    قيمة منطقية

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

  • LockType

    سلسلة

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

  • RetriesLeft

    number اختيارية

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

ThirdPartyVPNProperties

الخصائص

  • ExtensionID

    سلسلة

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

  • ProviderName

    string اختياري

    اسم مقدِّم خدمات VPN

VPNProperties

الخصائص

  • AutoConnect

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

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

  • المضيف

    string اختياري

    مضيف شبكة VPN

  • النوع

    string اختياري

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

VPNStateProperties

الخصائص

WiFiProperties

الخصائص

  • AllowGatewayARPPolling

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

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

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

  • AutoConnect

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

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

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

    string اختياري

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

  • برنامج استخدام المنتج قبل إطلاقه (EAP)

    EAPProperties اختياري

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

  • التردد

    number اختيارية

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

  • FrequencyList

    number[] اختيارية

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

  • HexSSID

    string اختياري

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

  • HiddenSSID

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

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

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

    string اختياري

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

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

  • RoamThreshold

    number اختيارية

    تم إيقاف هذه السمة نهائيًا ويتم تجاهلها.

  • SSID

    string اختياري

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

  • الأمان

    string اختياري

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

  • SignalStrength

    number اختيارية

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

WiFiStateProperties

الخصائص

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

    string اختياري

    يمكنك الاطّلاع على WiFiProperties.BSSID.

  • التردد

    number اختيارية

    يمكنك الاطّلاع على WiFiProperties.Frequency.

  • HexSSID

    string اختياري

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

    يمكنك الاطّلاع على WiFiProperties.HexSSID.

  • SSID

    string اختياري

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

    يمكنك الاطّلاع على WiFiProperties.SSID.

  • الأمان

    سلسلة

    يمكنك الاطّلاع على WiFiProperties.Security.

  • SignalStrength

    number اختيارية

    يمكنك الاطّلاع على WiFiProperties.SignalStrength.

WiMAXProperties

الخصائص

  • AutoConnect

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

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

  • برنامج استخدام المنتج قبل إطلاقه (EAP)

    EAPProperties اختياري

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

الطُرق

createNetwork()

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

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

المعلمات

  • مشترَكة

    قيمة منطقية

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

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

  • أماكن الإقامة

    NetworkConfigProperties

    الخصائص التي يتم ضبط الشبكة الجديدة بها

  • callback

    function اختياري

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

    (result: string) => void

    • نتيجة

      سلسلة

المرتجعات

  • وعد<سلسلة>

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

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

disableNetworkType()

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

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

المعلمات

  • networkType

    NetworkType

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

enableNetworkType()

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

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

المعلمات

  • networkType

    NetworkType

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

forgetNetwork()

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

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

getCaptivePortalStatus()

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • callback

    function اختياري

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

    (result: CaptivePortalStatus) => void

المرتجعات

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

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

getDeviceStates()

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

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

المعلمات

المرتجعات

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

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

getGlobalPolicy()

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

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

المعلمات

  • callback

    function اختياري

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

    (result: GlobalPolicy) => void

المرتجعات

  • وعد<GlobalPolicy>

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

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

getManagedProperties()

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • callback

    function اختياري

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

    (result: ManagedProperties) => void

المرتجعات

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

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

getNetworks()

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

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

المعلمات

المرتجعات

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

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

getProperties()

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • callback

    function اختياري

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

    (result: NetworkProperties) => void

المرتجعات

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

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

getState()

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • callback

    function اختياري

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

    (result: NetworkStateProperties) => void

المرتجعات

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

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

requestNetworkScan()

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

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

المعلمات

  • networkType

    NetworkType اختيارية

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

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

setProperties()

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • أماكن الإقامة

    NetworkConfigProperties

    السمات المطلوب ضبطها

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

startConnect()

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

لبدء الاتصال بالشبكة باستخدام networkGuid

المعلمات

  • networkGuid

    سلسلة

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

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

startDisconnect()

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

الفعاليات

onDeviceStateListChanged

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

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

المعلمات

  • callback

    دالة

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

    () => void

onNetworkListChanged

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

يتم تشغيل هذا الحدث عند تغيير قائمة الشبكات. ترسل هذه الإشارة قائمة كاملة بمعرّفات GUID لجميع الشبكات الحالية.

المعلمات

  • callback

    دالة

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

    (changes: string[]) => void

    • التغييرات

      string[]

onNetworksChanged

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

يتم تنشيط هذا الحدث عند تغيير الخصائص في أي من الشبكات. يتم إرسال قائمة بمعرّفات GUID للشبكات التي تغيّرت خصائصها.

المعلمات

  • callback

    دالة

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

    (changes: string[]) => void

    • التغييرات

      string[]

onPortalDetectionCompleted

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

يتم تشغيل هذا الحدث عند اكتمال رصد المدخل المشروط الوصول إليه لشبكة معيّنة. يتم إرسال المعرّف الفريد العام للشبكة وحالة المدخل المشروط الوصول إليه المقابلة.

المعلمات

  • callback

    دالة

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

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