Synopsis#

Static functions#

def setDnsMode()

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description#

The QWebEngineGlobalSettings namespace holds global properties of the web engine.

Invoke setDnsMode() to configure DNS-over-HTTPS.

See also

setDnsMode()

class SecureDnsMode#

This enum sets the DNS-over-HTTPS mode used by the DnsMode structure:

Constant

Description

QWebEngineGlobalSettings.SecureDnsMode.SystemOnly

This is the default. Use the system DNS host resolution.

QWebEngineGlobalSettings.SecureDnsMode.SecureWithFallback

Enable DNS-over-HTTPS (DoH). DoH servers have to be provided through serverTemplates in the DnsMode structure. If a host cannot be resolved via the provided servers, the system DNS host resolution is used.

QWebEngineGlobalSettings.SecureDnsMode.SecureOnly

Enable DNS-over-HTTPS and only allow hosts to be resolved this way. DoH servers have to be provided through serverTemplates in the DnsMode structure. If the DNS-over-HTTPS resolution fails, there is no fallback and the DNS host resolution fails completely.

Constant	Description
QWebEngineGlobalSettings.SecureDnsMode.SystemOnly	This is the default. Use the system DNS host resolution.
QWebEngineGlobalSettings.SecureDnsMode.SecureWithFallback	Enable DNS-over-HTTPS (DoH). DoH servers have to be provided through serverTemplates in the `DnsMode` structure. If a host cannot be resolved via the provided servers, the system DNS host resolution is used.
QWebEngineGlobalSettings.SecureDnsMode.SecureOnly	Enable DNS-over-HTTPS and only allow hosts to be resolved this way. DoH servers have to be provided through serverTemplates in the `DnsMode` structure. If the DNS-over-HTTPS resolution fails, there is no fallback and the DNS host resolution fails completely.

static setDnsMode(dnsMode)#

Parameters:: dnsMode – DnsMode
Return type:: bool

Sets dnsMode for DNS-over-HTTPS host resolution.

This function returns false if the serverTemplates list in the DnsMode structure is empty or contains URI templates that cannot be parsed for SecureOnly or SecureWithFallback . Otherwise, it returns true meaning that the DNS mode change is triggered.