chrome.networking.onc

คำอธิบาย

chrome.networking.onc API ใช้สำหรับกำหนดค่าการเชื่อมต่อเครือข่าย (เครือข่ายมือถือ, อีเทอร์เน็ต, VPN หรือ Wi-Fi) API นี้พร้อมใช้งานในเซสชันคีออสก์ Chrome OS ที่เปิดโดยอัตโนมัติ

การกำหนดค่าการเชื่อมต่อเครือข่ายจะระบุตามข้อกำหนดของการกำหนดค่าเครือข่ายแบบเปิด (ONC)

หมายเหตุ: พร็อพเพอร์ตี้พจนานุกรมและค่า Enum ส่วนใหญ่ใช้รูปแบบ UpperCamelCase เพื่อจับคู่กับข้อกําหนดของ ONC แทนรูปแบบ lowerCamelCase ของ JavaScript

สิทธิ์

networking.onc

ความพร้อมใช้งาน

Chrome 59 ขึ้นไป ChromeOS เท่านั้น

ประเภท

ActivationStateType

ค่าแจกแจง

"เปิดใช้งานแล้ว"

"กำลังเปิดใช้งาน"

"NotActivated"

"PartiallyActivated"

CaptivePortalStatus

ค่าแจกแจง

"ไม่ทราบ"

"ออฟไลน์"

"ออนไลน์"

"พอร์ทัล"

"ProxyAuthRequired"

CellularProperties

พร็อพเพอร์ตี้

  • ActivationState

    ActivationStateType ไม่บังคับ

    สถานะการเปิดใช้งานบัญชีผู้ให้บริการ

  • ActivationType

    สตริง ไม่บังคับ

    ประเภทการเปิดใช้งานเครือข่ายมือถือ

  • AllowRoaming

    บูลีน ไม่บังคับ

    เครือข่ายอนุญาตให้โรมมิงหรือไม่

  • AutoConnect

    บูลีน ไม่บังคับ

    เครือข่ายมือถือควรเชื่อมต่อโดยอัตโนมัติหรือไม่ (เมื่ออยู่ในระยะสัญญาณ)

  • ครอบครัว

    สตริง ไม่บังคับ

    ตระกูลเทคโนโลยีอุปกรณ์เคลื่อนที่ - CDMA หรือ GSM

  • FirmwareRevision

    สตริง ไม่บังคับ

    เวอร์ชันเฟิร์มแวร์ที่โหลดในโมเด็มเซลลูลาร์

  • FoundNetworks

    FoundNetworkProperties[] ไม่บังคับ

    รายการเครือข่ายที่พบระหว่างการสแกนเครือข่ายครั้งล่าสุด

  • HardwareRevision

    สตริง ไม่บังคับ

    การแก้ไขฮาร์ดแวร์ของโมเด็มเครือข่ายมือถือ

  • HomeProvider

    CellularProviderProperties ไม่บังคับ

    ข้อมูลเกี่ยวกับผู้ให้บริการที่ออกซิมการ์ดที่ติดตั้งอยู่ในโมเด็ม

  • ผู้ผลิต

    สตริง ไม่บังคับ

    ผู้ผลิตโมเด็มเครือข่ายมือถือ

  • ModelID

    สตริง ไม่บังคับ

    รหัสรุ่นโมเด็มเครือข่ายมือถือ

  • NetworkTechnology

    สตริง ไม่บังคับ

    หากเราเตอร์ลงทะเบียนอยู่ในเครือข่าย เทคโนโลยีเครือข่ายที่ใช้อยู่ในปัจจุบัน

  • PaymentPortal

    PaymentPortal ไม่บังคับ

    พอร์ทัลการชำระเงินออนไลน์ที่ผู้ใช้สามารถใช้เพื่อลงชื่อสมัครใช้หรือแก้ไขแพ็กเกจอินเทอร์เน็ตมือถือ

  • RoamingState

    สตริง ไม่บังคับ

    สถานะการโรมมิ่งของโมเด็มมือถือในเครือข่ายปัจจุบัน

  • SIMLockStatus

    SIMLockStatus ไม่บังคับ

    สถานะการล็อก SIM สำหรับเครือข่าย GSM ของครอบครัว

  • SIMPresent

    บูลีน ไม่บังคับ

    ว่ามีซิมการ์ดหรือไม่

  • กำลังสแกน

    บูลีน ไม่บังคับ

    Chrome 63 ขึ้นไป

    เป็นจริงเมื่อการสแกนเครือข่ายมือถือกำลังดำเนินอยู่

  • ServingOperator

    CellularProviderProperties ไม่บังคับ

    ข้อมูลเกี่ยวกับผู้ให้บริการเครือข่ายที่ลงทะเบียนโมเด็มอยู่ในปัจจุบัน

  • SignalStrength

    ตัวเลข ไม่บังคับ

    ความแรงของสัญญาณเครือข่ายปัจจุบัน

  • SupportNetworkScan

    บูลีน ไม่บังคับ

    เครือข่ายมือถือรองรับการสแกนหรือไม่

