chrome.networking.onc

Mô tả

API chrome.networking.onc được dùng để định cấu hình kết nối mạng (Mạng di động, Ethernet, VPN hoặc Wi-Fi). API này có trong các phiên kiosk tự động chạy trên ChromeOS.

Cấu hình kết nối mạng được chỉ định theo quy cách Cấu hình mạng mở (ONC).

NOTE: Hầu hết các thuộc tính từ điển và giá trị enum đều sử dụng UpperCamelCase để khớp với thông số kỹ thuật ONC thay vì quy ước lowerCamelCase của JavaScript.

Quyền

networking.onc

Phạm vi cung cấp

Chrome 59 trở lên Chỉ ChromeOS

Loại

ActivationStateType

Enum

"Đã kích hoạt"

"Đang kích hoạt"

"NotActivated"

"PartiallyActivated"

CaptivePortalStatus

Enum

"Không xác định"

"Ngoại tuyến"

"Trực tuyến"

"Portal"

"ProxyAuthRequired"

CellularProperties

Thuộc tính

  • ActivationState

    ActivationStateType không bắt buộc

    Trạng thái kích hoạt tài khoản nhà mạng.

  • ActivationType

    chuỗi không bắt buộc

    Loại kích hoạt mạng di động.

  • AllowRoaming

    boolean không bắt buộc

    Mạng có cho phép chuyển vùng hay không.

  • AutoConnect

    boolean không bắt buộc

    Liệu có nên tự động kết nối với mạng di động (khi nằm trong phạm vi phủ sóng) hay không.

  • Gia đình

    chuỗi không bắt buộc

    Nhóm công nghệ thiết bị di động – CDMA hoặc GSM.

  • FirmwareRevision

    chuỗi không bắt buộc

    Bản sửa đổi chương trình cơ sở được tải trong modem di động.

  • FoundNetworks

    FoundNetworkProperties[] không bắt buộc

    Danh sách các mạng được tìm thấy trong lần quét mạng gần đây nhất.

  • HardwareRevision

    chuỗi không bắt buộc

    Bản sửa đổi phần cứng của modem di động.

  • HomeProvider

    CellularProviderProperties không bắt buộc

    Thông tin về nhà mạng đã phát hành thẻ SIM hiện được lắp trong modem.

  • Nhà sản xuất

    chuỗi không bắt buộc

    Nhà sản xuất modem di động.

  • ModelID

    chuỗi không bắt buộc

    Mã mẫu modem di động.

  • NetworkTechnology

    chuỗi không bắt buộc

    Nếu modem được đăng ký trên một mạng, thì công nghệ mạng hiện đang được sử dụng.

  • PaymentPortal

    PaymentPortal không bắt buộc

    Cổng thanh toán trực tuyến mà người dùng có thể sử dụng để đăng ký hoặc sửa đổi gói dữ liệu di động.

  • RoamingState

    chuỗi không bắt buộc

    Trạng thái chuyển vùng của modem di động trên mạng hiện tại.

  • SIMLockStatus

    SIMLockStatus không bắt buộc

    Trạng thái khoá SIM cho mạng thuộc nhóm GSM.

  • SIMPresent

    boolean không bắt buộc

    Có thẻ SIM hay không.

  • Đang quét

    boolean không bắt buộc

    Chrome 63 trở lên

    Đúng khi đang quét mạng di động.

  • ServingOperator

    CellularProviderProperties không bắt buộc

    Thông tin về nhà mạng mà modem hiện đã đăng ký.

  • SignalStrength

    number không bắt buộc

    Cường độ tín hiệu mạng hiện tại.

  • SupportNetworkScan

    boolean không bắt buộc

    Xem mạng di động có hỗ trợ quét hay không.

CellularProviderProperties

Thuộc tính

  • Mã

    chuỗi

    Mã mạng di động dưới dạng một phép nối đơn giản giữa MCC (Mã di động quốc gia) và MNC (Mã mạng di động) của mạng.

  • Quốc gia

    chuỗi không bắt buộc

    Mã quốc gia gồm hai chữ cái.

  • Tên

    chuỗi

    Tên nhà mạng.

CellularStateProperties

Thuộc tính

CertificatePattern

