chrome.networking.onc

الوصف

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

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

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

الأذونات

networking.onc

مدى التوفّر

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

الأنواع

ActivationStateType

Enum

"مفعَّل"

جارٍ التفعيل

"NotActivated"

"PartiallyActivated"

CaptivePortalStatus

Enum

"غير معروف"

"غير متصل"

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

"البوابة"

"ProxyAuthRequired"

CellularProperties

الخصائص

  • ActivationState

    ActivationStateType اختياري

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

  • ActivationType

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

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

  • AllowRoaming

    boolean اختياري

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

  • AutoConnect

    boolean اختياري

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

  • Family

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

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

  • FirmwareRevision

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

    إصدار البرامج الثابتة المحمَّل في مودم شبكة الجوّال

  • FoundNetworks

    FoundNetworkProperties[] اختياري

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

  • HardwareRevision

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

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

  • HomeProvider

    CellularProviderProperties اختيارية

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

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

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

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

  • ModelID

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

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

  • NetworkTechnology

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

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

  • PaymentPortal

    PaymentPortal اختياري

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

  • RoamingState

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

    حالة التجوال لجهاز المودم الخلوي على الشبكة الحالية

  • SIMLockStatus

    SIMLockStatus اختياري

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

  • SIMPresent

    boolean اختياري

    تُستخدَم لتحديد ما إذا كانت شريحة SIM متوفرة.

  • جارٍ البحث

    boolean اختياري

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

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

  • ServingOperator

    CellularProviderProperties اختيارية

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

  • SignalStrength

    number اختياري

    تمثّل هذه السمة قوة إشارة الشبكة الحالية.

  • SupportNetworkScan

    boolean اختياري

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

CellularProviderProperties

الخصائص

  • الرمز

    سلسلة

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

  • البلد

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

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

  • الاسم

    سلسلة

    اسم مشغّل شبكة الجوّال

CellularStateProperties

الخصائص

CertificatePattern

الخصائص

  • EnrollmentURI

    string[] اختياري

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

  • جهة الإصدار

    ‫IssuerSubjectPattern اختياري

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

  • IssuerCARef

    string[] اختياري

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

  • الموضوع

    ‫IssuerSubjectPattern اختياري

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

ClientCertificateType

Enum

"Ref"

"Pattern"

ConnectionStateType

Enum

"متصل"

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

"NotConnected"

DeviceStateProperties

الخصائص

  • SIMLockStatus

    SIMLockStatus اختياري

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

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

  • SIMPresent

    boolean اختياري

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

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

  • جارٍ البحث

    boolean اختياري

    تحديد ما إذا كان الجهاز مفعّلاً تعرض القيمة "صحيح" إذا كان الجهاز يجري عملية فحص حاليًا.

  • الحالة

    DeviceStateType

    تعرض هذه السمة الحالة الحالية للجهاز.

  • النوع

    NetworkType

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

DeviceStateType

Enum

"لم تتم تهيئته"
الجهاز متاح ولكن لم تتم تهيئته.

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

"تفعيل"
تم طلب التفعيل ولكن لم يتم إكماله.

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

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

EAPProperties

الخصائص

  • AnonymousIdentity

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

  • ClientCertPKCS11Id

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

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

    CertificatePattern اختيارية

  • ClientCertProvisioningProfileId

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

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

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

  • ClientCertType

    ClientCertificateType

  • الهوية

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

  • الداخلية

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

  • الخارجي

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

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

  • كلمة المرور

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

  • SaveCredentials

    boolean اختياري

  • ServerCAPEMs

    string[] اختياري

  • ServerCARefs

    string[] اختياري

  • SubjectMatch

    ManagedDOMString اختياري

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

    boolean اختياري

  • UseSystemCAs

    boolean اختياري

EthernetProperties

الخصائص

  • المصادقة

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

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

  • AutoConnect

    boolean اختياري

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

  • EAP

    EAPProperties اختيارية

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

EthernetStateProperties

الخصائص

FoundNetworkProperties

الخصائص

  • LongName

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

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

  • NetworkId

    سلسلة

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

  • ShortName

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

    تمثّل هذه السمة الاسم المختصر لمشغّل الشبكة.

  • الحالة

    سلسلة

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

  • تكنولوجيا

    سلسلة

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

