chrome.networking.onc

คำอธิบาย

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

การกำหนดค่าการเชื่อมต่อเครือข่ายจะระบุตามข้อกำหนด Open Network Configuration (ONC)

NOTE: พร็อพเพอร์ตี้พจนานุกรมและค่า 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 ไม่บังคับ

    สถานะการล็อกซิมสำหรับเครือข่ายตระกูล GSM

  • SIMPresent

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

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

  • กำลังสแกน

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

    Chrome 63 ขึ้นไป

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

  • ServingOperator

    CellularProviderProperties ไม่บังคับ

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

  • SignalStrength

    number ไม่บังคับ

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

  • SupportNetworkScan

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

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

CellularProviderProperties

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

  • รหัส

    สตริง

    รหัสเครือข่ายมือถือเป็นการเชื่อมโยงอย่างง่ายของ MCC (รหัสโทรศัพท์มือถือของประเทศ) และ MNC (รหัสระบุเครือข่ายมือถือ) ของเครือข่าย

  • ประเทศ

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

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

  • ชื่อ

    สตริง

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

CellularStateProperties

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

CertificatePattern

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

  • EnrollmentURI

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

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

  • ผู้ออก

    IssuerSubjectPattern ไม่บังคับ

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

  • IssuerCARef

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

    รายการใบรับรอง CA ของผู้ออกใบรับรอง ใบรับรองต้องได้รับการรับรองโดยผู้ออกใบรับรองรายใดรายหนึ่งเพื่อให้ตรงกับรูปแบบนี้

  • เรื่อง

    IssuerSubjectPattern ไม่บังคับ

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

ClientCertificateType

ค่าแจกแจง

"Ref"

"รูปแบบ"

ConnectionStateType

ค่าแจกแจง

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

"การเชื่อมต่อ"

"NotConnected"

DeviceStateProperties

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

  • SIMLockStatus

    SIMLockStatus ไม่บังคับ

    Chrome 62 ขึ้นไป

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

  • SIMPresent

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

    Chrome 62 ขึ้นไป

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

  • กำลังสแกน

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

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

  • รัฐ

    DeviceStateType

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

  • ประเภท

    NetworkType

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

DeviceStateType

ค่าแจกแจง

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

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

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

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

"Prohibited"
อุปกรณ์ถูกห้ามใช้

EAPProperties

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

  • AnonymousIdentity

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

  • ClientCertPKCS11Id

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

    Chrome 60 ขึ้นไป
  • ClientCertPattern

    CertificatePattern ไม่บังคับ

  • ClientCertProvisioningProfileId

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

    Chrome 93 ขึ้นไป
  • ClientCertRef

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

  • ClientCertType

    ClientCertificateType

  • 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

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

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

  • AllowOnlyPolicyNetworksToConnect

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

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

  • AllowOnlyPolicyNetworksToConnectIfAvailable

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

    Chrome 70 ขึ้นไป

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

  • 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

    number ไม่บังคับ

    คำนำหน้าการกำหนดเส้นทาง

  • SearchDomains

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

    Chrome 76 ขึ้นไป

    อาร์เรย์ของสตริงสำหรับการแปลงชื่อ โปรดดูรายละเอียดที่ onc_spec.md

  • ประเภท

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

    ประเภทการกำหนดค่า IP โดยอาจเป็น IPv4 หรือ IPv6

  • WebProxyAutoDiscoveryUrl

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

    URL สำหรับการค้นหาเว็บพร็อกซีอัตโนมัติ (WPAD) ตามที่รายงานผ่าน DHCP

IPConfigType

ค่าแจกแจง

"DHCP"