CellularProviderProperties

พร็อพเพอร์ตี้

  • รหัส

    สตริง

    รหัสเครือข่ายมือถือเป็นการต่อ MCC (รหัสประเทศของอุปกรณ์เคลื่อนที่) และ MNC (รหัสเครือข่ายมือถือ) ของเครือข่ายเข้าด้วยกัน

  • ประเทศ

    สตริง ไม่บังคับ

    รหัสประเทศ 2 ตัวอักษร

  • ชื่อ

    สตริง

    ชื่อโอเปอเรเตอร์

CellularStateProperties

พร็อพเพอร์ตี้

CertificatePattern

พร็อพเพอร์ตี้

  • EnrollmentURI

    string[] ไม่บังคับ

    รายการ URI ที่ระบบจะนําผู้ใช้ไปในกรณีที่ไม่พบใบรับรองที่ตรงกับรูปแบบนี้

  • ผู้ออก

    IssuerSubjectPattern ไม่บังคับ

    หากตั้งค่าไว้ รูปแบบที่ควรจับคู่กับการตั้งค่าผู้ออกใบรับรอง X.509

  • IssuerCARef

    string[] ไม่บังคับ

    รายการใบรับรอง CA ของผู้ออกใบรับรอง ใบรับรองต้องได้รับการลงนามโดยหน่วยงานใดหน่วยงานหนึ่งจึงจะจับคู่กับรูปแบบนี้ได้

  • เรื่อง

    IssuerSubjectPattern ไม่บังคับ

    หากตั้งค่าไว้ ให้ระบุรูปแบบที่ควรจับคู่กับการตั้งค่าเรื่อง X.509

ClientCertificateType

ค่าแจกแจง

"Ref"

"Pattern"

ConnectionStateType

ค่าแจกแจง

"เชื่อมต่อแล้ว"

"กำลังเชื่อมต่อ"

"NotConnected"

DeviceStateProperties

พร็อพเพอร์ตี้

  • SIMLockStatus

    SIMLockStatus ไม่บังคับ

    Chrome 62 ขึ้นไป

    สถานะการล็อกซิมหาก Type = Cellular และ SIMPresent = True

  • SIMPresent

    บูลีน ไม่บังคับ

    Chrome 62 ขึ้นไป

    ตั้งค่าเป็นสถานะมีซิมอยู่หากประเภทอุปกรณ์คือเครือข่ายมือถือ

  • กำลังสแกน

    บูลีน ไม่บังคับ

    ตั้งค่าว่าเปิดใช้อุปกรณ์หรือไม่ จริงหากอุปกรณ์กำลังสแกนอยู่

  • รัฐ

    สถานะปัจจุบันของอุปกรณ์

  • ประเภท

    ประเภทเครือข่ายที่เชื่อมโยงกับอุปกรณ์ (เครือข่ายมือถือ อีเทอร์เน็ต หรือ Wi-Fi)

DeviceStateType

ค่าแจกแจง

"ไม่ได้เริ่มต้น"
อุปกรณ์พร้อมใช้งานแต่ไม่ได้เริ่มต้น

"ปิดใช้"
อุปกรณ์ได้รับการเริ่มต้นแต่ไม่ได้เปิดใช้

"กำลังเปิดใช้"
มีการส่งคำขอสถานะ "เปิดใช้" แต่ยังไม่เสร็จสมบูรณ์

"เปิดใช้"
อุปกรณ์เปิดใช้อยู่

"ไม่ได้รับอนุญาต"
อุปกรณ์ไม่ได้รับอนุญาต

EAPProperties

