chrome.networking.onc

Mô tả

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

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).

LƯU Ý: Hầu hết các thuộc tính từ điển và giá trị enum đều sử dụng quy ước viết hoa UpperCamelCase để khớp với quy cách ONC thay vì quy ước viết hoa 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"

"Không có mạng"

"Trực tuyến"

"Cổng thông tin"

"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 của 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 mạng di động có được tự động kết nối hay không (khi nằm trong vùng phủ só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 cài đặt 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ã kiểu modem di động.

  • NetworkTechnology

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

    Nếu modem được đăng ký trên 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 các mạng gia đình GSM.

  • SIMPresent

    boolean không bắt buộc

    Liệu 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 đang đăng ký.

  • SignalStrength

    số 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

    Liệu mạng di động có hỗ trợ tính năng quét hay không.

CellularProviderProperties

Thuộc tính

  • Mã

    chuỗi

    Mã nhận dạng mạng di động là một chuỗi kết hợp đơn giản của MCC (Mã quốc gia cho mạng di động) 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 của toán tử.

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 sẽ so khớp với chế độ cài đặt của tổ chức phát hành X.509.

  • 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 do 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 sẽ so khớp với chế độ cài đặt chủ đề X.509.

ClientCertificateType

Enum

"Tham chiếu"

"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 hiện tại của SIM nếu loại thiết bị là Di động.

  • Đang quét

    boolean không bắt buộc

    Đặt nếu thiết bị được bật. Đú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 được liên kết với thiết bị (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" (Tắt)
Thiết bị được khởi chạy nhưng chưa bật.

"Đang bật"
Trạng thái đã bật nhưng chưa hoàn tất.

"Đã bật"
Thiết bị đã 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

  • 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

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

  • EAP

    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 ở định dạng ngắn của nhà mạng.

  • Trạng thái

    chuỗi

    Tình trạng có 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ỉ những mạng chính sách mới có thể tự động kết nối. Giá trị mặc định là sai.

  • AllowOnlyPolicyNetworksToConnect

    boolean không bắt buộc

    Nếu đúng, bạn chỉ có thể kết nối với các mạng theo chính sách 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 đúng và có mạng được quản lý trong danh sách mạng hiển thị, thì bạn chỉ có thể kết nối với các mạng theo chính sách và không thể thêm hoặc định cấu hình mạng mới. Giá trị mặc định là sai.

  • BlockedHexSSIDs

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

    Chrome 86 trở lên

    Danh sách các mạng bị chặn. Nghiêm cấm kết nối với các mạng bị chặn. Bạn có thể bỏ chặn lại các 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 các khối IP theo 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 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 các khối IP theo 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ủ tên.

  • RoutingPrefix

    số 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 các 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"

"Static" (Tĩnh)

IssuerSubjectPattern

Thuộc tính

  • CommonName

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

    Nếu được đặt, giá trị để so khớp với tên phổ biến của chủ thể chứng chỉ.

  • Thành phố

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

    Nếu được đặt, giá trị để so khớp với vị trí phổ biến của chủ thể chứng chỉ.

  • Tổ chức

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

    Nếu được đặt, giá trị để so khớp với các 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ị để 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 hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu có DevicePolicy cho tài sản hay không và cho phép chỉnh sửa tài sản (tức là chính sách đã đặt giá trị tài sản đượ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 hiệu quả.

  • 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ó UserPolicy cho tài sản hay không và cho phép chỉnh sửa tài sản (tức là chính sách đã đặt giá trị tài sản được đề xuất). 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 hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu có DevicePolicy cho tài sản hay không và cho phép chỉnh sửa tài sản (tức là chính sách đã đặt giá trị tài sản đượ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 hiệu quả.

  • 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ó UserPolicy cho tài sản hay không và cho phép chỉnh sửa tài sản (tức là chính sách đã đặt giá trị tài sản được đề xuất). 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 hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu có DevicePolicy cho tài sản hay không và cho phép chỉnh sửa tài sản (tức là chính sách đã đặt giá trị tài sản đượ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 hiệu quả.

  • 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ó UserPolicy cho tài sản hay không và cho phép chỉnh sửa tài sản (tức là chính sách đã đặt giá trị tài sản được đề xuất). 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 hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu có DevicePolicy cho tài sản hay không và cho phép chỉnh sửa tài sản (tức là chính sách đã đặt giá trị tài sản đượ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 hiệu quả.

  • 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ó UserPolicy cho tài sản hay không và cho phép chỉnh sửa tài sản (tức là chính sách đã đặt giá trị tài sản được đề xuất). 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

    số không bắt buộc

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

  • DeviceEditable

    boolean không bắt buộc

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

  • DevicePolicy

    số 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 hiệu quả.

  • SharedSetting

    số 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ó UserPolicy cho tài sản hay không và cho phép chỉnh sửa tài sản (tức là chính sách đã đặt giá trị tài sản được đề xuất). Giá trị mặc định là false.

  • UserPolicy

    số 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

    số 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 hiện được trình quản lý cấu hình mạng sử dụng (ví dụ: Shill).

  • DeviceEditable

    boolean không bắt buộc

    Liệu có DevicePolicy cho tài sản hay không và cho phép chỉnh sửa tài sản (tức là chính sách đã đặt giá trị tài sản đượ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 hiệu quả.

  • 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ó UserPolicy cho tài sản hay không và cho phép chỉnh sửa tài sản (tức là chính sách đã đặt giá trị tài sản được đề xuất). 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

    số không bắt buộc

    Số lượng mạng tối đa cần trả về. Mặc định là 1000 nếu bạn không chỉ định. Sử dụng 0 để không có 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, thuộc tính mạng di động.

  • Có thể kết nối

    boolean không bắt buộc

    Liệu có thể kết nối mạng 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 mạng Ethernet.

  • GUID

    chuỗi

    Mã nhận dạng duy nhất (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

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

  • Tên

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

    Tên mạng dễ hiểu đối với người dùng.

  • NameServersConfigType

    IPConfigType không bắt buộc

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

  • Mức độ ưu tiên

    số 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, liệu khả năng kết nối mạng với Internet có bị hạn chế hay không, ví dụ: nếu mạng nằm sau một trang xác thực 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

    số 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ả"

"Di động"

"Ethernet"

"Kết nối Internet qua USB"

"VPN"

"Không dây"

"Wi-Fi"

PaymentPortal

Thuộc tính

  • Phương thức

    chuỗi

    Phương thức HTTP cần 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 để sử 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ủ 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 của tệp tự động định cấu hình 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

    số không bắt buộc

    Số lần nhập mã PIN được phép trước khi phải 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ó đượ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à một enum do "L2TP-IPSec". Bạn không bắt buộc phải sử dụng NetworkConfigProperties được truyền đến setProperties. Bạn có thể sử dụng setProperties để 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

    Đã xoá trong M131. Hiện không có hoạt động thăm dò ARP nào đang diễn ra.

  • AutoConnect

    boolean không bắt buộc

    Liệu mạng Wi-Fi có được tự động kết nối khi ở trong phạm vi 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

    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

    số 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, tần số hiện tại mà mạng được kết nối. Nếu không, tần suất 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 gần đây của mạng WiFi.

  • 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 phát 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 các 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

    số 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

    số 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 mạng có được tự động kết nối hay không.

  • EAP

    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,
)

Tạo cấu hình mạng mới từ các tài sản. 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.

Tham số

  • đã chia sẻ

    boolean

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

    Tuỳ chọn này chỉ hiển thị cho 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 phép.

  • các tài sản

    NetworkConfigProperties

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

  • lệnh gọi lại

    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ề

  • Promise<string>

    Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Tệp kê khai 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,
)

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

Tham số

enableNetworkType()

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

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

Tham số

forgetNetwork()

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

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. Danh sách 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 như vậy, hệ thống sẽ đặt lỗi và thao tác sẽ không thành công.

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

Tham số

  • networkGuid

    chuỗi

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

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

Trả về trạng thái của trang xác thực yêu cầu đăng nhập cho mạng khớp với "networkGuid".

Tham số

  • networkGuid

    chuỗi

    Mã nhận dạng duy nhất (GUID) của mạng để nhận trạng thái trang xác thực.

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

Trả về trạng thái của các thiết bị kết nối mạng có sẵn.

Tham số

Giá trị trả về

  • Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Tệp kê khai 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,
)

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.

Tham số

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

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

Tham số

  • networkGuid

    chuỗi

    Mã nhận dạng duy nhất (GUID) của mạng để lấy các thuộc tính.

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

Trả về danh sách các đối tượng mạng có cùng thuộc tính do getState cung cấp. Một 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.

Tham số

Giá trị trả về

  • Chrome 125 trở lên

    Lời hứa chỉ được hỗ trợ cho Tệp kê khai 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,
)

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ả các thuộc tính của mạng (giá trị chỉ đọc và đọc/ghi).

Tham số

  • networkGuid

    chuỗi

    Mã nhận dạng duy nhất (GUID) của mạng để lấy các thuộc tính.

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

Lấy các thuộc tính chỉ có thể đọc được lưu vào bộ nhớ đệm của mạng có mã networkGuid. Đây là hàm có hiệu suất cao hơn getProperties, yêu cầu một lượt truy vấn hệ thống con mạng. Các thuộc tính sau đây đượ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.

Tham số

  • networkGuid

    chuỗi

    Mã nhận dạng duy nhất (GUID) của mạng để lấy các thuộc tính.

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

Yêu cầu hệ thống con kết nối mạng quét tìm các 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 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.

Tham số

  • networkType

    NetworkType không bắt buộc

    Chrome 63 trở lên

    Yêu cầu quét dành riêng cho loại đó (nếu được cung cấp). Đối với 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,
)

Đặt các thuộc tính của mạng có mã networkGuid. Trường này chỉ hợp lệ cho các mạng đã định cấu hình (Source != None). 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 các 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.

Tham số

  • networkGuid

    chuỗi

    Mã nhận dạng duy nhất (GUID) của mạng để đặt thuộc tính.

  • các tài sản

    NetworkConfigProperties

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

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

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

Tham số

  • networkGuid

    chuỗi

    Mã nhận dạng duy nhất (GUID) của mạng cần kết nối.

  • lệnh gọi lại

    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 Tệp kê khai 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,
)

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

Tham số

  • networkGuid

    chuỗi

    Mã nhận dạng duy nhất (GUID) của mạng cần ngắt kết nối.

  • lệnh gọi lại

    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 Tệp kê khai 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 thiết bị nào thay đổi.

Tham số

  • lệnh gọi lại

    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.

Tham số

  • lệnh gọi lại

    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 những mạng có thuộc tính đã thay đổi.

Tham số

  • lệnh gọi lại

    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 trang xác thực 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.

Tham số