Thuộc tính

  • EnrollmentURI

    string[] không bắt buộc

    Danh sách URI mà người dùng có thể được chuyển hướng đến trong trường hợp không tìm thấy chứng chỉ nào khớp với mẫu này.

  • Tổ chức phát hành

    IssuerSubjectPattern không bắt buộc

    Nếu được đặt, mẫu mà chế độ cài đặt của tổ chức phát hành X.509 phải khớp.

  • IssuerCARef

    string[] không bắt buộc

    Danh sách chứng chỉ CA của nhà phát hành chứng chỉ. Chứng chỉ phải được một trong các tổ chức này ký để khớp với mẫu này.

  • Tiêu đề

    IssuerSubjectPattern không bắt buộc

    Nếu được đặt, mẫu mà chế độ cài đặt chủ thể X.509 phải khớp.

ClientCertificateType

Enum

"Ref"

"Mẫu"

ConnectionStateType

Enum

"Đã kết nối"

"Đang kết nối"

"NotConnected"

DeviceStateProperties

Thuộc tính

  • SIMLockStatus

    SIMLockStatus không bắt buộc

    Chrome 62 trở lên

    Trạng thái khoá SIM nếu Type = Cellular và SIMPresent = True.

  • SIMPresent

    boolean không bắt buộc

    Chrome 62 trở lên

    Đặt thành trạng thái có SIM nếu loại thiết bị là Di động.

  • Đang quét

    boolean không bắt buộc

    Đặt xem thiết bị có được bật hay không. Đúng nếu thiết bị đang quét.

  • Tiểu bang

    DeviceStateType

    Trạng thái hiện tại của thiết bị.

  • Loại

    NetworkType

    Loại mạng liên kết với thiết bị (Mạng di động, Ethernet hoặc Wi-Fi).

DeviceStateType

Enum

"Chưa khởi chạy"
Thiết bị có sẵn nhưng chưa được khởi chạy.

"Disabled"
Thiết bị đã được khởi chạy nhưng chưa được bật.

"Đang bật"
Trạng thái bật đã được yêu cầu nhưng chưa hoàn tất.

"Đã bật"
Thiết bị đang bật.

"Bị cấm"
Thiết bị bị cấm.

EAPProperties

Thuộc tính

  • AnonymousIdentity

    chuỗi không bắt buộc

  • ClientCertPKCS11Id

    chuỗi không bắt buộc

    Chrome 60 trở lên
  • ClientCertPattern

    CertificatePattern không bắt buộc

  • ClientCertProvisioningProfileId

    chuỗi không bắt buộc

    Chrome 93 trở lên
  • ClientCertRef

    chuỗi không bắt buộc

  • ClientCertType

    ClientCertificateType

  • của bản thân

    chuỗi không bắt buộc

  • Phía trong

    chuỗi không bắt buộc

  • Bên ngoài

    chuỗi không bắt buộc

    Loại EAP bên ngoài. Bắt buộc theo ONC, nhưng có thể không được cung cấp khi dịch từ Shill.

  • Mật khẩu

    chuỗi không bắt buộc

  • SaveCredentials

    boolean không bắt buộc

  • ServerCAPEMs

    string[] không bắt buộc

  • ServerCARefs

    string[] không bắt buộc

  • SubjectMatch

    ManagedDOMString không bắt buộc

    Chrome 60 trở lên
  • UseProactiveKeyCaching

    boolean không bắt buộc

  • UseSystemCAs

    boolean không bắt buộc

EthernetProperties

Thuộc tính

  • Xác thực

    chuỗi không bắt buộc

    Phương thức xác thực mà mạng Ethernet sử dụng. Các giá trị có thể sử dụng là None và 8021X.

  • AutoConnect

    boolean không bắt buộc

    Có tự động kết nối với mạng Ethernet hay không.

  • EAP (chương trình tiếp cận sớm)

    EAPProperties không bắt buộc

    Chế độ cài đặt EAP của mạng. Bắt buộc để xác thực 8021X.

EthernetStateProperties

Thuộc tính

FoundNetworkProperties

Thuộc tính

  • LongName

    chuỗi không bắt buộc

    Tên định dạng dài của nhà mạng.

  • NetworkId

    chuỗi

    Mã mạng.

  • ShortName

    chuỗi không bắt buộc

    Tên viết tắt của nhà mạng.

  • Trạng thái

    chuỗi

    Phạm vi cung cấp mạng.

  • Công nghệ

    chuỗi

    Công nghệ truy cập mà mạng sử dụng.

GlobalPolicy

