chrome.networking.onc

الوصف

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

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

ملاحظة: تستخدم معظم خصائص القاموس وقيم التعداد الأحرف UpperCamelCase لمطابقة مواصفات ONC بدلاً من اصطلاح منخفضCamelCase لـ JavaScript.

الأذونات

networking.onc

مدى التوفّر

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

الأنواع

ActivationStateType

Enum

تم التفعيل

"تفعيل"

"غير مفعَّلة"

"PartiallyActivated"

CaptivePortalStatus

Enum

"غير معروف"

"بلا إنترنت"

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

"البوابة"

"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 موجودة.

  • جارٍ البحث

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

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

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

  • ServingOperator

    CellularProviderProperties اختياري

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

  • SignalStrength

    الرقم اختياري

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

  • SupportNetworkScan

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

    ما إذا كانت شبكة الجوّال تسمح بإجراء البحث أم لا.

CellularProviderProperties

أماكن إقامة

  • الرمز

    سلسلة

    معرّف شبكة الجوّال كسلسلة بسيطة من رمز بلد الجوّال وMNC (رمز شبكة الجوّال) الخاص بالشبكة.

  • البلد

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

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

  • الاسم

    سلسلة

    اسم عامل التشغيل.

CellularStateProperties

أماكن إقامة

CertificatePattern

أماكن إقامة

  • EnrollmentURI

    string[] اختيارية

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

  • جهة الإصدار

    IssuerSubjectPattern اختياري

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

  • IssuerCARef

    string[] اختيارية

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

  • الموضوع

    IssuerSubjectPattern اختياري

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

ClientCertificateType

Enum

"المرجع"

"النقش"

ConnectionStateType

Enum

"متّصلة"

"جارٍ الاتصال"

"غير متّصل"

DeviceStateProperties

أماكن إقامة

  • SIMLockStatus

    SIMLockStatus اختيارية

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

    حالة قفل شريحة SIM إذا كان "النوع" = "خلوي" و"شريحة SIM" = "صحيح".

  • SIMPresent

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

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

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

  • جارٍ البحث

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

    اضبط ما إذا كان الجهاز مفعَّلاً. True إذا كان الجهاز يجري حاليًا البحث.

  • الحالة

    DeviceStateType

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

  • النوع

    NetworkType

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

DeviceStateType

Enum

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

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

"قيد التفعيل"
تم طلب حالة التفعيل ولكن لم تكتمل العملية.

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

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

EAPProperties

أماكن إقامة

  • AnonymousIdentity

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

  • رقم تعريف ClientCertPKCS11

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

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

    CertificatePattern اختياري

  • ClientCertProvisioningProfileId

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

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

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

  • ClientCertType

    ClientCertificateType

  • الهوية

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

  • داخلي

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

  • خارجي

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

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

  • كلمة المرور

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

  • SaveCredentials

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

  • ServerCAPEMs

    string[] اختيارية

  • ServerCARefs

    string[] اختيارية

  • SubjectMatch

    ManagedDOMString اختياري

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

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

  • UseSystemCAs

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

EthernetProperties

أماكن إقامة

  • المصادقة

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

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

  • AutoConnect

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

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

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

    EAPProperties اختيارية

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

EthernetStateProperties

أماكن إقامة

FoundNetworkProperties

أماكن إقامة

  • LongName

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

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

  • NetworkId

    سلسلة

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

  • ShortName

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

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

  • الحالة

    سلسلة

    توفُّر الشبكة:

  • تكنولوجيا

    سلسلة

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

GlobalPolicy

أماكن إقامة

  • AllowOnlyPolicyNetworksToAutoconnect

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

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

  • AllowOnlyPolicyNetworksToConnect

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

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

  • AllowOnlyPolicyNetworksToConnectIfAvailable

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

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

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

  • BlockedHexSSIDs

    string[] اختيارية

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

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

IPConfigProperties