GlobalPolicy

الخصائص

  • AllowOnlyPolicyNetworksToAutoconnect

    boolean اختياري

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

  • AllowOnlyPolicyNetworksToConnect

    boolean اختياري

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

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    boolean اختياري

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

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

  • BlockedHexSSIDs

    string[] اختياري

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

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

IPConfigProperties

الخصائص

  • ExcludedRoutes

    string[] اختياري

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

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

  • البوابة

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

    عنوان البوابة المستخدَم في إعدادات بروتوكول الإنترنت.

  • IPAddress

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

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

  • IncludedRoutes

    string[] اختياري

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

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

  • NameServers

    string[] اختياري

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

  • RoutingPrefix

    number اختياري

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

  • SearchDomains

    string[] اختياري

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

    مصفوفة سلاسل لحلّ الأسماء، راجِع onc_spec.md للحصول على التفاصيل.

  • النوع

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

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

  • WebProxyAutoDiscoveryUrl

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

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

IPConfigType

Enum

"DHCP"

"Static"

IssuerSubjectPattern

الخصائص

  • CommonName

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

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

  • منطقة محلية

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

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

  • المؤسسة

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

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

  • OrganizationalUnit

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

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

ManagedBoolean

الخصائص

  • نشِط

    boolean اختياري

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

  • DeviceEditable

    boolean اختياري

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

  • DevicePolicy

    boolean اختياري

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

  • فعّال

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

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

  • SharedSetting

    boolean اختياري

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

  • UserEditable

    boolean اختياري

    تُستخدَم لتحديد ما إذا كانت هناك UserPolicy للمكان المخصّص للاستئجار تسمح بتعديله (أي أنّ السياسة تحدّد قيمة الخاصية المقترَحة). القيمة التلقائية هي false.

  • UserPolicy

    boolean اختياري

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

  • UserSetting

    boolean اختياري

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

ManagedCellularProperties

الخصائص

ManagedDOMString

الخصائص

  • نشِط

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

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

  • DeviceEditable

    boolean اختياري

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

  • DevicePolicy

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

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

  • فعّال

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

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

  • SharedSetting

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

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

  • UserEditable

    boolean اختياري

    تُستخدَم لتحديد ما إذا كانت هناك UserPolicy للمكان المخصّص للاستئجار تسمح بتعديله (أي أنّ السياسة تحدّد قيمة الخاصية المقترَحة). القيمة التلقائية هي false.

  • UserPolicy

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

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

  • UserSetting

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

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

ManagedDOMStringList

الخصائص

  • نشِط

    string[] اختياري

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

  • DeviceEditable

    boolean اختياري

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

  • DevicePolicy

    string[] اختياري

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

  • فعّال

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

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

  • SharedSetting

    string[] اختياري

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

  • UserEditable

    boolean اختياري

    تُستخدَم لتحديد ما إذا كانت هناك UserPolicy للمكان المخصّص للاستئجار تسمح بتعديله (أي أنّ السياسة تحدّد قيمة الخاصية المقترَحة). القيمة التلقائية هي false.

  • UserPolicy

    string[] اختياري

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

  • UserSetting

    string[] اختياري

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

ManagedEthernetProperties

الخصائص

ManagedIPConfigProperties

الخصائص

ManagedIPConfigType

الخصائص

  • نشِط

    IPConfigType اختياري

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

  • DeviceEditable

    boolean اختياري

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

  • DevicePolicy

    IPConfigType اختياري

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

  • فعّال

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

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

  • SharedSetting

    IPConfigType اختياري

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

  • UserEditable

    boolean اختياري

    تُستخدَم لتحديد ما إذا كانت هناك UserPolicy للمكان المخصّص للاستئجار تسمح بتعديله (أي أنّ السياسة تحدّد قيمة الخاصية المقترَحة). القيمة التلقائية هي false.

  • UserPolicy

    IPConfigType اختياري

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

  • UserSetting

    IPConfigType اختياري

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

ManagedLong