พร็อพเพอร์ตี้

  • AnonymousIdentity

    สตริง ไม่บังคับ

  • ClientCertPKCS11Id

    สตริง ไม่บังคับ

    Chrome 60 ขึ้นไป
  • ClientCertPattern

    CertificatePattern ไม่บังคับ

  • ClientCertProvisioningProfileId

    สตริง ไม่บังคับ

    Chrome 93 ขึ้นไป
  • ClientCertRef

    สตริง ไม่บังคับ

  • ClientCertType
  • Identity

    สตริง ไม่บังคับ

  • ด้านใน

    สตริง ไม่บังคับ

  • ภายนอก

    สตริง ไม่บังคับ

    ประเภท EAP ด้านนอก ONC กำหนดให้ต้องมี แต่อาจไม่ได้ระบุไว้เมื่อแปลจาก Shill

  • รหัสผ่าน

    สตริง ไม่บังคับ

  • SaveCredentials

    บูลีน ไม่บังคับ

  • ServerCAPEMs

    string[] ไม่บังคับ

  • ServerCARefs

    string[] ไม่บังคับ

  • SubjectMatch

    ManagedDOMString ไม่บังคับ

    Chrome 60 ขึ้นไป
  • UseProactiveKeyCaching

    บูลีน ไม่บังคับ

  • UseSystemCAs

    บูลีน ไม่บังคับ

EthernetProperties

พร็อพเพอร์ตี้

  • การตรวจสอบสิทธิ์

    สตริง ไม่บังคับ

    การตรวจสอบสิทธิ์ที่เครือข่ายอีเทอร์เน็ตใช้ ค่าที่เป็นไปได้คือ None และ 8021X

  • AutoConnect

    บูลีน ไม่บังคับ

    เครือข่ายอีเทอร์เน็ตควรเชื่อมต่อโดยอัตโนมัติหรือไม่

  • EAP

    EAPProperties ไม่บังคับ

    การตั้งค่า EAP ของเครือข่าย จำเป็นสำหรับการตรวจสอบสิทธิ์ 8021X

EthernetStateProperties

พร็อพเพอร์ตี้

FoundNetworkProperties

พร็อพเพอร์ตี้

  • LongName

    สตริง ไม่บังคับ

    ชื่อแบบยาวของผู้ให้บริการเครือข่าย

  • NetworkId

    สตริง

    รหัสเครือข่าย

  • ShortName

    สตริง ไม่บังคับ

    ชื่อรูปแบบย่อของผู้ให้บริการเครือข่าย

  • สถานะ

    สตริง

    ความพร้อมใช้งานของเครือข่าย

  • เทคโนโลยี

    สตริง

    เทคโนโลยีการเข้าถึงที่เครือข่ายใช้

GlobalPolicy

พร็อพเพอร์ตี้

  • AllowOnlyPolicyNetworksToAutoconnect

    บูลีน ไม่บังคับ

    หากเป็น "จริง" จะมีเพียงเครือข่ายนโยบายเท่านั้นที่เชื่อมต่ออัตโนมัติได้ ค่าเริ่มต้นคือ False

  • AllowOnlyPolicyNetworksToConnect

    บูลีน ไม่บังคับ

    หากเป็น "จริง" ระบบจะเชื่อมต่อได้เฉพาะกับเครือข่ายนโยบาย และจะไม่เพิ่มหรือกำหนดค่าเครือข่ายใหม่ ค่าเริ่มต้นคือ False

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    บูลีน ไม่บังคับ

    Chrome 70 ขึ้นไป

    หากเป็น "จริง" และมีเครือข่ายที่มีการจัดการในรายการเครือข่ายที่มองเห็นได้ ระบบจะเชื่อมต่อได้เฉพาะกับเครือข่ายนโยบายเท่านั้น และคุณจะเพิ่มหรือกำหนดค่าเครือข่ายใหม่ไม่ได้ ค่าเริ่มต้นคือ 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 สําหรับการค้นหาเว็บพร็อกซีอัตโนมัติตามที่รายงานผ่าน DHCP

IPConfigType

ค่าแจกแจง

"DHCP"

"Static"

IssuerSubjectPattern

