תיאור
ה-API של chrome.networking.onc
משמש להגדרת חיבורי רשת (סלולרי, אתרנט, VPN או Wi-Fi). ה-API הזה זמין בסשנים של Chrome OS במצב קיוסק שמופעלים באופן אוטומטי.
ההגדרות של החיבור לרשת נקבעות בהתאם למפרט של תצורת רשת פתוחה (ONC).
הערה: רוב המאפיינים של המילונים וערכי ה-enum משתמשים ב-UpperCamelCase כדי להתאים למפרט ONC במקום למוסכמה של JavaScript lowerCamelCase.
הרשאות
networking.onc
זמינות
סוגים
ActivationStateType
טיפוסים בני מנייה (enum)
CaptivePortalStatus
טיפוסים בני מנייה (enum)
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
תכונות
-
קוד
string
מזהה רשת סלולרית כשרשור פשוט של ה-MCC ברשת (קוד מדינה לנייד) ו-MNC (קוד רשת סלולרית).
-
מדינה
מחרוזת אופציונלי
קוד מדינה בן שתי אותיות.
-
שם
string
שם המפעיל.
CellularStateProperties
תכונות
-
ActivationState
ActivationStateType אופציונלי
-
NetworkTechnology
מחרוזת אופציונלי
-
RoamingState
מחרוזת אופציונלי
-
SIMPresent
בוליאני אופציונלי
-
SignalStrength
מספר אופציונלי
CertificatePattern
תכונות
-
EnrollmentURI
string[] אופציונלי
רשימה של מזהי URI שאליהם ניתן להפנות את המשתמש במקרה שלא נמצאו אישורים שתואמים לדפוס הזה.
-
הונפק על ידי
IssuerSubjectPattern אופציונלי
אם הוגדרה, דפוס שלפיו יש להתאים את הגדרות מנפיק X.509.
-
IssuerCARef
string[] אופציונלי
רשימת אישורי CA של מנפיק האישור. האישור צריך להיות חתום על ידי אחד מהם כדי להתאים לתבנית הזו.
-
Subject
IssuerSubjectPattern אופציונלי
אם היא מוגדרת, התבנית שאליה יש להתאים את הגדרות הנושא מסוג X.509 צריכה להתאים.
ClientCertificateType
טיפוסים בני מנייה (enum)
ConnectionStateType
טיפוסים בני מנייה (enum)
DeviceStateProperties
תכונות
-
SIMLockStatus
SIMLockStatus אופציונלי
Chrome 62 ומעלהסטטוס הנעילה של כרטיס ה-SIM אם הסוג = סלולרי ו-SIMpresent = True.
-
SIMPresent
בוליאני אופציונלי
Chrome 62 ומעלהיש להגדיר את המכשיר למצב הנוכחי אם סוג המכשיר הוא סלולרי.
-
מתבצעת סריקה
בוליאני אופציונלי
מגדירים אם המכשיר מופעל. True אם המכשיר מבצע סריקה כרגע.
-
ארץ
המצב הנוכחי של המכשיר.
-
סוג
סוג הרשת המשויכת למכשיר (סלולרית, אתרנט או Wi-Fi).
DeviceStateType
טיפוסים בני מנייה (enum)
"לא מאותחל"
המכשיר זמין אבל לא אותחל.
"מושבת"
המכשיר אותחל אבל לא הופעל.
"הפעלה"
נשלחה בקשה למצב 'מופעל', אך הפעולה לא הושלמה.
"מופעל"
המכשיר מופעל.
"אסור"
המכשיר אסור.
EAPProperties
תכונות
-
AnonymousIdentity
מחרוזת אופציונלי
-
ClientCertPKCS11Id
מחרוזת אופציונלי
Chrome מגרסה 60 ואילך -
ClientCertPattern
CertificatePattern אופציונלי
-
ClientCertProvisioningProfileId
מחרוזת אופציונלי
Chrome 93 ומעלה -
ClientCertRef
מחרוזת אופציונלי
-
ClientCertType
-
זהות
מחרוזת אופציונלי
-
פנימי
מחרוזת אופציונלי
-
חיצוני
מחרוזת אופציונלי
הסוג החיצוני של EAP. נדרש על ידי ONC, אבל לא ניתן לספק אותו כשמתרגמים מ-Shil.
-
סיסמה
מחרוזת אופציונלי
-
SaveCredentials
בוליאני אופציונלי
-
ServerCAPEMs
string[] אופציונלי
-
ServerCARefs
string[] אופציונלי
-
SubjectMatch
ManagedDOMString אופציונלי
Chrome מגרסה 60 ואילך -
UseProactiveKeyCaching
בוליאני אופציונלי
-
UseSystemCAs
בוליאני אופציונלי
EthernetProperties
תכונות
-
אימות
מחרוזת אופציונלי
האימות שמשמש את רשת ה-Ethernet. הערכים האפשריים הם
None
ו-8021X
. -
AutoConnect
בוליאני אופציונלי
האם יש לחבר את רשת ה-Ethernet באופן אוטומטי.
-
EAP
EAPProperties אופציונלי
הגדרות EAP של הרשת. נדרשת לאימות 8021X.
EthernetStateProperties
תכונות
-
אימות
string
FoundNetworkProperties
תכונות
-
LongName
מחרוזת אופציונלי
שם הפורמט הארוך של מפעיל הרשת.
-
NetworkId
string
מזהה רשת.
-
ShortName
מחרוזת אופציונלי
שם הפורמט המקוצר של מפעיל הרשת.
-
סטטוס
string
זמינות הרשת.
-
טכנולוגיה
string
גישה לטכנולוגיה שבה הרשת משתמשת.
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 ל-WEP, כפי שדווח ב-DHCP.
IPConfigType
טיפוסים בני מנייה (enum)
IssuerSubjectPattern
תכונות
-
CommonName
מחרוזת אופציונלי
אם הוא מוגדר, הערך שמולו יתאים לשם הנפוץ של נושא האישור.
-
ישוב
מחרוזת אופציונלי
אם הוא מוגדר, הערך שעבורו יש להתאים למיקום המשותף של נושא האישור.
-
ארגון
מחרוזת אופציונלי
אם הוא מוגדר, הערך שעבורו יש להתאים לארגונים של נושא האישור. צריך לציין לפחות ארגון אחד שתואם לערך הזה.
-
OrganizationalUnit
מחרוזת אופציונלי
אם הוא מוגדר, הערך שלפיו יש להתאים את היחידות הארגוניות של נושא האישור. הערך הזה צריך להתאים לפחות ליחידה ארגונית אחת.
ManagedBoolean
תכונות
-
פעיל
בוליאני אופציונלי
הערך הפעיל המשמש כרגע את מנהל תצורת הרשת (למשל, Shill).
-
DeviceEditable
בוליאני אופציונלי
האם DevicePolicy עבור הנכס קיים ומאפשר לערוך את הנכס (כלומר, המדיניות הגדירה ערך מאפיין מומלץ). ברירת המחדל היא
false
. -
DevicePolicy
בוליאני אופציונלי
ערך המאפיין שסופק על ידי מדיניות המכשיר.
-
בתוקף
מחרוזת אופציונלי
המקור שממנו נקבע ערך הנכס בפועל.
-
בוליאני אופציונלי
הערך שהוגדר לכל המשתמשים במכשיר. יש לציין רק אם הערך של
DeviceEditiable
הואtrue
. -
UserEditable
בוליאני אופציונלי
האם קיים UserPolicy לנכס ומאפשר לערוך את הנכס (כלומר, המדיניות הגדירה ערך מומלץ לנכס). ברירת המחדל היא
false
. -
UserPolicy
בוליאני אופציונלי
ערך המאפיין שסופק על ידי מדיניות המשתמש.
-
UserSetting
בוליאני אופציונלי
ערך המאפיין שהוגדר על ידי המשתמש המחובר. יש לציין רק אם הערך של
UserEditable
הואtrue
.
ManagedCellularProperties
תכונות
-
ActivationState
ActivationStateType אופציונלי
-
ActivationType
מחרוזת אופציונלי
-
AllowRoaming
בוליאני אופציונלי
-
AutoConnect
ManagedBoolean אופציונלי
-
משפחתי
מחרוזת אופציונלי
-
FirmwareRevision
מחרוזת אופציונלי
-
FoundNetworks
FoundNetworkProperties[] אופציונלי
-
HardwareRevision
מחרוזת אופציונלי
-
HomeProvider
CellularProviderProperties[] אופציונלי
-
היצרן
מחרוזת אופציונלי
-
ModelID
מחרוזת אופציונלי
-
NetworkTechnology
מחרוזת אופציונלי
-
PaymentPortal
PaymentPortal אופציונלי
-
RoamingState
מחרוזת אופציונלי
-
SIMLockStatus
SIMLockStatus אופציונלי
-
SIMPresent
בוליאני אופציונלי
-
מתבצעת סריקה
בוליאני אופציונלי
Chrome מגרסה 63 ואילך -
ServingOperator
CellularProviderProperties אופציונלי
-
SignalStrength
מספר אופציונלי
-
SupportNetworkScan
בוליאני אופציונלי
ManagedDOMString
תכונות
-
פעיל
מחרוזת אופציונלי
הערך הפעיל המשמש כרגע את מנהל תצורת הרשת (למשל, Shill).
-
DeviceEditable
בוליאני אופציונלי
האם DevicePolicy עבור הנכס קיים ומאפשר לערוך את הנכס (כלומר, המדיניות הגדירה ערך מאפיין מומלץ). ברירת המחדל היא
false
. -
DevicePolicy
מחרוזת אופציונלי
ערך המאפיין שסופק על ידי מדיניות המכשיר.
-
בתוקף
מחרוזת אופציונלי
המקור שממנו נקבע ערך הנכס בפועל.
-
מחרוזת אופציונלי
הערך שהוגדר לכל המשתמשים במכשיר. יש לציין רק אם הערך של
DeviceEditiable
הואtrue
. -
UserEditable
בוליאני אופציונלי
האם קיים UserPolicy לנכס ומאפשר לערוך את הנכס (כלומר, המדיניות הגדירה ערך מומלץ לנכס). ברירת המחדל היא
false
. -
UserPolicy
מחרוזת אופציונלי
ערך המאפיין שסופק על ידי מדיניות המשתמש.
-
UserSetting
מחרוזת אופציונלי
ערך המאפיין שהוגדר על ידי המשתמש המחובר. יש לציין רק אם הערך של
UserEditable
הואtrue
.
ManagedDOMStringList
תכונות
-
פעיל
string[] אופציונלי
הערך הפעיל המשמש כרגע את מנהל תצורת הרשת (למשל, Shill).
-
DeviceEditable
בוליאני אופציונלי
האם DevicePolicy עבור הנכס קיים ומאפשר לערוך את הנכס (כלומר, המדיניות הגדירה ערך מאפיין מומלץ). ברירת המחדל היא
false
. -
DevicePolicy
string[] אופציונלי
ערך המאפיין שסופק על ידי מדיניות המכשיר.
-
בתוקף
מחרוזת אופציונלי
המקור שממנו נקבע ערך הנכס בפועל.
-
string[] אופציונלי
הערך שהוגדר לכל המשתמשים במכשיר. יש לציין רק אם הערך של
DeviceEditiable
הואtrue
. -
UserEditable
בוליאני אופציונלי
האם קיים UserPolicy לנכס ומאפשר לערוך את הנכס (כלומר, המדיניות הגדירה ערך מומלץ לנכס). ברירת המחדל היא
false
. -
UserPolicy
string[] אופציונלי
ערך המאפיין שסופק על ידי מדיניות המשתמש.
-
UserSetting
string[] אופציונלי
ערך המאפיין שהוגדר על ידי המשתמש המחובר. יש לציין רק אם הערך של
UserEditable
הואtrue
.
ManagedEthernetProperties
תכונות
-
אימות
ManagedDOMString אופציונלי
-
AutoConnect
ManagedBoolean אופציונלי
ManagedIPConfigProperties
תכונות
-
שער
ManagedDOMString אופציונלי
-
IPAddress
ManagedDOMString אופציונלי
-
NameServers
ManagedDOMStringList אופציונלי
-
RoutingPrefix
ManagedLong אופציונלי
-
סוג
ManagedDOMString אופציונלי
-
WebProxyAutoDiscoveryUrl
ManagedDOMString אופציונלי
ManagedIPConfigType
תכונות
-
פעיל
IPConfigType אופציונלי
הערך הפעיל המשמש כרגע את מנהל תצורת הרשת (למשל, Shill).
-
DeviceEditable
בוליאני אופציונלי
האם DevicePolicy עבור הנכס קיים ומאפשר לערוך את הנכס (כלומר, המדיניות הגדירה ערך מאפיין מומלץ). ברירת המחדל היא
false
. -
DevicePolicy
IPConfigType אופציונלי
ערך המאפיין שסופק על ידי מדיניות המכשיר.
-
בתוקף
מחרוזת אופציונלי
המקור שממנו נקבע ערך הנכס בפועל.
-
IPConfigType אופציונלי
הערך שהוגדר לכל המשתמשים במכשיר. יש לציין רק אם הערך של
DeviceEditiable
הואtrue
. -
UserEditable
בוליאני אופציונלי
האם קיים UserPolicy לנכס ומאפשר לערוך את הנכס (כלומר, המדיניות הגדירה ערך מומלץ לנכס). ברירת המחדל היא
false
. -
UserPolicy
IPConfigType אופציונלי
ערך המאפיין שסופק על ידי מדיניות המשתמש.
-
UserSetting
IPConfigType אופציונלי
ערך המאפיין שהוגדר על ידי המשתמש המחובר. יש לציין רק אם הערך של
UserEditable
הואtrue
.
ManagedLong
תכונות
-
פעיל
מספר אופציונלי
הערך הפעיל המשמש כרגע את מנהל תצורת הרשת (למשל, Shill).
-
DeviceEditable
בוליאני אופציונלי
האם DevicePolicy עבור הנכס קיים ומאפשר לערוך את הנכס (כלומר, המדיניות הגדירה ערך מאפיין מומלץ). ברירת המחדל היא
false
. -
DevicePolicy
מספר אופציונלי
ערך המאפיין שסופק על ידי מדיניות המכשיר.
-
בתוקף
מחרוזת אופציונלי
המקור שממנו נקבע ערך הנכס בפועל.
-
מספר אופציונלי
הערך שהוגדר לכל המשתמשים במכשיר. יש לציין רק אם הערך של
DeviceEditiable
הואtrue
. -
UserEditable
בוליאני אופציונלי
האם קיים UserPolicy לנכס ומאפשר לערוך את הנכס (כלומר, המדיניות הגדירה ערך מומלץ לנכס). ברירת המחדל היא
false
. -
UserPolicy
מספר אופציונלי
ערך המאפיין שסופק על ידי מדיניות המשתמש.
-
UserSetting
מספר אופציונלי
ערך המאפיין שהוגדר על ידי המשתמש המחובר. יש לציין רק אם הערך של
UserEditable
הואtrue
.
ManagedManualProxySettings
תכונות
-
FTPProxy
ManagedProxyLocation אופציונלי
-
HTTPProxy
ManagedProxyLocation אופציונלי
-
SOCKS
ManagedProxyLocation אופציונלי
-
SecureHTTPProxy
ManagedProxyLocation אופציונלי
ManagedProperties
תכונות
-
רשת סלולרית
ManagedCellularProperties אופציונלי
-
עם חיבור
בוליאני אופציונלי
-
ConnectionState
ConnectionStateType אופציונלי
-
ErrorState
מחרוזת אופציונלי
-
אתרנט
ManagedEthernetProperties אופציונלי
-
GUID
string
-
IPAddressConfigType
ManagedIPConfigType אופציונלי
-
IPConfigs
IPConfigProperties[] אופציונלי
-
MacAddress
מחרוזת אופציונלי
-
חיוב לפי שימוש בנתונים
ManagedBoolean אופציונלי
Chrome 85 ומעלה -
שם
ManagedDOMString אופציונלי
-
NameServersConfigType
ManagedIPConfigType אופציונלי
-
עדיפות
ManagedLong אופציונלי
-
ProxySettings
ManagedProxySettings אופציונלי
-
RestrictedConnectivity
בוליאני אופציונלי
-
SavedIPConfig
IPConfigProperties אופציונלי
-
מקור
מחרוזת אופציונלי
-
StaticIPConfig
ManagedIPConfigProperties אופציונלי
-
TrafficCounterResetTime
מספר אופציונלי
Chrome מגרסה 125 ואילך -
סוג
-
VPN
ManagedVPNProperties אופציונלי
-
WiFi
ManagedWiFiProperties אופציונלי
ManagedProxyLocation
תכונות
-
Host
ראו
ProxyLocation.Host
. -
נמל
ראו
ProxyLocation.Port
.
ManagedProxySettings
תכונות
-
ExcludeDomains
ManagedDOMStringList אופציונלי
-
ידני
ManagedManualProxySettings אופציונלי
ראו
ProxySettings.Manual
. -
קרן PAC
ManagedDOMString אופציונלי
ראו
ProxySettings.PAC
. -
ראו
ProxySettings.Type
.
ManagedProxySettingsType
תכונות
-
פעיל
ProxySettingsType אופציונלי
הערך הפעיל המשמש כרגע את מנהל תצורת הרשת (למשל, Shill).
-
DeviceEditable
בוליאני אופציונלי
האם DevicePolicy עבור הנכס קיים ומאפשר לערוך את הנכס (כלומר, המדיניות הגדירה ערך מאפיין מומלץ). ברירת המחדל היא
false
. -
DevicePolicy
ProxySettingsType אופציונלי
ערך המאפיין שסופק על ידי מדיניות המכשיר.
-
בתוקף
מחרוזת אופציונלי
המקור שממנו נקבע ערך הנכס בפועל.
-
ProxySettingsType אופציונלי
הערך שהוגדר לכל המשתמשים במכשיר. יש לציין רק אם הערך של
DeviceEditiable
הואtrue
. -
UserEditable
בוליאני אופציונלי
האם קיים UserPolicy לנכס ומאפשר לערוך את הנכס (כלומר, המדיניות הגדירה ערך מומלץ לנכס). ברירת המחדל היא
false
. -
UserPolicy
ProxySettingsType אופציונלי
ערך המאפיין שסופק על ידי מדיניות המשתמש.
-
UserSetting
ProxySettingsType אופציונלי
ערך המאפיין שהוגדר על ידי המשתמש המחובר. יש לציין רק אם הערך של
UserEditable
הואtrue
.
ManagedThirdPartyVPNProperties
תכונות
-
ExtensionID
-
ProviderName
מחרוזת אופציונלי
ManagedVPNProperties
תכונות
-
AutoConnect
ManagedBoolean אופציונלי
-
Host
ManagedDOMString אופציונלי
ראו
VPNProperties.Host
. -
סוג
ManagedDOMString אופציונלי
ראו
VPNProperties.Type
.
ManagedWiFiProperties
תכונות
-
AllowGatewayARPPolling
ManagedBoolean אופציונלי
-
AutoConnect
ManagedBoolean אופציונלי
-
BSSID
מחרוזת אופציונלי
ראו
WiFiProperties.BSSID
. -
תדר
מספר אופציונלי
-
FrequencyList
number[] אופציונלי
-
HexSSID
ManagedDOMString אופציונלי
-
HiddenSSID
ManagedBoolean אופציונלי
-
RoamThreshold
ManagedLong אופציונלי
הוצא משימוש, המערכת מתעלמת ממנו. ראו
WiFiProperties.RoamThreshold
. -
SSID
ManagedDOMString אופציונלי
ראו
WiFiProperties.SSID
. -
אבטחה
-
SignalStrength
מספר אופציונלי
ManualProxySettings
תכונות
-
FTPProxy
ProxyLocation אופציונלי
הגדרות לשרת proxy של FTP.
-
HTTPProxy
ProxyLocation אופציונלי
ההגדרות לשרת ה-proxy של HTTP.
-
SOCKS
ProxyLocation אופציונלי
הגדרות לשרת SOCKS proxy.
-
SecureHTTPProxy
ProxyLocation אופציונלי
הגדרות לשרת proxy מאובטח של HTTP.
NetworkConfigProperties
תכונות
-
רשת סלולרית
CellularProperties אופציונלי
-
אתרנט
EthernetProperties אופציונלי
-
GUID
מחרוזת אופציונלי
-
IPAddressConfigType
IPConfigType אופציונלי
-
שם
מחרוזת אופציונלי
-
NameServersConfigType
IPConfigType אופציונלי
-
עדיפות
מספר אופציונלי
-
סוג
NetworkType אופציונלי
-
VPN
VPNProperties אופציונלי
-
WiFi
WiFiProperties אופציונלי
-
WiMAX
WiMAXProperties אופציונלי
הוּצא משימוש.
NetworkFilter
תכונות
-
מוגדר
בוליאני אופציונלי
אם True, יש לכלול רק רשתות שהוגדרו (שמורות). ברירת המחדל היא 'false'.
-
הגבלה
מספר אופציונלי
המספר המקסימלי של רשתות שיש להחזיר. אם לא צוין ערך, ברירת המחדל היא 1,000. אם אין הגבלה, צריך להזין את הערך 0.
-
networkType
סוג הרשתות שיש להחזיר.
-
גלוי
בוליאני אופציונלי
אם הערך הוא True, יש לכלול רק רשתות גלויות (מחוברות פיזית או בטווח). ברירת המחדל היא 'false'.
NetworkProperties
תכונות
-
רשת סלולרית
CellularProperties אופציונלי
לרשתות סלולריות, מאפייני רשת סלולרית.
-
עם חיבור
בוליאני אופציונלי
האם ניתן לחבר את הרשת.
-
ConnectionState
ConnectionStateType אופציונלי
מצב החיבור הנוכחי של הרשת.
-
ErrorState
מחרוזת אופציונלי
המצב האחרון המתועד של שגיאת הרשת.
-
אתרנט
EthernetProperties אופציונלי
לרשתות Ethernet, מאפייני רשת Ethernet.
-
GUID
string
ממשק GUID של הרשת.
-
IPAddressConfigType
IPConfigType אופציונלי
סוג ההגדרה של כתובת ה-IP של הרשת.
-
IPConfigs
IPConfigProperties[] אופציונלי
הגדרת ה-IP של הרשת.
-
MacAddress
מחרוזת אופציונלי
כתובת ה-MAC של הרשת.
-
חיוב לפי שימוש בנתונים
בוליאני אופציונלי
Chrome 85 ומעלההאם מתבצע חיוב לפי שימוש בנתונים ברשת.
-
שם
מחרוזת אופציונלי
שם רשת ידידותי למשתמש.
-
NameServersConfigType
IPConfigType אופציונלי
סוג ההגדרה של כתובת ה-IP לשרתי השמות שבהם משתמשת הרשת.
-
עדיפות
מספר אופציונלי
עדיפות הרשת.
-
ProxySettings
ProxySettings אופציונלי
הגדרות שרת proxy של הרשת.
-
RestrictedConnectivity
בוליאני אופציונלי
עבור רשת מחוברת, אם קישוריות הרשת לאינטרנט מוגבלת, למשל אם הרשת נמצאת מאחורי פורטל או אם רשת סלולרית לא מופעלת.
-
SavedIPConfig
IPConfigProperties אופציונלי
הגדרה של כתובת IP שהתקבלה משרת DHCP לפני החלת הגדרת IP סטטית.
-
מקור
מחרוזת אופציונלי
מציין אם הרשת מוגדרת ואיך. הערכים האפשריים הם:
Device
DevicePolicy
User
UserPolicy
None
הערך 'ללא' מתנגש עם יצירת קוד תוסף, לכן עלינו להשתמש במחרוזת עבור 'מקור' במקום בספירת SourceType.
-
StaticIPConfig
IPConfigProperties אופציונלי
הגדרות ה-IP הסטטיות של הרשת.
-
TrafficCounterResetTime
מספר אופציונלי
Chrome מגרסה 125 ואילךהמועד האחרון שבו מוני התנועה אופסו.
-
סוג
סוג הרשת.
-
VPN
VPNProperties אופציונלי
עבור רשתות VPN, מאפייני ה-VPN של הרשת.
-
WiFi
WiFiProperties אופציונלי
לרשתות Wi-Fi, מאפייני הרשת של ה-Wi-Fi.
NetworkStateProperties
תכונות
-
רשת סלולרית
CellularStateProperties אופציונלי
-
עם חיבור
בוליאני אופציונלי
-
ConnectionState
ConnectionStateType אופציונלי
-
ErrorState
מחרוזת אופציונלי
-
אתרנט
EthernetStateProperties אופציונלי
-
GUID
string
-
שם
מחרוזת אופציונלי
-
עדיפות
מספר אופציונלי
-
מקור
מחרוזת אופציונלי
-
סוג
-
VPN
VPNStateProperties אופציונלי
-
WiFi
WiFiStateProperties אופציונלי
NetworkType
טיפוסים בני מנייה (enum)
"VPN"
PaymentPortal
תכונות
-
שיטה
string
שיטת ה-HTTP לשימוש בפורטל התשלומים.
-
PostData
מחרוזת אופציונלי
נתוני פרסום לשליחה לפורטל התשלומים. המערכת תתעלם ממנו, אלא אם הערך של
Method
הואPOST
. -
כתובת URL
מחרוזת אופציונלי
כתובת ה-URL של פורטל התשלומים.
ProxyLocation
תכונות
-
Host
string
המארח של כתובת ה-IP של שרת ה-proxy.
-
נמל
number
היציאה שבה יש להשתמש עבור שרת ה-proxy.
ProxySettings
תכונות
-
ExcludeDomains
string[] אופציונלי
דומיינים ומארחים שעבורם לא נכללות הגדרות ידניות לשרת proxy.
-
ידני
ManualProxySettings אופציונלי
הגדרות ידניות לשרת proxy - נעשה שימוש בהגדרות לשרת
Manual
בלבד. -
קרן PAC
מחרוזת אופציונלי
כתובת ה-URL של קובץ התצורה האוטומטי של שרת ה-proxy.
-
סוג ההגדרות של שרת ה-proxy.
ProxySettingsType
טיפוסים בני מנייה (enum)
"PAC"
"WPAD"
SIMLockStatus
תכונות
-
LockEnabled
boolean
האם נעילת ה-SIM מופעלת.
-
LockType
string
הסטטוס של נעילת ה-SIM - הערכים האפשריים הם
'sim-pin'
,'sim-puk'
ו-''
. -
RetriesLeft
מספר אופציונלי
מספר הניסיונות המותרים לביטול נעילה באמצעות קוד אימות לפני שיהיה צורך ב-PUK כדי לבטל את נעילת ה-SIM.
ThirdPartyVPNProperties
תכונות
-
ExtensionID
string
מזהה התוסף של ספק ה-VPN של צד שלישי.
-
ProviderName
מחרוזת אופציונלי
השם של ספק ה-VPN.
VPNProperties
תכונות
-
AutoConnect
בוליאני אופציונלי
האם יש לחבר את רשת ה-VPN באופן אוטומטי.
-
Host
מחרוזת אופציונלי
מארח ה-VPN.
-
סוג
מחרוזת אופציונלי
סוג ה-VPN. הערך הזה לא יכול להיות 'טיפוסים בני מנייה (enum)' בגלל 'L2TP-IPSec'. זוהי אפשרות אופציונלית ל-NetworkConfigProperties שמועברת אל setProperties, שבה ניתן להשתמש כדי להגדיר מאפיינים ספציפיים בלבד.
VPNStateProperties
תכונות
-
סוג
string
ראו
VPNProperties.Type
.
WiFiProperties
תכונות
-
AllowGatewayARPPolling
בוליאני אופציונלי
האם מותר להשתמש בסקרים של ARP בשער ברירת המחדל. ברירת המחדל היא True.
-
AutoConnect
בוליאני אופציונלי
האם יש לחבר את רשת ה-Wi-Fi באופן אוטומטי כאשר היא בטווח.
-
BSSID
מחרוזת אופציונלי
ה-BSSID של נקודת הגישה המשויכת..
-
EAP
EAPProperties אופציונלי
מאפייני EAP של הרשת. חובה לרשתות
WEP-8021X
ו-WPA-EAP
. -
תדר
מספר אופציונלי
תדר ההפעלה של שירות ה-Wi-Fi ב-MHz. עבור רשתות מחוברות, התדר הנוכחי שבו הרשת מחוברת. אחרת, התדירות של ה-BSS הטוב ביותר הזמין.
-
FrequencyList
number[] אופציונלי
מכילה את כל תדרי ההפעלה שנצפו לאחרונה ברשת ה-Wi-Fi.
-
HexSSID
מחרוזת אופציונלי
עותק מקודד-HEX של ה-SSID של הרשת.
-
HiddenSSID
בוליאני אופציונלי
האם ה-SSID של הרשת ישודר.
-
ביטוי סיסמה
מחרוזת אופציונלי
Chrome 66 ומעלהביטוי הסיסמה לחיבורי WEP/WPA/WPA2. ניתן להגדיר את המאפיין הזה רק. מאפיינים שהוחזרו על ידי
getProperties
לא יכילו את הערך הזה. -
RoamThreshold
מספר אופציונלי
הוצא משימוש, המערכת מתעלמת ממנו.
-
SSID
מחרוזת אופציונלי
ה-SSID של הרשת.
-
אבטחה
מחרוזת אופציונלי
הסוג של אבטחת הרשת.
-
SignalStrength
מספר אופציונלי
עוצמת האות של הרשת.
WiFiStateProperties
תכונות
-
BSSID
מחרוזת אופציונלי
ראו
WiFiProperties.BSSID
. -
תדר
מספר אופציונלי
-
HexSSID
מחרוזת אופציונלי
Chrome 62 ומעלה -
SSID
מחרוזת אופציונלי
Chrome 62 ומעלהראו
WiFiProperties.SSID
. -
אבטחה
string
-
SignalStrength
מספר אופציונלי
WiMAXProperties
תכונות
-
AutoConnect
בוליאני אופציונלי
האם יש לחבר את הרשת באופן אוטומטי.
-
EAP
EAPProperties אופציונלי
מאפייני EAP של הרשת.
שיטות
createNetwork()
chrome.networking.onc.createNetwork(
shared: boolean,
properties: NetworkConfigProperties,
callback?: function,
)
יצירה של הגדרת רשת חדשה מנכסים. אם כבר קיימת רשת תואמת שהוגדרה, הפעולה תיכשל. אחרת, הפונקציה מחזירה את ה-GUID של הרשת החדשה.
פרמטרים
-
boolean
אם בוחרים באפשרות
true
, משתפים את הגדרת הרשת הזו עם משתמשים אחרים.האפשרות הזו חשופה רק לממשק המשתמש של Chrome באינטרנט.* כשמתבצעת קריאה על ידי אפליקציות, הערך
false
הוא הערך היחיד המותר. -
נכסים
המאפיינים שצריך להגדיר את הרשת החדשה באמצעותם.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(result: string) => void
-
תוצאה אחת
string
-
החזרות
-
הבטחה<string>
Chrome מגרסה 125 ואילךהבטחות נתמכות רק במניפסט מגרסה V3 ואילך. בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).
disableNetworkType()
chrome.networking.onc.disableNetworkType(
networkType: NetworkType,
)
השבתה של כל המכשירים שתואמים לסוג הרשת שצוין. צפייה בהערה לגבי enableNetworkType
.
פרמטרים
-
networkType
סוג הרשת שרוצים להשבית.
enableNetworkType()
chrome.networking.onc.enableNetworkType(
networkType: NetworkType,
)
הפעלת כל המכשירים שתואמים לסוג הרשת שצוין. שים לב, הסוג עשוי לייצג כמה סוגי רשתות (למשל 'אלחוטי').
פרמטרים
-
networkType
סוג הרשת שרוצים להפעיל.
forgetNetwork()
chrome.networking.onc.forgetNetwork(
networkGuid: string,
callback?: function,
)
לשכוח הגדרות רשת על ידי ניקוי כל המאפיינים שהוגדרו לרשת עם GUID networkGuid
. קישורים אלה עשויים לכלול גם רשתות אחרות שיש להן מזהים תואמים (למשל, SSID ואבטחה של Wi-Fi). אם לא קיימת הגדרה כזו, תוגדר שגיאה והפעולה תיכשל.
בסשנים של קיוסק, השיטה הזו לא תוכל לשכוח את הגדרות הרשת המשותפות.
פרמטרים
-
networkGuid
string
ה-GUID של הרשת שצריך למחוק.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:() => void
החזרות
-
Promise<void>
Chrome מגרסה 125 ואילךהבטחות נתמכות רק במניפסט מגרסה V3 ואילך. בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).
getCaptivePortalStatus()
chrome.networking.onc.getCaptivePortalStatus(
networkGuid: string,
callback?: function,
)
מחזירה סטטוס של פורטל שבוי עבור הרשת התואמת ל-'networkGuid'.
פרמטרים
-
networkGuid
string
ה-GUID של הרשת שעבורו יש לקבל את הסטטוס של פורטל שבוי.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(result: CaptivePortalStatus) => void
-
תוצאה אחת
-
החזרות
-
Promise<CaptivePortalStatus>
Chrome מגרסה 125 ואילךהבטחות נתמכות רק במניפסט מגרסה V3 ואילך. בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).
getDeviceStates()
chrome.networking.onc.getDeviceStates(
callback?: function,
)
מחזירה את המצבים של מכשירי הרשת הזמינים.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(result: DeviceStateProperties[]) => void
-
תוצאה אחת
-
החזרות
-
Promise<DeviceStateProperties[]>
Chrome מגרסה 125 ואילךהבטחות נתמכות רק במניפסט מגרסה V3 ואילך. בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).
getGlobalPolicy()
chrome.networking.onc.getGlobalPolicy(
callback?: function,
)
מקבלת את מאפייני המדיניות הגלובלית. המאפיינים האלה לא צפויים להשתנות במהלך סשן.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(result: GlobalPolicy) => void
-
תוצאה אחת
-
החזרות
-
Promise<GlobalPolicy>
Chrome מגרסה 125 ואילךהבטחות נתמכות רק במניפסט מגרסה V3 ואילך. בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).
getManagedProperties()
chrome.networking.onc.getManagedProperties(
networkGuid: string,
callback?: function,
)
מקבלת את המאפיינים הממוזגים של הרשת עם המזהה networkGuid מהמקורות: הגדרות המשתמש, הגדרות משותפות, מדיניות המשתמש, מדיניות המכשיר וההגדרות הפעילות הנוכחיות.
פרמטרים
-
networkGuid
string
ה-GUID של הרשת שעבורו רוצים לקבל מאפיינים.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(result: ManagedProperties) => void
-
תוצאה אחת
-
החזרות
-
Promise<ManagedProperties>
Chrome מגרסה 125 ואילךהבטחות נתמכות רק במניפסט מגרסה V3 ואילך. בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).
getNetworks()
chrome.networking.onc.getNetworks(
filter: NetworkFilter,
callback?: function,
)
מחזירה רשימה של אובייקטים של רשת בעלי אותם מאפיינים שסופקו על ידי getState
. ניתן לסנן כדי לציין את סוג הרשתות שמוחזרות ולהגביל את מספר הרשתות. הרשתות מסודרות על ידי המערכת לפי העדיפות שלהן, כאשר הרשתות מחוברות או מתחברים יופיעו ראשונות.
פרמטרים
-
סינון
מתאר אילו רשתות להחזיר.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(result: NetworkStateProperties[]) => void
-
תוצאה אחת
-
החזרות
-
Promise<NetworkStateProperties[]>
Chrome מגרסה 125 ואילךהבטחות נתמכות רק במניפסט מגרסה V3 ואילך. בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).
getProperties()
chrome.networking.onc.getProperties(
networkGuid: string,
callback?: function,
)
מקבלת את כל מאפייני הרשת עם המזהה networkGuid. כולל את כל מאפייני הרשת (ערכים לקריאה בלבד ולקריאה/כתיבה).
פרמטרים
-
networkGuid
string
ה-GUID של הרשת שעבורו רוצים לקבל מאפיינים.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(result: NetworkProperties) => void
-
תוצאה אחת
-
החזרות
-
Promise<NetworkProperties>
Chrome מגרסה 125 ואילךהבטחות נתמכות רק במניפסט מגרסה V3 ואילך. בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).
getState()
chrome.networking.onc.getState(
networkGuid: string,
callback?: function,
)
מקבל את מאפייני הקריאה בלבד שנשמרו במטמון של הרשת עם המזהה networkGuid. הוא אמור להיות פונקציה של ביצועים טובים יותר מאשר getProperties
, שצריך לבצע בה הלוך ושוב כדי לשלוח שאילתות למערכת המשנה של הרשת. המאפיינים הבאים מוחזרים עבור כל הרשתות: GUID, Type, Name, WiFi.Security. סופקו נכסים נוספים לרשתות גלויות: ConnectionState, ErrorState, WiFi.SignalStrength, Cell.NetworkTechnologies, Cell.ActivationState, Cell.RoamingState.
פרמטרים
-
networkGuid
string
ה-GUID של הרשת שעבורו רוצים לקבל מאפיינים.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(result: NetworkStateProperties) => void
-
תוצאה אחת
-
החזרות
-
Promise<NetworkStateProperties>
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
string
ה-GUID של הרשת שעבורו יש להגדיר מאפיינים.
-
נכסים
המאפיינים להגדרה.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:() => void
החזרות
-
Promise<void>
Chrome מגרסה 125 ואילךהבטחות נתמכות רק במניפסט מגרסה V3 ואילך. בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).
startConnect()
chrome.networking.onc.startConnect(
networkGuid: string,
callback?: function,
)
התחלת חיבור לרשת באמצעות networkGuid.
פרמטרים
-
networkGuid
string
ה-GUID של הרשת שאליה יש להתחבר.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:() => void
החזרות
-
Promise<void>
Chrome מגרסה 125 ואילךהבטחות נתמכות רק במניפסט מגרסה V3 ואילך. בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).
startDisconnect()
chrome.networking.onc.startDisconnect(
networkGuid: string,
callback?: function,
)
מתחיל ניתוק מהרשת באמצעות networkGuid.
פרמטרים
-
networkGuid
string
ה-GUID של הרשת שיש להתנתק ממנה.
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:() => void
החזרות
-
Promise<void>
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
-
שינויים
מחרוזת[]
-
onNetworksChanged
chrome.networking.onc.onNetworksChanged.addListener(
callback: function,
)
מופעל כשהמאפיינים משתנים באחת מהרשתות. שולחת רשימה של מזהי GUID עבור רשתות שהנכסים שלהן השתנו.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(changes: string[]) => void
-
שינויים
מחרוזת[]
-
onPortalDetectionCompleted
chrome.networking.onc.onPortalDetectionCompleted.addListener(
callback: function,
)
מופעל כשזיהוי פורטל לרשת מסתיים. שליחת ה-GUID של הרשת והסטטוס המתאים של פורטל השבי.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(networkGuid: string, status: CaptivePortalStatus) => void
-
networkGuid
string
-
status
-