chrome.networking.onc

תיאור

ה-API של chrome.networking.onc משמש להגדרת חיבורי רשת (סלולרי, אתרנט, VPN או Wi-Fi). ה-API הזה זמין בסשנים של קיוסק ב-Chrome OS שמופעלים באופן אוטומטי.

הגדרות החיבור לרשת נקבעות בהתאם למפרט של Open Network Configuration (ONC) (הגדרת הרשת הפתוחה).

הערה: רוב המאפיינים של המילון וערכי ה-enum משתמשים ב-UpperCamelCase כדי להתאים למפרט ONC במקום במוסכמה של JavaScript lowerCamelCase.

הרשאות

networking.onc

זמינות

Chrome 59+ ChromeOS בלבד

סוגים

ActivationStateType

Enum

'מופעל'

"מתבצעת הפעלה"

'לא מופעל'

'מופעלת חלקית'

CaptivePortalStatus

Enum

"לא ידוע"

"אופליין"

"אונליין"

"פורטל"

"ProxyAuthrequired"

CellularProperties

מאפיינים

  • ActivationState

    ActivationStateType אופציונלי

    מצב ההפעלה של חשבון הספק.

  • ActivationType

    מחרוזת אופציונלי

    סוג ההפעלה של הרשת הסלולרית.

  • AllowRoaming

    ערך בוליאני אופציונלי

    האם הנדידה מותרת ברשת.

  • AutoConnect

    ערך בוליאני אופציונלי

    האם צריך לחבר את הרשת הסלולרית באופן אוטומטי (כשנמצאים בטווח שלה).

  • משפחתי

    מחרוזת אופציונלי

    משפחת הטכנולוגיות של מכשירים סלולריים – CDMA או GSM.

  • FirmwareRevision

    מחרוזת אופציונלי

    גרסת הקושחה נטענה במודם הסלולרי.

  • FoundNetworks

    FoundNetworkProperties [] אופציונלי

    רשימת הרשתות שנמצאו בסריקת הרשת האחרונה.

  • HardwareRevision

    מחרוזת אופציונלי

    גרסה קודמת של החומרה במודם סלולרי.

  • HomeProvider

    CellularProviderProperties אופציונלי

    מידע על המפעיל שהנפיק את כרטיס ה-SIM שמותקן כרגע במודם.

  • היצרן

    מחרוזת אופציונלי

    יצרן המודם הסלולרי.

  • ModelID

    מחרוזת אופציונלי

    מזהה הדגם של המודם הסלולרי.

  • NetworkTechnology

    מחרוזת אופציונלי

    אם המודם רשום ברשת, טכנולוגיית הרשת שנמצאת כרגע בשימוש.

  • PaymentPortal

    PaymentPortal אופציונלי

    פורטל תשלומים אונליין שהמשתמש יכול להשתמש בו כדי להירשם לחבילת גלישה או לשנות אותה.

  • RoamingState

    מחרוזת אופציונלי

    מצב הנדידה של המודם הסלולרי ברשת הנוכחית.

  • SIMLockStatus

    SIMLockStatus אופציונלי

    המצב של נעילת כרטיס ה-SIM ברשתות משפחתיות מסוג GSM.

  • SIMPresent

    ערך בוליאני אופציונלי

    האם יש כרטיס SIM.

  • סריקה

    ערך בוליאני אופציונלי

    Chrome 63+

    הערך הוא True כשמתבצעת סריקה של רשת סלולרית.

  • ServingOperator

    CellularProviderProperties אופציונלי

    מידע על המפעיל שברשת שלו המודם רשום כרגע.

  • SignalStrength

    מספר אופציונלי

    עוצמת האות הנוכחית של הרשת.

  • SupportNetworkScan

    ערך בוליאני אופציונלי

    האם הרשת הסלולרית תומכת בסריקה.

CellularProviderProperties

מאפיינים

  • קוד

    מחרוזת

    מזהה הרשת הסלולרית כשרשור פשוט של חשבון הניהול (MCC) (קוד המדינה בנייד) ו-MNC (קוד הרשת הסלולרית) של הרשת.

  • מדינה

    מחרוזת אופציונלי

    קוד מדינה בן 2 אותיות.

  • שם

    מחרוזת

    שם המפעיל.