"คงที่"

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

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

  • ใช้งานอยู่

    number ไม่บังคับ

    ค่าที่ใช้งานอยู่ซึ่งเครื่องมือจัดการการกำหนดค่าเครือข่าย (เช่น Shill) ใช้อยู่ในปัจจุบัน

  • DeviceEditable

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

    DevicePolicy สำหรับพร็อพเพอร์ตี้มีอยู่และอนุญาตให้แก้ไขพร็อพเพอร์ตี้หรือไม่ (เช่น นโยบายตั้งค่าพร็อพเพอร์ตี้ที่แนะนำ) ค่าเริ่มต้นคือ false

  • DevicePolicy

    number ไม่บังคับ

    ค่าพร็อพเพอร์ตี้ที่นโยบายด้านอุปกรณ์ระบุ

  • มีผลอยู่

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

    แหล่งที่มาที่ใช้กำหนดค่าพร็อพเพอร์ตี้ที่มีผล

  • SharedSetting

    number ไม่บังคับ

    ค่าที่ตั้งไว้สำหรับผู้ใช้อุปกรณ์ทุกคน ระบุเฉพาะในกรณีที่ DeviceEditiable เป็น true

  • UserEditable

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

    UserPolicy สำหรับพร็อพเพอร์ตี้มีอยู่และอนุญาตให้แก้ไขพร็อพเพอร์ตี้หรือไม่ (เช่น นโยบายตั้งค่าพร็อพเพอร์ตี้ที่แนะนำ) ค่าเริ่มต้นคือ false

  • UserPolicy

    number ไม่บังคับ

    ค่าพร็อพเพอร์ตี้ที่นโยบายผู้ใช้ระบุ

  • UserSetting

    number ไม่บังคับ

    ค่าพร็อพเพอร์ตี้ที่ผู้ใช้ที่เข้าสู่ระบบตั้งค่าไว้ ระบุเฉพาะในกรณีที่ 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

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

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

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

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

  • ขีดจำกัด

    number ไม่บังคับ

    จำนวนเครือข่ายสูงสุดที่จะแสดงผล ค่าเริ่มต้นคือ 1,000 หากไม่ได้ระบุไว้ ป้อน 0 เพื่อไม่จำกัด

  • networkType

    NetworkType

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

  • มองเห็นได้

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

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

NetworkProperties

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

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

    CellularProperties ไม่บังคับ

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

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

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

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

  • ConnectionState

    ConnectionStateType ไม่บังคับ

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

  • ErrorState

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

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

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

    EthernetProperties ไม่บังคับ

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

  • GUID

    สตริง

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

  • IPAddressConfigType

    IPConfigType ไม่บังคับ

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

  • IPConfigs

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

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

  • MacAddress

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

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

  • แบบจำกัดปริมาณ

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

    Chrome 85 ขึ้นไป

    เครือข่ายมีการวัดปริมาณหรือไม่

  • ชื่อ

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

    ชื่อเครือข่ายที่จำง่าย

  • NameServersConfigType

    IPConfigType ไม่บังคับ

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

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

    number ไม่บังคับ

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

  • ProxySettings

    ProxySettings ไม่บังคับ

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

  • RestrictedConnectivity

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

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

  • SavedIPConfig

    IPConfigProperties ไม่บังคับ

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

  • แหล่งที่มา

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

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

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    "None" ขัดแย้งกับการสร้างโค้ดส่วนขยาย ดังนั้นเราจึงต้องใช้สตริงสำหรับ "Source" แทน enum ของ SourceType

  • StaticIPConfig

    IPConfigProperties ไม่บังคับ

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

  • TrafficCounterResetTime

    number ไม่บังคับ

    Chrome 125 ขึ้นไป

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

  • ประเภท

    NetworkType

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

  • VPN

    VPNProperties ไม่บังคับ

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

  • Wi-Fi

    WiFiProperties ไม่บังคับ

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

NetworkStateProperties

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

NetworkType

ค่าแจกแจง

"ทั้งหมด"

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

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

"เชื่อมต่ออินเทอร์เน็ต"

"VPN"

"ไร้สาย"

"Wi-Fi"

PaymentPortal

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

  • วิธีการ

    สตริง

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

  • PostData

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

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

  • URL

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

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