Thuộc tính

  • AllowOnlyPolicyNetworksToAutoconnect

    boolean không bắt buộc

    Nếu đúng, chỉ các mạng theo chính sách mới có thể tự động kết nối. Giá trị mặc định là false.

  • AllowOnlyPolicyNetworksToConnect

    boolean không bắt buộc

    Nếu đúng, thì chỉ những mạng theo chính sách mới có thể kết nối và không thể thêm hoặc định cấu hình mạng mới. Giá trị mặc định là false.

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    boolean không bắt buộc

    Chrome 70 trở lên

    Nếu bạn đặt thành true và có một mạng được quản lý trong danh sách mạng hiển thị, thì chỉ những mạng theo chính sách mới có thể kết nối và không thể thêm hoặc định cấu hình mạng mới. Giá trị mặc định là false.

  • BlockedHexSSIDs

    string[] không bắt buộc

    Chrome 86 trở lên

    Danh sách các mạng bị chặn. Không được phép kết nối với các mạng bị chặn. Bạn có thể bỏ chặn mạng bằng cách chỉ định một cấu hình mạng rõ ràng. Giá trị mặc định là danh sách trống.

IPConfigProperties

Thuộc tính

  • ExcludedRoutes

    string[] không bắt buộc

    Chrome 76 trở lên

    Mảng khối IP trong ký hiệu CIDR, hãy xem onc_spec.md để biết thông tin chi tiết.

  • Cổng

    chuỗi không bắt buộc

    Địa chỉ cổng được dùng cho cấu hình IP.

  • IPAddress

    chuỗi không bắt buộc

    Địa chỉ IP của một kết nối. Có thể là địa chỉ IPv4 hoặc IPv6, tuỳ thuộc vào giá trị của Type.

  • IncludedRoutes

    string[] không bắt buộc

    Chrome 76 trở lên

    Mảng khối IP trong ký hiệu CIDR, hãy xem onc_spec.md để biết thông tin chi tiết.

  • NameServers

    string[] không bắt buộc

    Mảng địa chỉ dùng cho máy chủ định danh.

  • RoutingPrefix

    number không bắt buộc

    Tiền tố định tuyến.

  • SearchDomains

    string[] không bắt buộc

    Chrome 76 trở lên

    Mảng chuỗi để phân giải tên, hãy xem onc_spec.md để biết thông tin chi tiết.

  • Loại

    chuỗi không bắt buộc

    Loại cấu hình IP. Có thể là IPv4 hoặc IPv6.

  • WebProxyAutoDiscoveryUrl

    chuỗi không bắt buộc

    URL cho tính năng Tự động phát hiện proxy web, như được báo cáo qua DHCP.

IPConfigType

Enum

"DHCP"

"Tĩnh"

IssuerSubjectPattern

Thuộc tính

  • CommonName

    chuỗi không bắt buộc

    Nếu được đặt, giá trị này sẽ được so khớp với tên chung của chủ thể chứng chỉ.

  • Thành phố

    chuỗi không bắt buộc

    Nếu được đặt, giá trị này sẽ được dùng để so khớp với vị trí chung của chủ thể chứng chỉ.

  • Tổ chức

    chuỗi không bắt buộc

    Nếu được đặt, giá trị này sẽ được dùng để so khớp với tổ chức của chủ thể chứng chỉ. Ít nhất một tổ chức phải khớp với giá trị này.

  • OrganizationalUnit

    chuỗi không bắt buộc

    Nếu được đặt, giá trị này sẽ được dùng để so khớp với các đơn vị tổ chức của chủ thể chứng chỉ. Ít nhất một đơn vị tổ chức phải khớp với giá trị này.

ManagedBoolean

Thuộc tính

  • Đang hoạt động

    boolean không bắt buộc

    Giá trị đang hoạt động mà trình quản lý cấu hình mạng (ví dụ: Shill) hiện đang sử dụng.

  • DeviceEditable

    boolean không bắt buộc

    Liệu có tồn tại DevicePolicy cho thuộc tính này và cho phép chỉnh sửa thuộc tính này hay không (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • DevicePolicy

    boolean không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn xác định giá trị thuộc tính có hiệu lực.

  • SharedSetting

    boolean không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu có tồn tại UserPolicy cho thuộc tính này và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất trong tập hợp chính sách). Giá trị mặc định là false.

  • UserPolicy

    boolean không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    boolean không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedCellularProperties

Thuộc tính

ManagedDOMString

Thuộc tính

  • Đang hoạt động

    chuỗi không bắt buộc

    Giá trị đang hoạt động mà trình quản lý cấu hình mạng (ví dụ: Shill) hiện đang sử dụng.

  • DeviceEditable

    boolean không bắt buộc

    Liệu có tồn tại DevicePolicy cho thuộc tính này và cho phép chỉnh sửa thuộc tính này hay không (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • DevicePolicy

    chuỗi không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn xác định giá trị thuộc tính có hiệu lực.

  • SharedSetting

    chuỗi không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu có tồn tại UserPolicy cho thuộc tính này và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất trong tập hợp chính sách). Giá trị mặc định là false.

  • UserPolicy

    chuỗi không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    chuỗi không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedDOMStringList

Thuộc tính

  • Đang hoạt động

    string[] không bắt buộc

    Giá trị đang hoạt động mà trình quản lý cấu hình mạng (ví dụ: Shill) hiện đang sử dụng.

  • DeviceEditable

    boolean không bắt buộc

    Liệu có tồn tại DevicePolicy cho thuộc tính này và cho phép chỉnh sửa thuộc tính này hay không (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • DevicePolicy

    string[] không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn xác định giá trị thuộc tính có hiệu lực.

  • SharedSetting

    string[] không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu có tồn tại UserPolicy cho thuộc tính này và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất trong tập hợp chính sách). Giá trị mặc định là false.

  • UserPolicy

    string[] không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    string[] không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedEthernetProperties

Thuộc tính

ManagedIPConfigProperties

Thuộc tính

ManagedIPConfigType

Thuộc tính

  • Đang hoạt động

    IPConfigType không bắt buộc

    Giá trị đang hoạt động mà trình quản lý cấu hình mạng (ví dụ: Shill) hiện đang sử dụng.

  • DeviceEditable

    boolean không bắt buộc

    Liệu có tồn tại DevicePolicy cho thuộc tính này và cho phép chỉnh sửa thuộc tính này hay không (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • DevicePolicy

    IPConfigType không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn xác định giá trị thuộc tính có hiệu lực.

  • SharedSetting

    IPConfigType không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu có tồn tại UserPolicy cho thuộc tính này và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất trong tập hợp chính sách). Giá trị mặc định là false.

  • UserPolicy

    IPConfigType không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    IPConfigType không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedLong

Thuộc tính

  • Đang hoạt động

    number không bắt buộc

    Giá trị đang hoạt động mà trình quản lý cấu hình mạng (ví dụ: Shill) hiện đang sử dụng.

  • DeviceEditable

    boolean không bắt buộc

    Liệu có tồn tại DevicePolicy cho thuộc tính này và cho phép chỉnh sửa thuộc tính này hay không (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • DevicePolicy

    number không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn xác định giá trị thuộc tính có hiệu lực.

  • SharedSetting

    number không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu có tồn tại UserPolicy cho thuộc tính này và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất trong tập hợp chính sách). Giá trị mặc định là false.

  • UserPolicy

    number không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    number không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedManualProxySettings

Thuộc tính

ManagedProperties

Thuộc tính

ManagedProxyLocation

Thuộc tính

ManagedProxySettings

Thuộc tính

ManagedProxySettingsType

Thuộc tính

  • Đang hoạt động

    ProxySettingsType không bắt buộc

    Giá trị đang hoạt động mà trình quản lý cấu hình mạng (ví dụ: Shill) hiện đang sử dụng.

  • DeviceEditable

    boolean không bắt buộc

    Liệu có tồn tại DevicePolicy cho thuộc tính này và cho phép chỉnh sửa thuộc tính này hay không (tức là chính sách đặt giá trị thuộc tính được đề xuất). Giá trị mặc định là false.

  • DevicePolicy

    ProxySettingsType không bắt buộc

    Giá trị thuộc tính do chính sách thiết bị cung cấp.

  • Có hiệu lực

    chuỗi không bắt buộc

    Nguồn xác định giá trị thuộc tính có hiệu lực.

  • SharedSetting

    ProxySettingsType không bắt buộc

    Giá trị được đặt cho tất cả người dùng thiết bị. Chỉ được cung cấp nếu DeviceEditiable là true.

  • UserEditable

    boolean không bắt buộc

    Liệu có tồn tại UserPolicy cho thuộc tính này và cho phép chỉnh sửa thuộc tính hay không (tức là giá trị thuộc tính được đề xuất trong tập hợp chính sách). Giá trị mặc định là false.

  • UserPolicy

    ProxySettingsType không bắt buộc

    Giá trị thuộc tính do chính sách người dùng cung cấp.

  • UserSetting

    ProxySettingsType không bắt buộc

    Giá trị thuộc tính do người dùng đã đăng nhập đặt. Chỉ được cung cấp nếu UserEditable là true.