CellularStateProperties

מאפיינים

CertificatePattern

מאפיינים

  • EnrollmentURI

    string[] אופציונלי

    רשימה של מזהי URI שאליהם אפשר להפנות את המשתמש במקרה שלא יימצאו אישורים שתואמים לדפוס הזה.

  • הונפק על ידי:

    IssuerSubjectPattern אופציונלי

    אם המדיניות מוגדרת, קו ביטול הנעילה שלפיו יש להתאים את ההגדרות של מנפיק X.509.

  • IssuerCARef

    string[] אופציונלי

    רשימה של אישורי CA של מנפיק האישורים. אישור חייב להיות חתום על ידי אחד מהם כדי להתאים לדפוס הזה.

  • Subject

    IssuerSubjectPattern אופציונלי

    אם המדיניות מוגדרת, הדפוס הזה תואם להגדרות הנושא של X.509.

ClientCertificateType

Enum

"אסמכת"

"קו ביטול נעילה"

ConnectionStateType

Enum

"מחובר"

"מתחבר"

'לא מחובר'

DeviceStateProperties

מאפיינים

  • SIMLockStatus

    SIMLockStatus אופציונלי

    Chrome 62+

    סטטוס הנעילה של כרטיס ה-SIM אם הסוג = 'סלולרי' ו-'SIMהצגה' = 'True'.

  • SIMPresent

    ערך בוליאני אופציונלי

    Chrome 62+

    הגדרה למצב הנוכחי של כרטיס ה-SIM אם סוג המכשיר הוא 'סלולרי'.

  • סריקה

    ערך בוליאני אופציונלי

    הגדרה אם המכשיר מופעל. הערך הוא True אם המכשיר מבצע סריקה כרגע.

  • מדינה

    DeviceStateType

    המצב הנוכחי של המכשיר.

  • סוג הרשת המשויכת למכשיר (סלולרי, אתרנט או Wi-Fi).

DeviceStateType

Enum

'לא מאותחל'
המכשיר זמין אבל לא מאתחל.

'מושבת'
המכשיר מופעל אבל לא מופעל.

"ההפעלה"
נשלחה בקשה למצב מופעל אבל היא לא הושלמה.

'מופעל'
המכשיר מופעל.

"אסור"
המכשיר אסור.

EAPProperties

מאפיינים

  • AnonymousIdentity

    מחרוזת אופציונלי

  • ClientCertPKCS11Id

    מחרוזת אופציונלי

    Chrome 60+
  • ClientCertPattern

    CertificatePattern אופציונלי

  • ClientCertProvisioningProfileId

    מחרוזת אופציונלי

    Chrome מגרסה 93 ואילך
  • ClientCertRef

    מחרוזת אופציונלי

  • ClientCertType

    ClientCertificateType

  • זהויות

    מחרוזת אופציונלי

  • פנימי

    מחרוזת אופציונלי

  • חיצוני

    מחרוזת אופציונלי

    סוג EAP חיצוני. נדרש על ידי ONC, אבל יכול להיות שלא מסופק בתרגום מ-Shill.

  • סיסמה

    מחרוזת אופציונלי

  • SaveCredentials

    ערך בוליאני אופציונלי

  • ServerCAPEMs

    string[] אופציונלי

  • ServerCARefs

    string[] אופציונלי

  • SubjectMatch

    ManagedDOMString אופציונלי

    Chrome 60+
  • UseProactiveKeyCaching

    ערך בוליאני אופציונלי

  • UseSystemCAs

    ערך בוליאני אופציונלי

EthernetProperties

מאפיינים

  • אימות

    מחרוזת אופציונלי

    האימות שמשמש את רשת האתרנט. הערכים האפשריים הם None ו-8021X.

  • AutoConnect

    ערך בוליאני אופציונלי

    קביעה אם יש להתחבר לרשת האתרנט באופן אוטומטי.

  • גישה מוקדמת

    EAPProperties אופציונלי

    הגדרות EAP של רשת. נדרש לאימות לפי תקן 8021X.

EthernetStateProperties

מאפיינים

FoundNetworkProperties