พร็อพเพอร์ตี้

  • CommonName

    สตริง ไม่บังคับ

    หากมีการตั้งค่า ค่าที่จะใช้จับคู่กับชื่อจริงของใบรับรอง

  • ย่าน

    สตริง ไม่บังคับ

    หากตั้งค่าไว้ ค่าที่จะใช้จับคู่กับตำแหน่งทั่วไปของบุคคลที่ระบุในใบรับรอง

  • องค์กร

    สตริง ไม่บังคับ

    หากตั้งค่าไว้ ค่าที่จะใช้จับคู่กับองค์กรของผู้ถือใบรับรอง องค์กรอย่างน้อย 1 แห่งควรตรงกับค่า

  • OrganizationalUnit

    สตริง ไม่บังคับ

    หากตั้งค่าไว้ ค่าที่จะใช้จับคู่กับหน่วยขององค์กรของผู้ถือใบรับรอง หน่วยขององค์กรอย่างน้อย 1 หน่วยควรตรงกับค่า

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 ไม่บังคับ

    ค่าที่ใช้งานอยู่ซึ่งเครื่องมือจัดการการกําหนดค่าเครือข่ายใช้อยู่ในปัจจุบัน (เช่น 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

  • SOCKS

    ProxyLocation ไม่บังคับ

    การตั้งค่าสำหรับพร็อกซี SOCKS

  • SecureHTTPProxy

    ProxyLocation ไม่บังคับ

    การตั้งค่าพร็อกซี HTTP ที่ปลอดภัย

NetworkConfigProperties

พร็อพเพอร์ตี้

NetworkFilter

พร็อพเพอร์ตี้

  • กำหนดค่าแล้ว

    บูลีน ไม่บังคับ

    หากเป็น "จริง" ระบบจะรวมเฉพาะเครือข่ายที่กําหนดค่า (บันทึกไว้) เท่านั้น ค่าเริ่มต้นคือ "เท็จ"

  • ขีดจำกัด

    ตัวเลข ไม่บังคับ

    จำนวนเครือข่ายสูงสุดที่จะแสดง ค่าเริ่มต้นจะเป็น 1000 หากไม่ได้ระบุไว้ ใช้ 0 สำหรับไม่จำกัด

  • networkType

    ประเภทเครือข่ายที่จะแสดง

  • มองเห็นได้

    บูลีน ไม่บังคับ

    หากเป็น "จริง" ระบบจะรวมเฉพาะเครือข่ายที่มองเห็นได้ (เชื่อมต่ออยู่จริงหรืออยู่ในระยะสัญญาณ) ค่าเริ่มต้นคือ "เท็จ"

NetworkProperties

พร็อพเพอร์ตี้

  • เครือข่ายมือถือ

    CellularProperties ไม่บังคับ

    สำหรับเครือข่ายมือถือ ให้ใช้พร็อพเพอร์ตี้เครือข่ายมือถือ

  • เชื่อมต่อได้

    บูลีน ไม่บังคับ

    เครือข่ายเชื่อมต่อได้หรือไม่

  • ConnectionState

    ConnectionStateType ไม่บังคับ

    สถานะการเชื่อมต่อปัจจุบันของเครือข่าย

  • ErrorState

    สตริง ไม่บังคับ

    สถานะข้อผิดพลาดของเครือข่ายที่บันทึกไว้ล่าสุด

  • อีเทอร์เน็ต

    EthernetProperties ไม่บังคับ

    สำหรับเครือข่ายอีเทอร์เน็ต ให้ใช้พร็อพเพอร์ตี้เครือข่ายอีเทอร์เน็ต

  • GUID

    สตริง

    GUID ของเครือข่าย

  • IPAddressConfigType

    IPConfigType ไม่บังคับ

    ประเภทการกำหนดค่าที่อยู่ IP ของเครือข่าย

  • IPConfigs

    IPConfigProperties[] ไม่บังคับ

    การกำหนดค่า IP ของเครือข่าย

  • MacAddress

    สตริง ไม่บังคับ

    ที่อยู่ MAC ของเครือข่าย

  • มีการวัดปริมาณอินเทอร์เน็ต

    บูลีน ไม่บังคับ

    Chrome 85 ขึ้นไป

    เครือข่ายเป็นแบบจำกัดปริมาณหรือไม่

  • ชื่อ

    สตริง ไม่บังคับ

    ชื่อเครือข่ายที่ใช้งานง่าย

  • NameServersConfigType

    IPConfigType ไม่บังคับ

    ประเภทการกำหนดค่า IP สำหรับเนมเซิร์ฟเวอร์ที่เครือข่ายใช้

  • ลำดับความสำคัญ

    ตัวเลข ไม่บังคับ

    ลำดับความสำคัญของเครือข่าย

  • ProxySettings

    ProxySettings ไม่บังคับ

    การตั้งค่าพร็อกซีของเครือข่าย

  • RestrictedConnectivity

    บูลีน ไม่บังคับ

    สำหรับเครือข่ายที่เชื่อมต่อ การเชื่อมต่อเครือข่ายกับอินเทอร์เน็ตถูกจํากัดหรือไม่ เช่น เครือข่ายอยู่หลังพอร์ทัล หรือไม่ได้เปิดใช้งานเครือข่ายมือถือ

  • SavedIPConfig

    IPConfigProperties ไม่บังคับ

    การกำหนดค่า IP ที่ได้รับจากเซิร์ฟเวอร์ DHCP ก่อนที่จะใช้การกำหนดค่า IP แบบคงที่

  • แหล่งที่มา

    สตริง ไม่บังคับ

    ระบุว่ามีการกําหนดค่าเครือข่ายหรือไม่และอย่างไร ค่าที่เป็นไปได้มีดังนี้

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    "ไม่มี" ขัดแย้งกับการสร้างโค้ดส่วนขยาย เราจึงต้องใช้สตริงสำหรับ "แหล่งที่มา" แทนนิพจน์ SourceType

  • StaticIPConfig

    IPConfigProperties ไม่บังคับ

    การกำหนดค่า IP แบบคงที่ของเครือข่าย

  • TrafficCounterResetTime

    ตัวเลข ไม่บังคับ

    Chrome 125 ขึ้นไป

    เวลาที่มีการรีเซ็ตตัวนับการรับส่งข้อมูลครั้งล่าสุด

  • ประเภท

    ประเภทเครือข่าย

  • VPN

    VPNProperties ไม่บังคับ

    สำหรับเครือข่าย VPN ให้ใช้พร็อพเพอร์ตี้ VPN ของเครือข่าย

  • Wi-Fi

    WiFiProperties ไม่บังคับ

    สำหรับเครือข่าย Wi-Fi ให้ใช้พร็อพเพอร์ตี้ Wi-Fi ของเครือข่าย

NetworkStateProperties

พร็อพเพอร์ตี้

NetworkType

ค่าแจกแจง

"ทั้งหมด"

"เครือข่ายมือถือ"

"อีเทอร์เน็ต"

"การเทเทอร์"

"VPN"

"ไร้สาย"

"WiFi"

PaymentPortal

พร็อพเพอร์ตี้

  • วิธีการ

    สตริง

    เมธอด HTTP ที่จะใช้สําหรับพอร์ทัลการชําระเงิน

  • PostData

    สตริง ไม่บังคับ

    ข้อมูลการโพสต์ที่จะส่งไปยังพอร์ทัลการชำระเงิน ระบบจะละเว้น เว้นแต่ Method จะเท่ากับ POST

  • URL

    สตริง ไม่บังคับ

    URL ของพอร์ทัลการชำระเงิน

ProxyLocation

พร็อพเพอร์ตี้

  • โฮสต์

    สตริง

    โฮสต์ที่อยู่ IP ของพร็อกซี

  • พอร์ต

    ตัวเลข

    พอร์ตที่จะใช้สำหรับพร็อกซี

ProxySettings

พร็อพเพอร์ตี้

  • ExcludeDomains

    string[] ไม่บังคับ

    โดเมนและโฮสต์ที่จะยกเว้นการตั้งค่าพร็อกซีด้วยตนเอง

  • กำหนดเอง

    ManualProxySettings ไม่บังคับ

    การตั้งค่าพร็อกซีด้วยตนเอง - ใช้สำหรับการตั้งค่าพร็อกซี Manual เท่านั้น

  • PAC

    สตริง ไม่บังคับ

    URL ของไฟล์การกำหนดค่าพร็อกซีอัตโนมัติ

  • ประเภท

    ประเภทการตั้งค่าพร็อกซี

ProxySettingsType

ค่าแจกแจง

"โดยตรง"

"ด้วยตนเอง"

"PAC"

"WPAD"

SIMLockStatus

พร็อพเพอร์ตี้

  • LockEnabled

    บูลีน

    การเปิดใช้การล็อกซิม

  • LockType

    สตริง

    สถานะการล็อกซิม - ค่าที่เป็นไปได้คือ 'sim-pin', 'sim-puk' และ ''

  • RetriesLeft

    ตัวเลข ไม่บังคับ

    จำนวนครั้งที่อนุญาตให้ลองปลดล็อก PIN ได้ก่อนที่จะต้องใช้ PUK เพื่อปลดล็อกซิม

ThirdPartyVPNProperties

พร็อพเพอร์ตี้

  • ExtensionID

    สตริง

    รหัสของส่วนขยายผู้ให้บริการ VPN บุคคลที่สาม

  • ProviderName

    สตริง ไม่บังคับ

    ชื่อผู้ให้บริการ VPN

VPNProperties

พร็อพเพอร์ตี้

  • AutoConnect

    บูลีน ไม่บังคับ

    เครือข่าย VPN ควรเชื่อมต่อโดยอัตโนมัติหรือไม่

  • โฮสต์

    สตริง ไม่บังคับ

    โฮสต์ VPN

  • ประเภท

    สตริง ไม่บังคับ

    ประเภท VPN รายการนี้ต้องเป็น Enum ไม่ได้เนื่องจากมี "L2TP-IPSec" ตัวเลือกนี้ไม่บังคับสำหรับ NetworkConfigProperties ซึ่งส่งไปยัง setProperties ซึ่งอาจใช้เพื่อตั้งค่าเฉพาะบางพร็อพเพอร์ตี้

VPNStateProperties

พร็อพเพอร์ตี้

WiFiProperties

พร็อพเพอร์ตี้

  • AllowGatewayARPPolling

    บูลีน ไม่บังคับ

    เลิกใช้งานตั้งแต่ Chrome 131

    นําออกใน M131 ขณะนี้ไม่มีการสำรวจ ARP ที่ใช้งานอยู่

  • AutoConnect

    บูลีน ไม่บังคับ

    เครือข่าย Wi-Fi ควรเชื่อมต่อโดยอัตโนมัติเมื่ออยู่ในระยะสัญญาณหรือไม่

  • BSSID

    สตริง ไม่บังคับ

    BSSID ของจุดเข้าใช้งานที่เชื่อมโยง

  • EAP

    EAPProperties ไม่บังคับ

    พร็อพเพอร์ตี้ EAP ของเครือข่าย ต้องใช้สำหรับเครือข่าย WEP-8021X และ WPA-EAP

  • ความถี่

    ตัวเลข ไม่บังคับ

    ความถี่ที่บริการ Wi-Fi ทำงานเป็น MHz สำหรับเครือข่ายที่เชื่อมต่ออยู่ ความถี่ปัจจุบันที่เครือข่ายเชื่อมต่ออยู่ หรือความถี่ของ BSS ที่พร้อมใช้งานดีที่สุด

  • FrequencyList

    number[] ไม่บังคับ

    ประกอบด้วยความถี่การทํางานทั้งหมดที่พบล่าสุดสําหรับเครือข่าย Wi-Fi

  • HexSSID

    สตริง ไม่บังคับ

    สําเนา SSID ของเครือข่ายที่เข้ารหัส HEX

  • HiddenSSID

    บูลีน ไม่บังคับ

    ตัวเลือกว่าจะเผยแพร่ SSID ของเครือข่ายหรือไม่

  • รหัสผ่าน

    สตริง ไม่บังคับ

    Chrome 66 ขึ้นไป

    รหัสผ่านสำหรับการเชื่อมต่อ WEP/WPA/WPA2 พร็อพเพอร์ตี้นี้ตั้งค่าได้เท่านั้น พร็อพเพอร์ตี้ที่ getProperties แสดงจะไม่มีค่านี้

  • RoamThreshold

    ตัวเลข ไม่บังคับ

    เลิกใช้งานแล้ว ละเว้น

  • SSID

    สตริง ไม่บังคับ

    SSID ของเครือข่าย

  • ความปลอดภัย

    สตริง ไม่บังคับ

    ประเภทการรักษาความปลอดภัยของเครือข่าย

  • SignalStrength

    ตัวเลข ไม่บังคับ

    ความแรงของสัญญาณเครือข่าย

WiFiStateProperties

พร็อพเพอร์ตี้

WiMAXProperties

พร็อพเพอร์ตี้

  • AutoConnect

    บูลีน ไม่บังคับ

    เครือข่ายควรเชื่อมต่อโดยอัตโนมัติหรือไม่

  • EAP

    EAPProperties ไม่บังคับ

    พร็อพเพอร์ตี้ EAP ของเครือข่าย

เมธอด

createNetwork()

สัญญา
chrome.networking.onc.createNetwork(
  shared: boolean,
  properties: NetworkConfigProperties,
  callback?: function,
)

สร้างการกำหนดค่าเครือข่ายใหม่จากพร็อพเพอร์ตี้ หากมีเครือข่ายที่กําหนดค่าไว้ซึ่งตรงกันอยู่แล้ว การดำเนินการนี้จะดำเนินการไม่สำเร็จ ไม่เช่นนั้น ระบบจะแสดงผล GUID ของเครือข่ายใหม่

พารามิเตอร์

  • แชร์แล้ว

    บูลีน

    หากเป็น true ให้แชร์การกำหนดค่าเครือข่ายนี้กับผู้ใช้คนอื่นๆ

    ตัวเลือกนี้จะแสดงใน UI ของเว็บ Chrome เท่านั้น* เมื่อแอปเรียกใช้ false จะเป็นค่าเดียวที่อนุญาต

  • พร็อพเพอร์ตี้

    พร็อพเพอร์ตี้ที่จะใช้กำหนดค่าเครือข่ายใหม่

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้

    (result: string) => void

    • ผลลัพธ์

      สตริง

การคืนสินค้า

  • Promise<string>

    Chrome 125 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

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

    สตริง

    GUID ของเครือข่ายที่จะลืม

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้

    () => void

การคืนสินค้า

  • Promise<void>

    Chrome 125 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getCaptivePortalStatus()

สัญญา
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
)

