chrome.networking.onc

คำอธิบาย

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

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

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

สิทธิ์

networking.onc

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

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

ประเภท

ActivationStateType

ค่าแจกแจง

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

"การเปิดใช้งาน"

"NotActivated"

"เปิดใช้งานบางส่วน"

CaptivePortalStatus

ค่าแจกแจง

"ไม่ทราบ"

"ออฟไลน์"

"ออนไลน์"

"Portal"

"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"

"รูปแบบ"

ConnectionStateType

ค่าแจกแจง

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

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

"NotConnected"

DeviceStateProperties

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

  • SIMLockStatus

    SIMLockStatus ไม่บังคับ

    Chrome 62 ขึ้นไป

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

  • SIMPresent

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

    Chrome 62 ขึ้นไป

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

  • กำลังสแกน

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

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

  • รัฐ

    DeviceStateType

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

  • ประเภท

    NetworkType

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

DeviceStateType

ค่าแจกแจง

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

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

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

"เปิดใช้"
เปิดใช้อุปกรณ์แล้ว

"ไม่อนุญาต"
ไม่อนุญาตให้อุปกรณ์

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

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

    หากเป็นจริง จะมีเพียงเครือข่ายนโยบายเท่านั้นที่เชื่อมต่ออัตโนมัติได้ ค่าเริ่มต้นคือ 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

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

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

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

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

  • ขีดจำกัด

    หมายเลข ไม่บังคับ

    จำนวนเครือข่ายสูงสุดที่จะแสดง ค่าเริ่มต้นจะเป็น 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 สำหรับเนมเซิร์ฟเวอร์ที่เครือข่ายใช้

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

    หมายเลข ไม่บังคับ

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

  • ProxySettings

    ProxySettings ไม่บังคับ

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

  • RestrictedConnectivity

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

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

  • SavedIPConfig

    IPConfigProperties ไม่บังคับ

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

  • แหล่งที่มา

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

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

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

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

  • StaticIPConfig

    IPConfigProperties ไม่บังคับ

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

  • TrafficCounterResetTime

    หมายเลข ไม่บังคับ

    Chrome 125 ขึ้นไป

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

  • ประเภท

    NetworkType

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

  • VPN

    VPNProperties ไม่บังคับ

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

  • Wi-Fi

    WiFiProperties ไม่บังคับ

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

NetworkStateProperties

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

NetworkType

ค่าแจกแจง

"ทั้งหมด"

"เซลลูลาร์"

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

"Tether"

"VPN"

"ไร้สาย"

"Wi-Fi"

PaymentPortal

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

  • วิธีการ

    สตริง

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

  • PostData

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

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

  • URL

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

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

ProxyLocation

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

  • โฮสต์

    สตริง

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

  • พอร์ต

    ตัวเลข

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

ProxySettings

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

  • ExcludeDomains

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

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

  • กำหนดเอง

    ManualProxySettings ไม่บังคับ

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

  • PAC

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

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

  • ประเภท

    ProxySettingsType

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

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

    มีคลื่นความถี่ในการทำงานทั้งหมดที่เห็นล่าสุดสำหรับเครือข่าย WiFi

  • HexSSID

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

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

  • HiddenSSID

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

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

  • รหัสผ่าน

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

    Chrome 66 ขึ้นไป

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

  • RoamThreshold

    หมายเลข ไม่บังคับ

    เลิกใช้งานแล้ว ไม่สนใจ

  • SSID

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

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

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

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

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

  • SignalStrength

    หมายเลข ไม่บังคับ

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

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

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

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

    (result: string) => void

    • ผลลัพธ์

      สตริง

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

  • Promise<string>

    Chrome 125 ขึ้นไป

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

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

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

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

    () => void

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

  • Promise<void>

    Chrome 125 ขึ้นไป

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

getCaptivePortalStatus()

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

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

พารามิเตอร์

  • networkGuid

    สตริง

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

  • callback

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

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

    (result: CaptivePortalStatus) => void

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

  • Chrome 125 ขึ้นไป

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

getDeviceStates()

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

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

พารามิเตอร์

  • callback

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

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

    (result: DeviceStateProperties[]) => void

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

  • Chrome 125 ขึ้นไป

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

getGlobalPolicy()

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

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

พารามิเตอร์

  • callback

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

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

    (result: GlobalPolicy) => void

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

  • Promise<GlobalPolicy>

    Chrome 125 ขึ้นไป

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

getManagedProperties()

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

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

พารามิเตอร์

  • networkGuid

    สตริง

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

  • callback

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

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

    (result: ManagedProperties) => void

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

  • Chrome 125 ขึ้นไป

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

getNetworks()

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

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

พารามิเตอร์

  • ตัวกรอง

    NetworkFilter

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

  • callback

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

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

    (result: NetworkStateProperties[]) => void

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

  • Chrome 125 ขึ้นไป

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

getProperties()

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

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

พารามิเตอร์

  • networkGuid

    สตริง

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

  • callback

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

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

    (result: NetworkProperties) => void

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

  • Chrome 125 ขึ้นไป

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

getState()

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

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

พารามิเตอร์

  • networkGuid

    สตริง

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

  • callback

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

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

    (result: NetworkStateProperties) => void

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

  • Chrome 125 ขึ้นไป

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

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

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

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

    () => void

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

  • Promise<void>

    Chrome 125 ขึ้นไป

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

startConnect()

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

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

พารามิเตอร์

  • networkGuid

    สตริง

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

  • callback

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

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

    () => void

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

  • Promise<void>

    Chrome 125 ขึ้นไป

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

startDisconnect()

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

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

พารามิเตอร์

  • networkGuid

    สตริง

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

  • callback

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

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

    () => void

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

  • Promise<void>

    Chrome 125 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ 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