מאפיינים

  • LongName

    מחרוזת אופציונלי

    שם הפורמט הארוך של מפעיל הרשת.

  • NetworkId

    מחרוזת

    מזהה רשת.

  • ShortName

    מחרוזת אופציונלי

    שם הפורמט הקצר של מפעיל הרשת.

  • סטטוס

    מחרוזת

    זמינות הרשת.

  • טכנולוגיה

    מחרוזת

    טכנולוגיית הגישה שמשמשת את הרשת.

GlobalPolicy

מאפיינים

  • AllowOnlyPolicyNetworksToAutoconnect

    ערך בוליאני אופציונלי

    אם הערך הוא True, רק רשתות של מדיניות יכולות להתחבר באופן אוטומטי. ברירת המחדל היא False.

  • AllowOnlyPolicyNetworksToConnect

    ערך בוליאני אופציונלי

    אם הערך הוא True, אפשר לחבר רק רשתות למדיניות, ולא ניתן להוסיף או להגדיר רשתות חדשות. ברירת המחדל היא False.

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    ערך בוליאני אופציונלי

    Chrome 70+

    אם True ויש רשת מנוהלת זמינה ברשימת הרשתות הגלויה, ניתן לחבר רק רשתות מדיניות ולא ניתן להוסיף או להגדיר רשתות חדשות. ברירת המחדל היא False.

  • BlockedHexSSIDs

    string[] אופציונלי

    Chrome 86 ואילך

    רשימה של רשתות חסומות. אסור להתחבר לרשתות חסומות. ניתן לבטל את החסימה של רשתות שוב על ידי ציון הגדרה מפורשת של רשת. ברירת המחדל היא רשימה ריקה.

IPConfigProperties

מאפיינים

  • ExcludedRoutes

    string[] אופציונלי

    Chrome 76 ואילך

    מערך של חסימות IP בסימון CIDR. למידע נוסף אפשר לעיין ב-onc_spec.md.

  • שער

    מחרוזת אופציונלי

    כתובת השער משמשת להגדרת ה-IP.

  • IPAddress

    מחרוזת אופציונלי

    כתובת ה-IP של חיבור. אפשר להשתמש בכתובת IPv4 או IPv6, בהתאם לערך של Type.

  • IncludedRoutes

    string[] אופציונלי

    Chrome 76 ואילך

    מערך של חסימות IP בסימון CIDR. למידע נוסף אפשר לעיין ב-onc_spec.md.

  • NameServers

    string[] אופציונלי

    מערך כתובות המשמשות לשרתי שמות.

  • RoutingPrefix

    מספר אופציונלי

    הקידומת של הניתוב.

  • SearchDomains

    string[] אופציונלי

    Chrome 76 ואילך

    מערך של מחרוזות לרזולוציית שמות. אפשר למצוא פרטים נוספים ב-onc_spec.md.

  • סוג

    מחרוזת אופציונלי

    סוג ההגדרה של ה-IP. יכול להיות IPv4 או IPv6.

  • WebProxyAutoDiscoveryUrl

    מחרוזת אופציונלי

    כתובת ה-URL של גילוי אוטומטי של שרת proxy של 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 אופציונלי

    הגדרות לשרת proxy של FTP.

  • HTTPProxy

    ProxyLocation אופציונלי

    הגדרות ל-Proxy ל-HTTP.

  • רשתות חברתיות

    ProxyLocation אופציונלי

    הגדרות לשרת ה-proxy של SOCKS.

  • SecureHTTPProxy

    ProxyLocation אופציונלי

    הגדרות לשרת proxy מאובטח של HTTP.

NetworkConfigProperties

מאפיינים

NetworkFilter

מאפיינים

  • מוגדר

    ערך בוליאני אופציונלי

    אם True, יש לכלול רק רשתות מוגדרות (שמורות). ברירת המחדל היא 'false'.

  • הגבלה

    מספר אופציונלי

    מספר הרשתות המקסימלי שצריך להחזיר. אם לא צויין ערך, ערך ברירת המחדל שלו הוא 1,000. כדי לא להגדיר מגבלה, צריך להשתמש ב-0.

  • networkType

    סוג הרשת

    סוג הרשתות שצריך להחזיר.

  • גלוי

    ערך בוליאני אופציונלי

    אם True, יש לכלול רק רשתות גלויות (מחוברות פיזית או בטווח). ברירת המחדל היא 'false'.

