chrome.networking.onc

الوصف

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

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

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

الأذونات

networking.onc

مدى التوفّر

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

الأنواع

ActivationStateType

التعداد

CaptivePortalStatus

التعداد

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

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

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

  • جهة الإصدار

    IssuerSubjectPattern اختياري

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

  • IssuerCARef

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

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

  • الموضوع

    IssuerSubjectPattern اختياري

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

ClientCertificateType

التعداد

ConnectionStateType

التعداد

DeviceStateProperties

أماكن إقامة

  • SIMLockStatus

    SIMLockStatus اختيارية

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

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

  • SIMPresent

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

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

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

  • جارٍ الفحص

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

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

  • الحالة

    DeviceStateType

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

  • النوع

    NetworkType

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

DeviceStateType

التعداد

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

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

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

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

"محظور"
استخدام هذا الجهاز محظور.

EAPProperties

أماكن إقامة

  • AnonymousIdentity

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

  • ClientCertPKCS11Id

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

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

    CertificatePattern اختياري

  • ClientCertProvisioningProfileId

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

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

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

  • ClientCertType

    ClientCertificateType

  • الهوية

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

  • داخلي

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

  • خارجي

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

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

  • أدخِل كلمة المرور

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

  • SaveCredentials

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

  • ServerCAPEMs

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

  • ServerCARefs

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

  • SubjectMatch

    ManagedDOMString اختيارية

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

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

  • UseSystemCAs

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

EthernetProperties

أماكن إقامة

  • المصادقة

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

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

  • AutoConnect

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

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

  • EAP

    EAPProperties اختيارية

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

EthernetStateProperties

أماكن إقامة

FoundNetworkProperties

أماكن إقامة

  • LongName

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

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

  • NetworkId

    سلسلة

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

  • ShortName

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

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

  • الحالة

    سلسلة

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

  • تكنولوجيا

    سلسلة

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

GlobalPolicy

أماكن إقامة

  • AllowOnlyPolicyNetworksToAutoconnect

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

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

  • AllowOnlyPolicyNetworksToConnect

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

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

  • AllowOnlyPolicyNetworksToConnectIfAvailable

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

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

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

  • BlockedHexSSIDs

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

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

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

IPConfigProperties

أماكن إقامة

  • ExcludedRoutes

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

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

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

  • البوابة

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

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

  • IPAddress

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

    عنوان IP لإجراء الاتصال. يمكن أن يكون عنوان IPv4 أو IPv6، بناءً على قيمة Type.

  • IncludedRoutes

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

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

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

  • NameServers

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

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

  • RoutingPrefix

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

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

  • SearchDomains

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

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

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

  • النوع

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

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

  • WebProxyAutoDiscoveryUrl

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

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

IPConfigType

التعداد

"DHCP"

IssuerSubjectPattern

أماكن إقامة

  • CommonName

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

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

  • منطقة محلية

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

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

  • مؤسسة

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

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

  • OrganizationalUnit

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

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

ManagedBoolean

أماكن إقامة

  • نشِط

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

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

  • DeviceEditable

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

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

  • DevicePolicy

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

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

  • فعّال

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

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

  • SharedSetting

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

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

  • UserEditable

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

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

  • UserPolicy

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

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

  • UserSetting

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

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

ManagedCellularProperties

أماكن إقامة

ManagedDOMString

أماكن إقامة

  • نشِط

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

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

  • DeviceEditable

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

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

  • DevicePolicy

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

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

  • فعّال

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

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

  • SharedSetting

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

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

  • UserEditable

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

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

  • UserPolicy

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

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

  • UserSetting

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

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

ManagedDOMStringList

أماكن إقامة

  • نشِط

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

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

  • DeviceEditable

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

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

  • DevicePolicy

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

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

  • فعّال

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

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

  • SharedSetting

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

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

  • UserEditable

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

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

  • UserPolicy

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

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

  • UserSetting

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

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

ManagedEthernetProperties

أماكن إقامة

ManagedIPConfigProperties

أماكن إقامة

ManagedIPConfigType

أماكن إقامة

  • نشِط

    IPConfigType اختيارية

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

  • DeviceEditable

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

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

  • DevicePolicy

    IPConfigType اختيارية

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

  • فعّال

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

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

  • SharedSetting

    IPConfigType اختيارية

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

  • UserEditable

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

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

  • UserPolicy

    IPConfigType اختيارية

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

  • UserSetting

    IPConfigType اختيارية

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

ManagedLong

أماكن إقامة

  • نشِط

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

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

  • DeviceEditable

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

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

  • DevicePolicy

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

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

  • فعّال

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

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

  • SharedSetting

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

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

  • UserEditable

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

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

  • UserPolicy

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

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

  • UserSetting

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

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

ManagedManualProxySettings

أماكن إقامة

ManagedProperties

أماكن إقامة

ManagedProxyLocation

أماكن إقامة

ManagedProxySettings

أماكن إقامة

ManagedProxySettingsType

أماكن إقامة

  • نشِط

    ProxySettingsType اختيارية

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

  • DeviceEditable

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

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

  • DevicePolicy

    ProxySettingsType اختيارية

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

  • فعّال

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

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

  • SharedSetting

    ProxySettingsType اختيارية

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

  • UserEditable

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

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

  • UserPolicy

    ProxySettingsType اختيارية

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

  • UserSetting

    ProxySettingsType اختيارية

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

ManagedThirdPartyVPNProperties

أماكن إقامة

ManagedVPNProperties

أماكن إقامة

ManagedWiFiProperties

أماكن إقامة

ManualProxySettings