ManagedThirdPartyVPNProperties

Thuộc tính

ManagedVPNProperties

Thuộc tính

ManagedWiFiProperties

Thuộc tính

ManualProxySettings

Thuộc tính

  • FTPProxy

    ProxyLocation không bắt buộc

    Chế độ cài đặt cho proxy FTP.

  • HTTPProxy

    ProxyLocation không bắt buộc

    Chế độ cài đặt cho proxy HTTP.

  • SOCKS

    ProxyLocation không bắt buộc

    Chế độ cài đặt cho proxy SOCKS.

  • SecureHTTPProxy

    ProxyLocation không bắt buộc

    Chế độ cài đặt cho proxy HTTP bảo mật.

NetworkConfigProperties

Thuộc tính

NetworkFilter

Thuộc tính

  • đã định cấu hình

    boolean không bắt buộc

    Nếu đúng, chỉ bao gồm các mạng đã định cấu hình (đã lưu). Giá trị mặc định là "false".

  • giới hạn

    number không bắt buộc

    Số lượng mạng tối đa cần trả về. Giá trị mặc định là 1000 nếu không được chỉ định. Nhập 0 để không giới hạn.

  • networkType

    NetworkType

    Loại mạng cần trả về.

  • hiển thị

    boolean không bắt buộc

    Nếu đúng, chỉ bao gồm các mạng hiển thị (đã kết nối thực tế hoặc trong phạm vi). Giá trị mặc định là "false".

NetworkProperties

Thuộc tính

  • Mạng di động

    CellularProperties không bắt buộc

    Đối với mạng di động, các thuộc tính của mạng di động.

  • Có thể kết nối

    boolean không bắt buộc

    Mạng có kết nối được hay không.

  • ConnectionState

    ConnectionStateType không bắt buộc

    Trạng thái kết nối hiện tại của mạng.

  • ErrorState

    chuỗi không bắt buộc

    Trạng thái lỗi mạng được ghi lại gần đây nhất.

  • Ethernet

    EthernetProperties không bắt buộc

    Đối với mạng Ethernet, các thuộc tính của mạng Ethernet.

  • GUID

    chuỗi

    Mã GUID của mạng.

  • IPAddressConfigType

    IPConfigType không bắt buộc

    Loại cấu hình địa chỉ IP của mạng.

  • IPConfigs

    IPConfigProperties[] không bắt buộc

    Cấu hình IP của mạng.

  • MacAddress

    chuỗi không bắt buộc

    Địa chỉ MAC của mạng.

  • Đo lượng dữ liệu

    boolean không bắt buộc

    Chrome 85 trở lên

    Mạng có được đo lượng dữ liệu hay không.

  • Tên

    chuỗi không bắt buộc

    Tên mạng thân thiện với người dùng.

  • NameServersConfigType

    IPConfigType không bắt buộc

    Loại cấu hình IP cho máy chủ định danh mà mạng sử dụng.

  • Mức độ ưu tiên

    number không bắt buộc

    Mức độ ưu tiên của mạng.

  • ProxySettings

    ProxySettings không bắt buộc

    Chế độ cài đặt proxy của mạng.

  • RestrictedConnectivity

    boolean không bắt buộc

    Đối với mạng đã kết nối, cho biết liệu khả năng kết nối mạng với Internet có bị giới hạn hay không, ví dụ: nếu mạng nằm sau một cổng hoặc mạng di động chưa được kích hoạt.

  • SavedIPConfig

    IPConfigProperties không bắt buộc

    Cấu hình IP nhận được từ máy chủ DHCP trước khi áp dụng cấu hình IP tĩnh.

  • Nguồn

    chuỗi không bắt buộc

    Cho biết liệu mạng có được định cấu hình hay không và cách định cấu hình. Các giá trị có thể là:

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    "None" xung đột với việc tạo mã tiện ích, vì vậy, chúng ta phải sử dụng một chuỗi cho "Source" thay vì enum SourceType.

  • StaticIPConfig

    IPConfigProperties không bắt buộc

    Cấu hình IP tĩnh của mạng.

  • TrafficCounterResetTime

    number không bắt buộc

    Chrome 125 trở lên

    Lần gần đây nhất đặt lại bộ đếm lưu lượng truy cập.

  • Loại

    NetworkType

    Loại mạng.

  • VPN

    VPNProperties không bắt buộc

    Đối với mạng VPN, các thuộc tính VPN của mạng.

  • Wi-Fi

    WiFiProperties không bắt buộc

    Đối với mạng Wi-Fi, các thuộc tính Wi-Fi của mạng.