NetworkProperties

מאפיינים

  • רשת סלולרית

    CellularProperties אופציונלי

    לרשתות סלולריות, הן מאפייני רשת סלולרית.

  • חיבור

    ערך בוליאני אופציונלי

    האם ניתן להתחבר לרשת.

  • ConnectionState

    ConnectionStateType optional

    מצב החיבור הנוכחי של הרשת.

  • ErrorState

    מחרוזת אופציונלי

    המצב האחרון שתועד של שגיאת הרשת.

  • אתרנט

    EthernetProperties אופציונלי

    לרשתות אתרנט, המאפיינים של רשת האתרנט.

  • GUID

    מחרוזת

    ה-GUID של הרשת.

  • IPAddressConfigType

    IPConfigType אופציונלי

    סוג ההגדרה של כתובת ה-IP של הרשת.

  • IPConfigs

    IPConfigProperties[] אופציונלי

    הגדרות ה-IP של הרשת.

  • MacAddress

    מחרוזת אופציונלי

    כתובת ה-MAC של הרשת.

  • נמדדת

    ערך בוליאני אופציונלי

    Chrome 85+

    האם ברשת עם חיוב לפי שימוש בנתונים.

  • שם

    מחרוזת אופציונלי

    שם רשת ידידותי למשתמש.

  • NameServersConfigType

    IPConfigType אופציונלי

    סוג התצורה של כתובת ה-IP עבור שרתי השמות שמשמשים את הרשת.

  • עדיפות

    מספר אופציונלי

    עדיפות הרשת.

  • ProxySettings

    ProxySettings (הגדרות שרת Proxy) אופציונלי

    הגדרות לשרת proxy של הרשת.

  • RestrictedConnectivity

    ערך בוליאני אופציונלי

    עבור רשת מחוברת, האם קישוריות הרשת לאינטרנט מוגבלת, למשל אם הרשת מאחורי פורטל, או שלא מופעלת רשת סלולרית.

  • SavedIPConfig

    IPConfigProperties אופציונלי

    הגדרות ה-IP שהתקבלו משרת ה-DHCP לפני החלת ההגדרה של כתובת ה-IP הסטטית.

  • מקור

    מחרוזת אופציונלי

    מציין אם הרשת מוגדרת ובאיזה אופן. הערכים האפשריים הם:

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    'ללא' מתנגשת עם יצירת קוד התוסף, ולכן עלינו להשתמש במחרוזת עבור 'מקור' במקום enum של SourceType.

  • StaticIPConfig

    IPConfigProperties אופציונלי

    הגדרות ה-IP הסטטיות של הרשת

  • TrafficCounterResetTime

    מספר אופציונלי

    Chrome 125+

    המועד האחרון שבו בוצע איפוס של מוני התנועה.

  • סוג הרשת.

  • VPN

    VPNProperties (מאפייני VPN) אופציונלי

    לרשתות VPN, מאפייני ה-VPN של הרשת.

  • Wi-Fi

    WiFiProperties אופציונלי

    לרשתות Wi-Fi, מאפייני הרשת Wi-Fi.

NetworkStateProperties

מאפיינים

NetworkType

Enum

"הכול"

"סלולרי"

"אתרנט"

"שיתוף אינטרנט"

"VPN"

"אלחוטי"

"Wi-Fi"

PaymentPortal

מאפיינים

  • שיטה

    מחרוזת

    שיטת ה-HTTP שבה צריך להשתמש עבור פורטל התשלומים.

  • PostData

    מחרוזת אופציונלי

    נתוני הפרסום שיישלחו לפורטל התשלומים. המערכת תתעלם, אלא אם הערך של Method הוא POST.

  • כתובת אתר

    מחרוזת אופציונלי

    כתובת ה-URL של פורטל התשלומים.

ProxyLocation

מאפיינים

  • מארח

    מחרוזת

    המארח של כתובת ה-IP של שרת ה-proxy.

  • יציאה

    number

    היציאה שבה יש להשתמש עבור שרת ה-proxy.

ProxySettings