أماكن إقامة

  • ExcludedRoutes

    string[] اختيارية

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

    صفيف من كتل عناوين IP بتدوين CIDR، راجع onc_spec.md للحصول على التفاصيل.

  • البوابة

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

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

  • IPAddress

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

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

  • IncludedRoutes

    string[] اختيارية

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

    صفيف من كتل عناوين IP بتدوين CIDR، راجع onc_spec.md للحصول على التفاصيل.

  • NameServers

    string[] اختيارية

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

  • RoutingPrefix

    الرقم اختياري

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

  • SearchDomains

    string[] اختيارية

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

    مصفوفة من السلاسل لتحليل الاسم، راجع onc_spec.md لمعرفة التفاصيل.

  • النوع

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

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

  • WebProxyAutoDiscoveryUrl

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

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

IPConfigType

Enum

بروتوكول "بروتوكول التهيئة الآلية للمضيفين (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

أماكن إقامة

  • نشِط

    string[] اختيارية

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

  • DeviceEditable

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

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

  • DevicePolicy

    string[] اختيارية

    قيمة السمة التي تحدّدها سياسة الجهاز.

  • فعّال

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

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

  • SharedSetting

    string[] اختيارية

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

  • UserEditable

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

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

  • UserPolicy

    string[] اختيارية

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

  • UserSetting

    string[] اختيارية

    قيمة الموقع التي يحدّدها المستخدِم الذي سجَّل الدخول. لا يتم تقديمه إلا إذا كانت قيمة 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 optional

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

  • DeviceEditable

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

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

  • DevicePolicy

    ProxySettingsType optional

    قيمة السمة التي تحدّدها سياسة الجهاز.

  • فعّال

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

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

  • SharedSetting

    ProxySettingsType optional

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

  • UserEditable

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

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

  • UserPolicy

    ProxySettingsType optional

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

  • UserSetting

    ProxySettingsType optional

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

ManagedThirdPartyVPNProperties

أماكن إقامة

ManagedVPNProperties

أماكن إقامة

ManagedWiFiProperties

أماكن إقامة

ManualProxySettings

أماكن إقامة

  • FTPProxy

    ProxyLocation اختياري

    إعدادات الخادم الوكيل لبروتوكول نقل الملفات (FTP)

  • HTTPProxy

    ProxyLocation اختياري

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

  • جورب

    ProxyLocation اختياري

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

  • SecureHTTPProxy

    ProxyLocation اختياري

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

NetworkConfigProperties

أماكن إقامة

NetworkFilter

أماكن إقامة

  • تم الإعداد

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

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

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

    الرقم اختياري

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

  • networkType

    NetworkType

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

  • مرئي

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

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

NetworkProperties

أماكن إقامة

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

    CellularProperties اختيارية

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

  • قابلة للاتصال

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

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

  • ConnectionState

    ConnectionStateType optional

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

  • 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

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

  • StaticIPConfig

    IPConfigProperties اختيارية

    تهيئة عنوان IP الثابت للشبكة.

  • TrafficCounterResetTime

    الرقم اختياري

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

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

  • النوع

    NetworkType

    نوع الشبكة.

  • شبكة VPN

    VPNProperties اختيارية

    يشير هذا المصطلح إلى خصائص الشبكة الافتراضية الخاصة في شبكات VPN.

  • Wi-Fi

    WiFiProperties اختيارية

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

NetworkStateProperties

أماكن إقامة

NetworkType

Enum

"الكل"

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

"إيثرنت"

"التوصيل"

"شبكة VPN"

"لاسلكية"

"Wi-Fi"

PaymentPortal

أماكن إقامة

  • الطريقة

    سلسلة

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

  • PostData

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

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

  • عنوان URL

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

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

ProxyLocation

أماكن إقامة

  • المضيف

    سلسلة

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

  • المنفذ

    الرقم

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

ProxySettings