NetworkStateProperties

Thuộc tính

NetworkType

Enum

"Tất cả"

"Mạng di động"

"Ethernet"

"Tether"

"VPN"

"Không dây"

"Wi-Fi"

PaymentPortal

Thuộc tính

  • Phương thức

    chuỗi

    Phương thức HTTP để sử dụng cho cổng thanh toán.

  • PostData

    chuỗi không bắt buộc

    Dữ liệu bài đăng cần gửi đến cổng thanh toán. Bỏ qua trừ khi Method là POST.

  • URL

    chuỗi không bắt buộc

    URL của cổng thanh toán.

ProxyLocation

Thuộc tính

  • Máy chủ

    chuỗi

    Máy chủ lưu trữ địa chỉ IP của proxy.

  • Cổng

    số

    Cổng dùng cho proxy.

ProxySettings

Thuộc tính

  • ExcludeDomains

    string[] không bắt buộc

    Các miền và máy chủ lưu trữ không áp dụng chế độ cài đặt proxy thủ công.

  • Thủ công

    ManualProxySettings không bắt buộc

    Chế độ cài đặt proxy thủ công – chỉ dùng cho chế độ cài đặt proxy Manual.

  • Uỷ ban hành động chính trị (PAC)

    chuỗi không bắt buộc

    URL cho tệp cấu hình tự động proxy.

  • Loại chế độ cài đặt proxy.

ProxySettingsType

Enum

"Trực tiếp"

"Thủ công"

"PAC"

"WPAD"

SIMLockStatus

Thuộc tính

  • LockEnabled

    boolean

    Liệu tính năng khoá SIM có được bật hay không.

  • LockType

    chuỗi

    Trạng thái khoá SIM – các giá trị có thể là 'sim-pin', 'sim-puk' và ''.

  • RetriesLeft

    number không bắt buộc

    Số lần thử nhập mã PIN để mở khoá được cho phép trước khi cần nhập mã PUK để mở khoá SIM.

ThirdPartyVPNProperties

Thuộc tính

  • ExtensionID

    chuỗi

    Mã của tiện ích nhà cung cấp VPN bên thứ ba.

  • ProviderName

    chuỗi không bắt buộc

    Tên nhà cung cấp VPN.

VPNProperties

Thuộc tính

  • AutoConnect

    boolean không bắt buộc

    Liệu mạng VPN có tự động kết nối hay không.

  • Máy chủ

    chuỗi không bắt buộc

    Máy chủ VPN.

  • Loại

    chuỗi không bắt buộc

    Loại VPN. Đây không thể là enum vì "L2TP-IPSec". Đây là thuộc tính không bắt buộc đối với NetworkConfigProperties được truyền đến setProperties, có thể dùng để chỉ đặt các thuộc tính cụ thể.

VPNStateProperties

Thuộc tính

WiFiProperties