מאפיינים

  • ExcludeDomains

    string[] אופציונלי

    דומיינים ומארחים שבהם הגדרות proxy ידניות מוחרגות.

  • ידני

    ManualProxySettings אופציונלי

    הגדרות ידניות לשרת proxy - משמשות רק להגדרות של Manual לשרת proxy.

  • קרן PAC

    מחרוזת אופציונלי

    כתובת ה-URL של קובץ התצורה האוטומטית של שרת ה-proxy.

  • סוג ההגדרות לשרת ה-proxy.

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. הערך הזה לא יכול להיות enum בגלל 'L2TP-IPSec'. המאפיין הזה הוא אופציונלי ל-NetworkConfigproperty, ולאחר מכן הוא מועבר אל setProperties וניתן להשתמש בו כדי להגדיר רק מאפיינים ספציפיים.

VPNStateProperties

מאפיינים

  • סוג

    מחרוזת

    פרטים נוספים זמינים בכתובת VPNProperties.Type.

WiFiProperties

מאפיינים

  • AllowGatewayARPPolling

    ערך בוליאני אופציונלי

    האם מותר לדגום ARP בשער ברירת המחדל. ברירת המחדל היא True.

  • AutoConnect

    ערך בוליאני אופציונלי

    ההגדרה קובעת אם צריך לחבר את רשת ה-Wi-Fi באופן אוטומטי כשנמצאים בטווח שלה.

  • BSSID

    מחרוזת אופציונלי

    ה-BSSID של נקודת הגישה המשויכת.

  • גישה מוקדמת

    EAPProperties אופציונלי

    מאפייני EAP ברשת. נדרש עבור רשתות WEP-8021X ו-WPA-EAP.

  • תדירות

    מספר אופציונלי

    תדר ההפעלה של שירות ה-Wi-Fi ב-MHz. ברשתות מחוברות, התדר הנוכחי שבו הרשת מחוברת. אחרת, התדירות של ה-BSS הזמין הטוב ביותר.

  • FrequencyList

    מספר[] אופציונלי

    מכיל את כל תדירות ההפעלה שהוצגה לאחרונה עבור רשת ה-Wi-Fi.

  • HexSSID

    מחרוזת אופציונלי

    עותק בקידוד HEX של ה-SSID של הרשת.

  • HiddenSSID

    ערך בוליאני אופציונלי

    האם ה-SSID של הרשת ישודר.

  • ביטוי סיסמה

    מחרוזת אופציונלי

    Chrome 66 ואילך

    ביטוי הסיסמה לחיבורי WEP/WPA/WPA2. את המאפיין הזה אפשר להגדיר רק - נכסים שהוחזרו על ידי getProperties לא יכילו את הערך הזה.

  • RoamThreshold

    מספר אופציונלי

    הוצא משימוש, המערכת מתעלמת ממנו.

  • SSID

    מחרוזת אופציונלי

    SSID של הרשת.

  • אבטחה

    מחרוזת אופציונלי

    סוג אבטחת הרשת.

  • SignalStrength

    מספר אופציונלי

    עוצמת האות של הרשת.

WiFiStateProperties

מאפיינים

  • BSSID

    מחרוזת אופציונלי

    פרטים נוספים זמינים בכתובת WiFiProperties.BSSID.

  • תדירות

    מספר אופציונלי

    פרטים נוספים זמינים בכתובת WiFiProperties.Frequency.

  • HexSSID

    מחרוזת אופציונלי

    Chrome 62+

    פרטים נוספים זמינים בכתובת WiFiProperties.HexSSID.

  • SSID

    מחרוזת אופציונלי

    Chrome 62+

    פרטים נוספים זמינים בכתובת WiFiProperties.SSID.

  • אבטחה

    מחרוזת

    פרטים נוספים זמינים בכתובת WiFiProperties.Security.

  • SignalStrength

    מספר אופציונלי

    פרטים נוספים זמינים בכתובת WiFiProperties.SignalStrength.

WiMAXProperties

מאפיינים

  • AutoConnect

    ערך בוליאני אופציונלי

    האם יש להתחבר לרשת באופן אוטומטי.

  • גישה מוקדמת

    EAPProperties אופציונלי

    מאפייני EAP ברשת.

שיטות

createNetwork()

הבטחה 
chrome.networking.onc.createNetwork(
  shared: boolean,
  properties: NetworkConfigProperties,
  callback?: function,
)