الخصائص

  • نشِط

    number اختياري

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

  • DeviceEditable

    boolean اختياري

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

  • DevicePolicy

    number اختياري

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

  • فعّال

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

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

  • SharedSetting

    number اختياري

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

  • UserEditable

    boolean اختياري

    تُستخدَم لتحديد ما إذا كانت هناك UserPolicy للمكان المخصّص للاستئجار تسمح بتعديله (أي أنّ السياسة تحدّد قيمة الخاصية المقترَحة). القيمة التلقائية هي false.

  • UserPolicy

    number اختياري

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

  • UserSetting

    number اختياري

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

ManagedManualProxySettings

الخصائص

ManagedProperties

الخصائص

ManagedProxyLocation

الخصائص

ManagedProxySettings

الخصائص

ManagedProxySettingsType

الخصائص

  • نشِط

    ProxySettingsType اختياري

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

  • DeviceEditable

    boolean اختياري

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

  • DevicePolicy

    ProxySettingsType اختياري

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

  • فعّال

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

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

  • SharedSetting

    ProxySettingsType اختياري

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

  • UserEditable

    boolean اختياري

    تُستخدَم لتحديد ما إذا كانت هناك UserPolicy للمكان المخصّص للاستئجار تسمح بتعديله (أي أنّ السياسة تحدّد قيمة الخاصية المقترَحة). القيمة التلقائية هي false.

  • UserPolicy

    ProxySettingsType اختياري

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

  • UserSetting

    ProxySettingsType اختياري

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

ManagedThirdPartyVPNProperties

الخصائص

ManagedVPNProperties

الخصائص

ManagedWiFiProperties

الخصائص

ManualProxySettings

الخصائص

  • FTPProxy

    ProxyLocation اختياري

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

  • HTTPProxy

    ProxyLocation اختياري

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

  • جوارب

    ProxyLocation اختياري

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

  • SecureHTTPProxy

    ProxyLocation اختياري

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

NetworkConfigProperties

الخصائص

NetworkFilter

الخصائص

  • تم إعداده

    boolean اختياري

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

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

    number اختياري

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

  • networkType

    NetworkType

    تمثّل هذه السمة نوع الشبكات المطلوب عرضها.

  • مرئي

    boolean اختياري

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

NetworkProperties

الخصائص

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

    CellularProperties اختيارية

    بالنسبة إلى شبكات الجوّال، يتم عرض خصائص شبكة الجوّال.

  • قابلة للربط

    boolean اختياري

    تُستخدَم لتحديد ما إذا كان يمكن الاتصال بالشبكة.

  • ConnectionState

    ConnectionStateType اختياري

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

  • ErrorState

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

    تعرض هذه السمة آخر حالة مسجَّلة لخطأ في الشبكة.

  • إيثرنت

    EthernetProperties اختيارية

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

  • GUID

    سلسلة

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

  • IPAddressConfigType

    IPConfigType اختياري

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

  • IPConfigs

    ‫IPConfigProperties[] اختياري

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

  • MacAddress

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

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

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

    boolean اختياري

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

    تُستخدَم لتحديد ما إذا كانت الشبكة تفرض تكلفة استخدام.

  • الاسم

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

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

  • NameServersConfigType

    IPConfigType اختياري

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

  • الأولوية

    number اختياري

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

  • ProxySettings

    ProxySettings اختيارية

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

  • RestrictedConnectivity

    boolean اختياري

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

  • SavedIPConfig

    IPConfigProperties اختيارية

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

  • المصدر

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

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

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

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

  • StaticIPConfig

    IPConfigProperties اختيارية

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

  • TrafficCounterResetTime

    number اختياري

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

    تاريخ آخر إعادة ضبط لعدّادات حركة بيانات الشبكة

  • النوع

    NetworkType

    نوع الشبكة

  • شبكة VPN

    ‫VPNProperties اختيارية

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

  • Wi-Fi

    WiFiProperties اختيارية

    بالنسبة إلى شبكات Wi-Fi، تمثّل هذه السمة خصائص شبكة Wi-Fi.

NetworkStateProperties

الخصائص

NetworkType

Enum

"الكل"

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

"إيثرنت"

‫"Tether"

"VPN"

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

"WiFi"

PaymentPortal

الخصائص

  • الطريقة

    سلسلة

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

  • PostData

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

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

  • عنوان URL

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

    تمثّل هذه السمة عنوان URL لبوابة الدفع.