ProxyLocation

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

  • โฮสต์

    สตริง

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

  • พอร์ต

    ตัวเลข

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

ProxySettings

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

  • ExcludeDomains

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

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

  • กำหนดเอง

    ManualProxySettings ไม่บังคับ

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

  • PAC

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

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

  • ประเภท

    ProxySettingsType

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

ProxySettingsType

ค่าแจกแจง

"โดยตรง"

"Manual"

"PAC"

"WPAD"

SIMLockStatus

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

  • LockEnabled

    บูลีน

    เปิดใช้การล็อกซิมหรือไม่

  • LockType

    สตริง

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

  • RetriesLeft

    number ไม่บังคับ

    จำนวนครั้งที่อนุญาตให้ลองป้อน 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

  • ความถี่

    number ไม่บังคับ

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

  • FrequencyList

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

    มีข้อมูลความถี่ในการทำงานทั้งหมดที่พบเมื่อเร็วๆ นี้สำหรับเครือข่าย Wi-Fi

  • HexSSID

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

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

  • HiddenSSID

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

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

  • พาสเฟรส

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

    Chrome 66 ขึ้นไป

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

  • RoamThreshold

    number ไม่บังคับ

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

  • SSID

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

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

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

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

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

  • SignalStrength

    number ไม่บังคับ

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

WiFiStateProperties

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

WiMAXProperties

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

  • AutoConnect

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

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

  • EAP

    EAPProperties ไม่บังคับ

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

เมธอด

createNetwork()

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

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

พารามิเตอร์

  • แชร์แล้ว

    บูลีน

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

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

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

    NetworkConfigProperties

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

  • callback

    function ไม่บังคับ

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

    (result: string) => void

    • ผลลัพธ์

      สตริง

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

  • Promise<string>

    Chrome 125 ขึ้นไป

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

disableNetworkType()

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

ปิดใช้อุปกรณ์ที่ตรงกับประเภทเครือข่ายที่ระบุ ดูหมายเหตุสำหรับ enableNetworkType

พารามิเตอร์

  • networkType

    NetworkType

    ประเภทเครือข่ายที่จะปิดใช้

enableNetworkType()

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

เปิดใช้อุปกรณ์ที่ตรงกับประเภทเครือข่ายที่ระบุ โปรดทราบว่าประเภทอาจแสดงถึงเครือข่ายหลายประเภท (เช่น "ไร้สาย")

พารามิเตอร์

  • networkType

    NetworkType

    ประเภทเครือข่ายที่จะเปิดใช้

forgetNetwork()

Promise 
chrome.networking.onc.forgetNetwork(
  networkGuid: string,
  callback?: function,
): Promise<void>

ลืมการกำหนดค่าเครือข่ายโดยล้างพร็อพเพอร์ตี้ที่กำหนดค่าไว้สำหรับเครือข่ายที่มี GUID networkGuid ซึ่งอาจรวมถึงเครือข่ายอื่นๆ ที่มีตัวระบุที่ตรงกัน (เช่น SSID และการรักษาความปลอดภัยของ Wi-Fi) หากไม่มีการกำหนดค่าดังกล่าว ระบบจะตั้งค่าข้อผิดพลาดและการดำเนินการจะล้มเหลว

ในเซสชันคีออสก์ เมธอดนี้จะไม่สามารถลืมการกำหนดค่าเครือข่ายที่แชร์ได้

พารามิเตอร์

  • networkGuid

    สตริง

    GUID ของเครือข่ายที่ต้องการเลิกจำ

  • callback

    function ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 125 ขึ้นไป

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

getCaptivePortalStatus()

Promise 
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
): Promise<CaptivePortalStatus>

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

พารามิเตอร์

  • networkGuid

    สตริง

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

  • callback

    function ไม่บังคับ

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

    (result: CaptivePortalStatus) => void

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

  • Chrome 125 ขึ้นไป

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

getDeviceStates()

Promise 
chrome.networking.onc.getDeviceStates(
  callback?: function,
): Promise<DeviceStateProperties[]>

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