יצירת תצורת רשת חדשה מהנכסים. אם כבר קיימת רשת תואמת שהוגדרה, הפעולה תיכשל. אחרת, מחזירה את ה-GUID של הרשת החדשה.

פרמטרים

  • משותף

    בוליאני

    אם בוחרים באפשרות true, צריך לשתף את תצורת הרשת הזו עם משתמשים אחרים.

    האפשרות הזו חשופה רק לממשק המשתמש של Chrome באינטרנט.* כשאפליקציות קריאות לאפליקציות, false הוא הערך היחיד המותר.

  • המאפיינים שצריך להגדיר באמצעותם את הרשת החדשה.

  • קריאה חוזרת (callback)

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (result: string) => void

    • תוצאה

      מחרוזת

החזרות

  • Promise<string>

    Chrome 125+

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

disableNetworkType()

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

ההגדרה משביתה את כל המכשירים שתואמים לסוג הרשת שצוין. צפייה בהערה לגבי enableNetworkType.

פרמטרים

enableNetworkType()

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

הפעלת כל המכשירים שתואמים לסוג הרשת שצוין. הערה: הסוג עשוי לייצג כמה סוגי רשתות (למשל, 'אלחוטי').

פרמטרים

forgetNetwork()

הבטחה 
chrome.networking.onc.forgetNetwork(
  networkGuid: string,
  callback?: function,
)

מחיקת תצורת רשת על ידי ניקוי המאפיינים שהוגדרו לרשת באמצעות GUID networkGuid. הנתון הזה עשוי לכלול גם רשתות אחרות עם מזהים תואמים (למשל, SSID ואבטחה של Wi-Fi). אם לא קיימות הגדרות כאלה, תוגדר שגיאה והפעולה תיכשל.

בסשנים של קיוסק, השיטה הזו לא תוכל לשכוח את הגדרות הרשת המשותפות.

פרמטרים

  • networkGuid

    מחרוזת

    ה-GUID של הרשת שאתה צריך לשכוח.

  • קריאה חוזרת (callback)

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • הבטחה<Empty>

    Chrome 125+

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

getCaptivePortalStatus()

הבטחה 
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
)

הפונקציה מחזירה את הסטטוס של פורטל שבוי של הרשת שתואמת ל-'networkGuid'.

פרמטרים

  • networkGuid

    מחרוזת

    ה-GUID של הרשת שאליו יש לקבל סטטוס פורטל שבוי.

  • קריאה חוזרת (callback)

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (result: CaptivePortalStatus) => void

החזרות

  • Promise&lt;CaptivePortalStatus&gt;

    Chrome 125+

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

getDeviceStates()

הבטחה 
chrome.networking.onc.getDeviceStates(
  callback?: function,
)

הפונקציה מחזירה את המצבים של מכשירים זמינים לניהול רשתות.

פרמטרים

החזרות

  • Promise&lt;DeviceStateProperties[]&gt;

    Chrome 125+

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

getGlobalPolicy()

הבטחה 
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
)

קבלת מאפייני המדיניות הגלובלית. המאפיינים האלה לא צפויים להשתנות במהלך סשן.

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (result: GlobalPolicy) => void

החזרות

  • Promise&lt;GlobalPolicy&gt;

    Chrome 125+

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

getManagedProperties()

הבטחה 
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
)

מקבל את המאפיינים הממוזגים של הרשת עם מזהה networkGuid מהמקורות: הגדרות משתמש, הגדרות משותפות, מדיניות משתמש, מדיניות מכשיר וההגדרות הפעילות הנוכחיות.

פרמטרים

  • networkGuid

    מחרוזת

    ה-GUID של הרשת שאליו יש לאחזר את המאפיינים.

  • קריאה חוזרת (callback)

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (result: ManagedProperties) => void

החזרות

  • Promise&lt;ManagedProperties&gt;

    Chrome 125+

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

getNetworks()

הבטחה 
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
)

הפונקציה מחזירה רשימה של אובייקטי רשת עם אותם מאפיינים שצוינו על ידי getState. יש מסנן כדי לציין את סוג הרשתות שהוחזרו וכדי להגביל את מספר הרשתות. הרשתות מסודרות על ידי המערכת לפי העדיפות שלהן, כאשר רשתות מחוברות או מתחברות יופיעו ראשונות.