แสดงสถานะแคพทีฟพอร์ทัลของเครือข่ายที่ตรงกับ "networkGuid"

พารามิเตอร์

  • networkGuid

    สตริง

    GUID ของเครือข่ายที่จะดูสถานะแคพทีฟพอร์ทัล

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้

    (result: CaptivePortalStatus) => void

การคืนสินค้า

  • Chrome 125 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getDeviceStates()

สัญญา
chrome.networking.onc.getDeviceStates(
  callback?: function,
)

แสดงสถานะของอุปกรณ์เครือข่ายที่ใช้ได้

พารามิเตอร์

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้

    (result: DeviceStateProperties[]) => void

การคืนสินค้า

  • Chrome 125 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getGlobalPolicy()

สัญญา
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
)

รับพร็อพเพอร์ตี้นโยบายส่วนกลาง เราไม่คาดว่าพร็อพเพอร์ตี้เหล่านี้จะเปลี่ยนแปลงระหว่างเซสชัน

พารามิเตอร์

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้

    (result: GlobalPolicy) => void

การคืนสินค้า

  • Promise<GlobalPolicy>

    Chrome 125 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getManagedProperties()

สัญญา
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
)

รับพร็อพเพอร์ตี้ที่ผสานรวมของเครือข่ายที่มีรหัส networkGuid จากแหล่งที่มาต่างๆ ได้แก่ การตั้งค่าผู้ใช้ การตั้งค่าที่แชร์ นโยบายผู้ใช้ นโยบายอุปกรณ์ และการตั้งค่าที่ใช้งานอยู่ในปัจจุบัน