أماكن إقامة

  • ExcludeDomains

    string[] اختيارية

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

  • يدوي

    ManualProxySettings اختياري

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

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

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

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

  • النوع

    ProxySettingsType

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

ProxySettingsType

Enum

"مباشرة"

"يدوي"

"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

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

    ما إذا كان مسموحًا باستطلاع ARP للمدخل التلقائي أم لا. وتكون القيمة التلقائية هي "صحيح".

  • AutoConnect

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

    لتحديد ما إذا كان يجب الاتصال بشبكة WiFi تلقائيًا عندما تكون في النطاق.

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

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

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

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

    EAPProperties اختيارية

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

  • التردد

    الرقم اختياري

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

  • FrequencyList

    number[] اختياري

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

  • HexSSID

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

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

  • HiddenSSID

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

    ما إذا كان سيتم بث SSID للشبكة.

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

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

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

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

  • RoamThreshold

    الرقم اختياري

    متوقف، تم التجاهل.

  • SSID

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

    SSID للشبكة

  • الأمان

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

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

  • SignalStrength

    الرقم اختياري

    يشير إلى قوة إشارة الشبكة.

WiFiStateProperties

أماكن إقامة

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

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

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

  • التردد

    الرقم اختياري

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

  • HexSSID

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

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

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

  • SSID

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

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

    يمكنك الاطّلاع على 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

    • نتيجة

      سلسلة

المرتجعات

  • وعود<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. قد يشمل ذلك أيضًا أي شبكات أخرى لها معرّفات مطابِقة (مثل Wi-Fi SSID والأمان). وفي حال عدم توفّر مثل هذه الإعدادات، سيتم ضبط خطأ ولن تنجح العملية.

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

المعلمات

  • networkGuid

    سلسلة

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

getCaptivePortalStatus()

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

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

المعلمات

  • networkGuid

    سلسلة

    المعرف الفريد العام للشبكة لمعرفة حالة المدخل مقيد الوصول.

  • رد الاتصال

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

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

    (result: CaptivePortalStatus) => void

المرتجعات

  • Promise&lt;CaptivePortalStatus&gt;

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

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

getDeviceStates()

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

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

المعلمات

المرتجعات

  • Promise&lt;DeviceStateProperties[]&gt;

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

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

getGlobalPolicy()

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

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

المعلمات

  • رد الاتصال

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

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

    (result: GlobalPolicy) => void

المرتجعات

  • Promise&lt;GlobalPolicy&gt;

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

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

getManagedProperties()

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • رد الاتصال

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

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

    (result: ManagedProperties) => void

المرتجعات

  • Promise&lt;ManagedProperties&gt;

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

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

getNetworks()

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

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

المعلمات

المرتجعات

  • Promise&lt;NetworkStateProperties[]&gt;

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

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

getProperties()

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • رد الاتصال

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

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

    (result: NetworkProperties) => void

المرتجعات

  • Promise&lt;NetworkProperties&gt;

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

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

getState()

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • رد الاتصال

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

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

    (result: NetworkStateProperties) => void

المرتجعات

  • Promise&lt;NetworkStateProperties&gt;

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

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

requestNetworkScan()

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

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

المعلمات

  • networkType

    NetworkType اختياري

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

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

setProperties()

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • المواقع

    NetworkConfigProperties

    السمات التي يجب ضبطها

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

startConnect()

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

startDisconnect()

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • رد الاتصال

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

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

    () => 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

    • التغييرات

      سلسلة[]

onNetworksChanged

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

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

المعلمات

  • رد الاتصال

    دالة

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

    (changes: string[]) => void

    • التغييرات

      سلسلة[]

onPortalDetectionCompleted

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

يتم الإطلاق عند اكتمال اكتشاف المدخل للشبكة. يُرسِل المعرّف الفريد العام للشبكة وحالة البوابة المشروطة المقابلة.

المعلمات

  • رد الاتصال

    دالة

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

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