פרמטרים

החזרות

  • Promise&lt;NetworkStateProperties[]&gt;

    Chrome 125+

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

getProperties()

הבטחה 
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
)

קבלת כל מאפייני הרשת עם המזהה networkGuid. כולל את כל מאפייני הרשת (ערכי קריאה בלבד וקריאה/כתיבה).

פרמטרים

  • networkGuid

    מחרוזת

    ה-GUID של הרשת שאליו יש לאחזר את המאפיינים.

  • קריאה חוזרת (callback)

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (result: NetworkProperties) => void

החזרות

  • Promise&lt;NetworkProperties&gt;

    Chrome 125+

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

getState()

הבטחה 
chrome.networking.onc.getState(
  networkGuid: string,
  callback?: function,
)

קבלת המאפיינים לקריאה בלבד שנשמרו במטמון של הרשת עם המזהה networkGuid. זו פונקציה בעלת ביצועים גבוהים יותר מאשר getProperties, שדורשת תהליך הלוך ושוב כדי להריץ שאילתות במערכת המשנה של הרשת. המאפיינים הבאים מוחזרים לכל הרשתות: GUID, סוג, שם, Wi-Fi.Security. זמינים מאפיינים נוספים לרשתות גלויות: ConnectionState, ErrorState, Wi-SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.

פרמטרים

  • networkGuid

    מחרוזת

    ה-GUID של הרשת שאליו יש לאחזר את המאפיינים.

  • קריאה חוזרת (callback)

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (result: NetworkStateProperties) => void

החזרות

  • Promise&lt;NetworkStateProperties&gt;

    Chrome 125+

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

requestNetworkScan()

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

בקשות שמערכת המשנה של הרשת מבצעת סריקה לאיתור רשתות חדשות ותעדכן את הרשימה שמוחזרת על ידי getVisibleNetworks. זו רק בקשה: מערכת המשנה של הרשת יכולה לבחור להתעלם ממנה. אם הרשימה תתעדכן, האירוע onNetworkListChanged יופעל.

פרמטרים

  • networkType

    NetworkType אופציונלי

    Chrome 63+

    אם יש כזו, נבקש ממך סריקה ספציפית לסוג. לרשת סלולרית, תישלח בקשה לסריקה של רשת סלולרית אם יש תמיכה.

setProperties()

הבטחה 
chrome.networking.onc.setProperties(
  networkGuid: string,
  properties: NetworkConfigProperties,
  callback?: function,
)

מגדיר את מאפייני הרשת עם המזהה networkGuid. תקף רק לרשתות מוגדרות (מקור != ללא). ברשתות גלויות שלא הוגדרו, צריך להשתמש במקום זאת ב-createNetwork. בסשנים של קיוסק, לא ניתן להפעיל את השיטה הזו ברשת משותפת.

פרמטרים

  • networkGuid

    מחרוזת

    ה-GUID של הרשת שעבורו רוצים להגדיר מאפיינים.

  • המאפיינים להגדרה.

  • קריאה חוזרת (callback)

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • הבטחה<Empty>

    Chrome 125+

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

startConnect()

הבטחה 
chrome.networking.onc.startConnect(
  networkGuid: string,
  callback?: function,
)

התחלת חיבור לרשת עם networkGuid.

פרמטרים

  • networkGuid

    מחרוזת

    ה-GUID של הרשת שאליה רוצים להתחבר.

  • קריאה חוזרת (callback)

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • הבטחה<Empty>

    Chrome 125+

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

startDisconnect()

הבטחה 
chrome.networking.onc.startDisconnect(
  networkGuid: string,
  callback?: function,
)

התחלת התנתקות מהרשת באמצעות NetworkGuid.

פרמטרים

  • networkGuid

    מחרוזת

    ה-GUID של הרשת שממנה רוצים להתנתק.

  • קריאה חוזרת (callback)

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • הבטחה<Empty>

    Chrome 125+

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

אירועים

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

מופעל כשזיהוי הפורטל של הרשת מסתיים. שליחת ה-GUID של הרשת ושל סטטוס הפורטל שבוי התואם.

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

    הפרמטר callback נראה כך: 

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