พารามิเตอร์

  • networkGuid

    สตริง

    GUID ของเครือข่ายที่จะรับพร็อพเพอร์ตี้

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้

    (result: ManagedProperties) => void

การคืนสินค้า

  • Chrome 125 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getNetworks()

สัญญา
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
)

แสดงรายการออบเจ็กต์เครือข่ายที่มีพร็อพเพอร์ตี้เดียวกันซึ่งระบุโดย getState มีตัวกรองให้ระบุประเภทของเครือข่ายที่จะแสดงผลและจํากัดจํานวนเครือข่าย ระบบจะจัดเรียงเครือข่ายตามลำดับความสำคัญ โดยเครือข่ายที่เชื่อมต่อหรือกำลังเชื่อมต่อจะแสดงก่อน

พารามิเตอร์

  • ตัวกรอง

    อธิบายเครือข่ายที่จะแสดงผล

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้

    (result: NetworkStateProperties[]) => void

การคืนสินค้า

  • Chrome 125 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getProperties()

สัญญา
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
)

รับพร็อพเพอร์ตี้ทั้งหมดของเครือข่ายที่มีรหัส networkGuid รวมพร็อพเพอร์ตี้ทั้งหมดของเครือข่าย (ค่าอ่านอย่างเดียวและอ่าน/เขียน)