Thuộc tính

  • AllowGatewayARPPolling

    boolean không bắt buộc

    Ngừng sử dụng kể từ Chrome 131

    Đã bị xoá trong phiên bản M131. Hiện không có cuộc thăm dò ý kiến nào đang diễn ra về ARP.

  • AutoConnect

    boolean không bắt buộc

    Liệu có nên tự động kết nối với mạng Wi-Fi khi nằm trong phạm vi phủ sóng hay không.

  • BSSID (mã định danh của bộ dịch vụ cơ bản)

    chuỗi không bắt buộc

    BSSID của điểm truy cập được liên kết.

  • EAP (chương trình tiếp cận sớm)

    EAPProperties không bắt buộc

    Thuộc tính EAP của mạng. Bắt buộc đối với mạng WEP-8021X và WPA-EAP.

  • Tần suất

    number không bắt buộc

    Tần số hoạt động của dịch vụ Wi-Fi tính bằng MHz. Đối với các mạng đã kết nối, đây là tần số hiện tại mà mạng đang kết nối. Nếu không, tần số của BSS tốt nhất hiện có.

  • FrequencyList

    number[] không bắt buộc

    Chứa tất cả tần số hoạt động được ghi nhận gần đây cho mạng Wi-Fi.

  • HexSSID

    chuỗi không bắt buộc

    Bản sao được mã hoá HEX của SSID mạng.

  • HiddenSSID

    boolean không bắt buộc

    Liệu SSID của mạng có được hiển thị hay không.

  • Cụm mật khẩu

    chuỗi không bắt buộc

    Chrome 66 trở lên

    Cụm mật khẩu cho kết nối WEP/WPA/WPA2. Bạn chỉ có thể đặt thuộc tính này – các thuộc tính do getProperties trả về sẽ không chứa giá trị này.

  • RoamThreshold

    number không bắt buộc

    Không dùng nữa, bị bỏ qua.

  • SSID

    chuỗi không bắt buộc

    SSID của mạng.

  • Bảo mật

    chuỗi không bắt buộc

    Loại bảo mật mạng.

  • SignalStrength

    number không bắt buộc

    Cường độ tín hiệu mạng.

WiFiStateProperties

Thuộc tính

WiMAXProperties

Thuộc tính

  • AutoConnect

    boolean không bắt buộc

    Liệu có nên tự động kết nối mạng hay không.

  • EAP (chương trình tiếp cận sớm)

    EAPProperties không bắt buộc

    Thuộc tính EAP của mạng.

Phương thức

createNetwork()

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

Tạo cấu hình mạng mới từ các thuộc tính. Nếu đã có một mạng được định cấu hình phù hợp, thì thao tác này sẽ không thành công. Nếu không, hãy trả về GUID của mạng mới.

Thông số

  • đã chia sẻ

    boolean

    Nếu true, hãy chia sẻ cấu hình mạng này với những người dùng khác.

    Lựa chọn này chỉ hiển thị trên Giao diện người dùng web của Chrome.* Khi được ứng dụng gọi, false là giá trị duy nhất được cho phép.

  • Các thuộc tính để định cấu hình mạng mới.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (result: string) => void

    • kết quả

      chuỗi

Giá trị trả về

  • <string> hứa hẹn

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

disableNetworkType()

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

Tắt mọi thiết bị khớp với loại mạng được chỉ định. Xem ghi chú cho enableNetworkType.

Thông số

enableNetworkType()

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

Bật mọi thiết bị khớp với loại mạng được chỉ định. Lưu ý: loại này có thể đại diện cho nhiều loại mạng (ví dụ: "Không dây").

Thông số

forgetNetwork()

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

Xoá cấu hình mạng bằng cách xoá mọi thuộc tính đã định cấu hình cho mạng có GUID networkGuid. Điều này cũng có thể bao gồm mọi mạng khác có giá trị nhận dạng trùng khớp (ví dụ: SSID và Bảo mật Wi-Fi). Nếu không có cấu hình nào như vậy, thì hệ thống sẽ đặt lỗi và thao tác sẽ không thành công.

Trong phiên kiosk, phương thức này sẽ không thể quên cấu hình mạng dùng chung.

Thông số

  • networkGuid

    chuỗi

    Mã GUID của mạng cần xoá.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getCaptivePortalStatus()

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

Trả về trạng thái trang xác thực cho mạng khớp với "networkGuid".

Thông số

  • networkGuid

    chuỗi

    Mã GUID của mạng để lấy trạng thái trang xác thực.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (result: CaptivePortalStatus) => void

Giá trị trả về

  • Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getDeviceStates()

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

Trả về trạng thái của các thiết bị mạng hiện có.

Thông số

Giá trị trả về

  • Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getGlobalPolicy()

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

Lấy các thuộc tính chính sách chung. Các thuộc tính này dự kiến sẽ không thay đổi trong một phiên.

Thông số

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (result: GlobalPolicy) => void

Giá trị trả về

  • Promise<GlobalPolicy>

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getManagedProperties()

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

Lấy các thuộc tính đã hợp nhất của mạng có mã networkGuid từ các nguồn: Chế độ cài đặt của người dùng, cài đặt cách chia sẻ, chính sách người dùng, chính sách thiết bị và chế độ cài đặt đang hoạt động.

