A utility type for ignoring certificate errors or rejecting erroneous certificates.More...
| Import Statement: | import QtWebEngine 1.10 |
| Since: | QtWebEngine 1.1 |
This QML type contains information about a certificate error that occurred. Theerror property holds the reason that the error occurred and thedescription property holds a short localized description of the error. Theurl property holds the URL that triggered the error.
The certificate can be rejected by callingrejectCertificate, which will stop loading the web engine request. By default, an invalid certificate will be automatically rejected.
The certificate error can be ignored by callingignoreCertificateError, which will resume loading the request.
It is possible to defer the decision of rejecting a certificate by callingdefer, which is useful when waiting for user input.
See alsoWebEngineView::certificateError.
[read-only]description :string |
A short localized human-readable description of the error.
[read-only]error :enumeration |
The type of the error.
| Constant | Description |
|---|---|
WebEngineCertificateError.SslPinnedKeyNotInCertificateChain | The certificate did not match the built-in public keys pinned for the host name. |
WebEngineCertificateError.CertificateCommonNameInvalid | The certificate's common name did not match the host name. |
WebEngineCertificateError.CertificateDateInvalid | The certificate is not valid at the current date and time. |
WebEngineCertificateError.CertificateAuthorityInvalid | The certificate is not signed by a trusted authority. |
WebEngineCertificateError.CertificateContainsErrors | The certificate contains errors. |
WebEngineCertificateError.CertificateNoRevocationMechanism | The certificate has no mechanism for determining if it has been revoked. |
WebEngineCertificateError.CertificateUnableToCheckRevocation | Revocation information for the certificate is not available. |
WebEngineCertificateError.CertificateRevoked | The certificate has been revoked. |
WebEngineCertificateError.CertificateInvalid | The certificate is invalid. |
WebEngineCertificateError.CertificateWeakSignatureAlgorithm | The certificate is signed using a weak signature algorithm. |
WebEngineCertificateError.CertificateNonUniqueName | The host name specified in the certificate is not unique. |
WebEngineCertificateError.CertificateWeakKey | The certificate contains a weak key. |
WebEngineCertificateError.CertificateNameConstraintViolation | The certificate claimed DNS names that are in violation of name constraints. |
WebEngineCertificateError.CertificateValidityTooLong | The certificate has a validity period that is too long. (Added in 5.7) |
WebEngineCertificateError.CertificateTransparencyRequired | Certificate Transparency was required for this connection, but the server did not provide CT information that complied with the policy. (Added in 5.8) |
WebEngineCertificateError.CertificateKnownInterceptionBlocked | The certificate is known to be used for interception by an entity other the device owner. (Added in 5.15) |
[read-only]overridable :bool |
A boolean that indicates whether the certificate error can be overridden and ignored.
[read-only]url :url |
The URL that triggered the error.
This function should be called when there is a need to postpone the decision whether to ignore a certificate error, for example, while waiting for user input. When called, the function pauses the URL request untilWebEngineCertificateError::ignoreCertificateError() orWebEngineCertificateError::rejectCertificate() is called.
The certificate error is ignored, and the web engine view continues to load the requested URL.
The certificate is rejected, and the web engine view stops loading the requested URL.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of theGNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
Qt Group includes The Qt Company Oy and its global subsidiaries and affiliates.