พารามิเตอร์

  • networkGuid

    สตริง

    GUID ของเครือข่ายที่จะรับพร็อพเพอร์ตี้

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้

    (result: NetworkProperties) => void

การคืนสินค้า

  • Chrome 125 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

getState()

สัญญา
chrome.networking.onc.getState(
  networkGuid: string,
  callback?: function,
)

รับพร็อพเพอร์ตี้ที่แคชไว้ซึ่งอ่านอย่างเดียวของเครือข่ายที่มีรหัส networkGuid ฟังก์ชันนี้มีไว้เพื่อประสิทธิภาพที่สูงกว่า getProperties ซึ่งต้องมีการส่งข้อมูลไปมาเพื่อค้นหาระบบย่อยของเครือข่าย ระบบจะแสดงผลพร็อพเพอร์ตี้ต่อไปนี้สำหรับเครือข่ายทั้งหมด ได้แก่ GUID, ประเภท, ชื่อ, WiFi.Security พร็อพเพอร์ตี้เพิ่มเติมสำหรับเครือข่ายที่มองเห็นได้ ได้แก่ ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState

พารามิเตอร์

  • networkGuid

    สตริง

    GUID ของเครือข่ายที่จะรับพร็อพเพอร์ตี้

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้

    (result: NetworkStateProperties) => void