ProxyLocation

الخصائص

  • المضيف

    سلسلة

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

  • المنفذ

    الرقم

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

ProxySettings

الخصائص

  • ExcludeDomains

    string[] اختياري

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

  • يدوي

    ManualProxySettings اختيارية

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

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

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

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

  • النوع

    ProxySettingsType

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

ProxySettingsType

Enum

"Direct"

"يدوي"

"PAC"

"WPAD"

SIMLockStatus

الخصائص

  • LockEnabled

    قيمة منطقية

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

  • LockType

    سلسلة

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

  • RetriesLeft

    number اختياري

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

ThirdPartyVPNProperties

الخصائص

  • ExtensionID

    سلسلة

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

  • ProviderName

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

    تمثّل هذه السمة اسم مقدّم خدمة VPN.

VPNProperties

الخصائص

  • AutoConnect

    boolean اختياري

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

  • المضيف

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

    مضيف شبكة VPN

  • النوع

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

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

VPNStateProperties

الخصائص

WiFiProperties

الخصائص

  • AllowGatewayARPPolling

    boolean اختياري

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

    تمت إزالة هذه الميزة في الإصدار M131. ما مِن استطلاع ARP نشط الآن.

  • AutoConnect

    boolean اختياري

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

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

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

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

  • EAP

    EAPProperties اختيارية

    خصائص برنامج استخدام واجهة برمجة التطبيقات قبل إطلاقها على الشبكة مطلوب لشبكتَي WEP-8021X وWPA-EAP.

  • معدّل التكرار

    number اختياري

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

  • FrequencyList

    number[] اختيارية

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

  • HexSSID

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

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

  • HiddenSSID

    boolean اختياري

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

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

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

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

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

  • RoamThreshold

    number اختياري

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

  • SSID

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

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

  • الأمان

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

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

  • SignalStrength

    number اختياري

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

WiFiStateProperties

الخصائص

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

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

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

  • معدّل التكرار

    number اختياري

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

  • HexSSID

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

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

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

  • SSID

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

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

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

  • الأمان

    سلسلة

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

  • SignalStrength

    number اختياري

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

WiMAXProperties

الخصائص

  • AutoConnect

    boolean اختياري

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

  • EAP

    EAPProperties اختيارية

    خصائص برنامج استخدام واجهة برمجة التطبيقات قبل إطلاقها على الشبكة

الطُرق

createNetwork()

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

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

المعلمات

  • مشترَكة

    قيمة منطقية

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

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

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

  • callback

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

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

    (result: string) => void

    • نتيجة

      سلسلة

المرتجعات

  • Promise<string>

    الإصدار 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()

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

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

getCaptivePortalStatus()

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • callback

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

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

    (result: CaptivePortalStatus) => void

المرتجعات

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

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

getDeviceStates()

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

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

المعلمات

المرتجعات

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

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

getGlobalPolicy()

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

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

المعلمات

  • callback

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

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

    (result: GlobalPolicy) => void

المرتجعات

  • Promise<GlobalPolicy>

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

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

getManagedProperties()

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • callback

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

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

    (result: ManagedProperties) => void

المرتجعات

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

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

getNetworks()

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

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

المعلمات

  • تصفية

    NetworkFilter

    توضّح هذه السمة الشبكات التي سيتم عرضها.

  • callback

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

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

    (result: NetworkStateProperties[]) => void

المرتجعات

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

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

getProperties()

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • callback

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

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

    (result: NetworkProperties) => void

المرتجعات

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

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

getState()

الوعد 
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

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

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

    (result: NetworkStateProperties) => void

المرتجعات

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

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

requestNetworkScan()

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

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

المعلمات

  • networkType

    NetworkType اختياري

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

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

setProperties()

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

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

المعلمات

  • networkGuid

    سلسلة

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

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

startConnect()

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

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

المعلمات

  • networkGuid

    سلسلة

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

startDisconnect()

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

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

المعلمات

  • networkGuid

    سلسلة

    المعرّف الفريد العام (GUID) للشبكة التي سيتم قطع الاتصال بها.

  • callback

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

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

    () => void

المرتجعات

  • Promise<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