أماكن إقامة

  • FTPProxy

    ProxyLocation اختيارية

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

  • HTTPProxy

    ProxyLocation اختيارية

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

  • جوارب

    ProxyLocation اختيارية

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

  • SecureHTTPProxy

    ProxyLocation اختيارية

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

NetworkConfigProperties

أماكن إقامة

NetworkFilter

أماكن إقامة

  • تم الإعداد

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

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

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

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

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

  • networkType

    NetworkType

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

  • مرئي

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

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

NetworkProperties

أماكن إقامة

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

    CellularProperties اختيارية

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

  • قابلة للربط

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

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

  • ConnectionState

    ConnectionStateType اختيارية

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

  • ErrorState

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

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

  • إيثرنت

    EthernetProperties اختيارية

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

  • GUID

    سلسلة

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

  • IPAddressConfigType

    IPConfigType اختيارية

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

  • IPConfigs

    IPConfigProperties[] اختيارية

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

  • MacAddress

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

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

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

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

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

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

  • الاسم

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

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

  • NameServersConfigType

    IPConfigType اختيارية

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

  • Priority

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

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

  • ProxySettings

    ProxySettings اختيارية

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

  • RestrictedConnectivity

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

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

  • SavedIPConfig

    IPConfigProperties اختيارية

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

  • المصدر

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

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

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

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

  • StaticIPConfig

    IPConfigProperties اختيارية

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

  • TrafficCounterResetTime

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

    في انتظار المراجعة

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

  • النوع

    NetworkType

    نوع الشبكة

  • شبكة VPN

    VPNProperties اختيارية

    بالنسبة إلى شبكات VPN، تمثّل هذه السمة خصائص الشبكة الافتراضية الخاصة.

  • WiFi

    WiFiProperties اختيارية

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

NetworkStateProperties

أماكن إقامة

NetworkType

التعداد

"WiFi"

PaymentPortal

أماكن إقامة

  • الطريقة

    سلسلة

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

  • PostData

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

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

  • عنوان URL

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

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

ProxyLocation

أماكن إقامة

  • المضيف

    سلسلة

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

  • المنفذ

    الرقم

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

ProxySettings

أماكن إقامة

  • ExcludeDomains

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

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

  • يدوي

    ManualProxySettings اختيارية

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

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

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

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

  • النوع

    ProxySettingsType

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

ProxySettingsType

التعداد

"PAC"

SIMLockStatus

أماكن إقامة

  • LockEnabled

    boolean

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

  • LockType

    سلسلة

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

  • RetriesLeft

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

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

ThirdPartyVPNProperties

أماكن إقامة

  • ExtensionID

    سلسلة

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

  • ProviderName

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

    اسم مزوّد شبكة VPN.

VPNProperties

أماكن إقامة

  • AutoConnect

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

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

  • المضيف

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

    مضيف شبكة VPN.

  • النوع

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

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

VPNStateProperties

أماكن إقامة

WiFiProperties

أماكن إقامة

  • AllowGatewayARPPolling

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

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

  • AutoConnect

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

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

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

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

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

  • EAP

    EAPProperties اختيارية

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

  • التردد

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

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

  • FrequencyList

    number[] اختيارية

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

  • 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,
)

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

المَعلمات

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

    boolean

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

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

  • المواقع

    NetworkConfigProperties

    الخصائص التي سيتم استخدامها لإعداد الشبكة الجديدة.

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (result: string)=>void

    • نتيجة

      سلسلة

المرتجعات

  • وعد<string>

    في انتظار المراجعة

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

disableNetworkType()

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

لإيقاف أي أجهزة تطابق نوع الشبكة المحدَّد. اطّلِع على ملاحظة حول enableNetworkType.

المَعلمات

  • networkType

    NetworkType

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

enableNetworkType()

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

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

المَعلمات

  • networkType

    NetworkType

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

forgetNetwork()

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

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

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

المَعلمات

  • networkGuid

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

    في انتظار المراجعة

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

getCaptivePortalStatus()

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

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

المَعلمات

  • networkGuid

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (result: CaptivePortalStatus)=>void

المرتجعات

  • في انتظار المراجعة

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

getDeviceStates()

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

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

المَعلمات

المرتجعات

  • في انتظار المراجعة

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

getGlobalPolicy()

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

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

المَعلمات

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (result: GlobalPolicy)=>void

المرتجعات

  • Promise<GlobalPolicy>

    في انتظار المراجعة

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

getManagedProperties()

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

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

المَعلمات

  • networkGuid

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (result: ManagedProperties)=>void

المرتجعات

  • في انتظار المراجعة

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

getNetworks()

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

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

المَعلمات

المرتجعات

  • في انتظار المراجعة

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

getProperties()

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

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

المَعلمات

  • networkGuid

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (result: NetworkProperties)=>void

المرتجعات

  • في انتظار المراجعة

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

getState()

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

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

المَعلمات

  • networkGuid

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (result: NetworkStateProperties)=>void

المرتجعات

  • في انتظار المراجعة

    لا تتوفّر الوعود إلا في الإصدار 3 من 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

    سلسلة

    GUID للشبكة المطلوب تعيين خصائص لها.

  • المواقع

    NetworkConfigProperties

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

    في انتظار المراجعة

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

startConnect()

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

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

المَعلمات

  • networkGuid

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

    في انتظار المراجعة

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

startDisconnect()

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

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

المَعلمات

  • networkGuid

    سلسلة

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

    في انتظار المراجعة

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

فعاليات

onDeviceStateListChanged

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

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

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

onNetworkListChanged

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

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

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (changes: string[])=>void

    • التغييرات

      سلسلة[]

onNetworksChanged

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

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

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (changes: string[])=>void

    • التغييرات

      سلسلة[]

onPortalDetectionCompleted

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

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

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

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