พารามิเตอร์

  • callback

    function ไม่บังคับ

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

    (result: DeviceStateProperties[]) => void

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

  • Chrome 125 ขึ้นไป

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

getGlobalPolicy()

Promise 
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
): Promise<GlobalPolicy>

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

พารามิเตอร์

  • callback

    function ไม่บังคับ

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

    (result: GlobalPolicy) => void

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

  • Promise<GlobalPolicy>

    Chrome 125 ขึ้นไป

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

getManagedProperties()

Promise 
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
): Promise<ManagedProperties>

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

พารามิเตอร์

  • networkGuid

    สตริง

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

  • callback

    function ไม่บังคับ

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

    (result: ManagedProperties) => void

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

  • Chrome 125 ขึ้นไป

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

getNetworks()

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

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

พารามิเตอร์

  • ตัวกรอง

    NetworkFilter

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

  • callback

    function ไม่บังคับ

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

    (result: NetworkStateProperties[]) => void

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

  • Chrome 125 ขึ้นไป

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

getProperties()

Promise 
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
): Promise<NetworkProperties>

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

พารามิเตอร์

  • networkGuid

    สตริง

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

  • callback

    function ไม่บังคับ

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

    (result: NetworkProperties) => void

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

  • Chrome 125 ขึ้นไป

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

getState()

Promise 
chrome.networking.onc.getState(
  networkGuid: string,
  callback?: function,
): Promise<NetworkStateProperties>

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

พารามิเตอร์

  • networkGuid

    สตริง

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

  • callback

    function ไม่บังคับ

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

    (result: NetworkStateProperties) => void

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

  • Chrome 125 ขึ้นไป

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

requestNetworkScan()

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

ส่งคำขอให้ระบบย่อยของเครือข่ายสแกนหาเครือข่ายใหม่และอัปเดตรายการที่ getVisibleNetworks แสดงผล นี่เป็นเพียงคำขอเท่านั้น ระบบย่อยของเครือข่ายสามารถเลือกที่จะเพิกเฉยได้ หากมีการอัปเดตรายการ ระบบจะเริ่มเหตุการณ์ onNetworkListChanged

พารามิเตอร์

  • networkType

    NetworkType ไม่บังคับ

    Chrome 63 ขึ้นไป

    หากระบุไว้ ระบบจะขอการสแกนเฉพาะประเภท สำหรับเครือข่ายมือถือ ระบบจะขอให้สแกนเครือข่ายมือถือหากรองรับ

setProperties()

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

ตั้งค่าพร็อพเพอร์ตี้ของเครือข่ายที่มีรหัส networkGuid ซึ่งใช้ได้กับเครือข่ายที่กำหนดค่าไว้เท่านั้น (แหล่งที่มา != ไม่มี) เครือข่ายที่มองเห็นได้ซึ่งไม่ได้กำหนดค่าควรใช้ createNetwork แทน ในเซสชันคีออสก์ การเรียกใช้เมธอดนี้ในเครือข่ายที่ใช้ร่วมกันจะดำเนินการไม่สำเร็จ

พารามิเตอร์

  • networkGuid

    สตริง

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

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

    NetworkConfigProperties

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

  • callback

    function ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 125 ขึ้นไป

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

startConnect()

Promise 
chrome.networking.onc.startConnect(
  networkGuid: string,
  callback?: function,
): Promise<void>

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

พารามิเตอร์

  • networkGuid

    สตริง

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

  • callback

    function ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 125 ขึ้นไป

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

startDisconnect()

Promise 
chrome.networking.onc.startDisconnect(
  networkGuid: string,
  callback?: function,
): Promise<void>

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

พารามิเตอร์

  • networkGuid

    สตริง

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

  • callback

    function ไม่บังคับ

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

    () => void

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

  • Promise<void>

    Chrome 125 ขึ้นไป

    ระบบรองรับ Promise สำหรับ Manifest 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