Thông số

  • networkGuid

    chuỗi

    Mã GUID của mạng để lấy các thuộc tính.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (result: ManagedProperties) => void

Giá trị trả về

  • Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getNetworks()

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

Trả về danh sách các đối tượng mạng có cùng thuộc tính do getState cung cấp. Bộ lọc được cung cấp để chỉ định loại mạng được trả về và giới hạn số lượng mạng. Hệ thống sắp xếp các mạng theo mức độ ưu tiên, trong đó các mạng đã kết nối hoặc đang kết nối được liệt kê trước tiên.

Thông số

Giá trị trả về

  • Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getProperties()

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

Lấy tất cả thuộc tính của mạng có mã nhận dạng networkGuid. Bao gồm tất cả thuộc tính của mạng (giá trị chỉ đọc và giá trị đọc/ghi).

Thông số

  • networkGuid

    chuỗi

    Mã GUID của mạng để lấy các thuộc tính.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (result: NetworkProperties) => void

Giá trị trả về

  • Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

getState()

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

Lấy các thuộc tính chỉ đọc được lưu vào bộ nhớ đệm của mạng có mã nhận dạng networkGuid. Hàm này được thiết kế để có hiệu suất cao hơn getProperties, vốn yêu cầu một lượt khứ hồi để truy vấn hệ thống con của mạng. Các thuộc tính sau được trả về cho tất cả mạng: GUID, Loại, Tên, WiFi.Security. Các thuộc tính bổ sung được cung cấp cho các mạng hiển thị: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.

Thông số

  • networkGuid

    chuỗi

    Mã GUID của mạng để lấy các thuộc tính.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    (result: NetworkStateProperties) => void

Giá trị trả về

  • Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

requestNetworkScan()

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

Yêu cầu hệ thống con của mạng quét tìm mạng mới và cập nhật danh sách do getVisibleNetworks trả về. Đây chỉ là một yêu cầu: hệ thống con của mạng có thể chọn bỏ qua yêu cầu này. Nếu danh sách được cập nhật, thì sự kiện onNetworkListChanged sẽ được kích hoạt.

Thông số

  • networkType

    NetworkType không bắt buộc

    Chrome 63 trở lên

    Nếu được cung cấp, thì yêu cầu quét theo loại cụ thể. Đối với mạng di động, hệ thống sẽ yêu cầu quét mạng di động nếu được hỗ trợ.

setProperties()

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

Đặt thuộc tính của mạng có mã nhận dạng networkGuid. Trường này chỉ hợp lệ đối với các mạng đã định cấu hình (Nguồn != Không có). Thay vào đó, các mạng hiển thị chưa được định cấu hình nên sử dụng createNetwork. Trong phiên kiosk, việc gọi phương thức này trên mạng dùng chung sẽ không thành công.

Thông số

  • networkGuid

    chuỗi

    Mã GUID của mạng để đặt thuộc tính.

  • Các thuộc tính cần đặt.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

startConnect()

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

Bắt đầu kết nối với mạng có networkGuid.

Thông số

  • networkGuid

    chuỗi

    Mã GUID của mạng cần kết nối.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

startDisconnect()

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

Bắt đầu ngắt kết nối khỏi mạng bằng networkGuid.

Thông số

  • networkGuid

    chuỗi

    Mã GUID của mạng cần ngắt kết nối.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

Sự kiện

onDeviceStateListChanged

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

Được kích hoạt khi danh sách thiết bị thay đổi hoặc bất kỳ thuộc tính trạng thái nào của thiết bị thay đổi.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    () => void

onNetworkListChanged

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

Được kích hoạt khi danh sách mạng thay đổi. Gửi danh sách đầy đủ các GUID cho tất cả mạng hiện tại.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    (changes: string[]) => void

    • các thay đổi

      string[]

onNetworksChanged

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

Được kích hoạt khi các thuộc tính thay đổi trên bất kỳ mạng nào. Gửi danh sách GUID cho các mạng có thuộc tính đã thay đổi.

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    (changes: string[]) => void

    • các thay đổi

      string[]

onPortalDetectionCompleted

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

Được kích hoạt khi quá trình phát hiện cổng thông tin cho một mạng hoàn tất. Gửi GUID của mạng và trạng thái trang xác thực tương ứng.

Thông số