การคืนสินค้า

  • Chrome 125 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

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 ใช้ได้กับเครือข่ายที่กําหนดค่าไว้เท่านั้น (Source != None) เครือข่ายที่มองเห็นได้ซึ่งไม่ได้กําหนดค่าไว้ควรใช้ createNetwork แทน ในเซสชันคีออสก์ การเรียกใช้เมธอดนี้ในเครือข่ายที่แชร์จะดำเนินการไม่สำเร็จ

พารามิเตอร์

  • networkGuid

    สตริง

    GUID ของเครือข่ายที่จะตั้งค่าพร็อพเพอร์ตี้

  • พร็อพเพอร์ตี้

    พร็อพเพอร์ตี้ที่จะตั้งค่า

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้

    () => void

การคืนสินค้า

  • Promise<void>

    Chrome 125 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

startConnect()

สัญญา
chrome.networking.onc.startConnect(
  networkGuid: string,
  callback?: function,
)

เริ่มการเชื่อมต่อกับเครือข่ายด้วย networkGuid

พารามิเตอร์

  • networkGuid

    สตริง

    GUID ของเครือข่ายที่จะเชื่อมต่อ

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้

    () => void

การคืนสินค้า

  • Promise<void>

    Chrome 125 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

startDisconnect()

สัญญา
chrome.networking.onc.startDisconnect(
  networkGuid: string,
  callback?: function,
)

เริ่มยกเลิกการเชื่อมต่อกับเครือข่ายด้วย networkGuid

พารามิเตอร์

  • networkGuid

    สตริง

    GUID ของเครือข่ายที่จะยกเลิกการเชื่อมต่อ

  • Callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback จะมีลักษณะดังนี้

    () => void

การคืนสินค้า

  • Promise<void>

    Chrome 125 ขึ้นไป

    ระบบรองรับ Promises สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น ส่วนแพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

กิจกรรม

onDeviceStateListChanged

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

เรียกใช้เมื่อรายการอุปกรณ์มีการเปลี่ยนแปลงหรือพร็อพเพอร์ตี้สถานะอุปกรณ์มีการเปลี่ยนแปลง

พารามิเตอร์

  • Callback

    ฟังก์ชัน

    พารามิเตอร์ callback จะมีลักษณะดังนี้

    () => void

onNetworkListChanged

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

เรียกใช้เมื่อมีการเปลี่ยนแปลงรายการเครือข่าย ส่งรายการ GUID ทั้งหมดของเครือข่ายปัจจุบันทั้งหมด

พารามิเตอร์

  • Callback

    ฟังก์ชัน

    พารามิเตอร์ callback จะมีลักษณะดังนี้

    (changes: string[]) => void

    • การเปลี่ยนแปลง

      string[]

onNetworksChanged

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

เรียกใช้เมื่อพร็อพเพอร์ตี้มีการเปลี่ยนแปลงในเครือข่ายใดก็ตาม ส่งรายการ GUID สำหรับเครือข่ายที่มีการเปลี่ยนแปลงพร็อพเพอร์ตี้

พารามิเตอร์

  • Callback

    ฟังก์ชัน

    พารามิเตอร์ callback จะมีลักษณะดังนี้

    (changes: string[]) => void

    • การเปลี่ยนแปลง

      string[]

onPortalDetectionCompleted

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

เริ่มทํางานเมื่อการตรวจหาพอร์ทัลสําหรับเครือข่ายเสร็จสมบูรณ์ ส่ง GUID ของเครือข่ายและสถานะแคพทีฟพอร์ทัลที่เกี่ยวข้อง

พารามิเตอร์

  • Callback

    ฟังก์ชัน

    พารามิเตอร์ callback จะมีลักษณะดังนี้

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