badCertificateCallback 属性

void badCertificateCallback=(bool callback(X509Certificate cert, String host, int port)?)

设置一个回调函数，该函数将决定是否接受一个无法通过我们的受信任根证书认证的服务器证书的加密连接。

当使用此 HttpClient 发起一个安全的 HTTP 请求，并且服务器返回一个无法认证的服务器证书时，回调函数将异步调用，并传递 X509Certificate 对象以及服务器的域名和端口。如果 badCertificateCallback 的值为 null，则拒绝无效的证书，就像回调返回了 false 一样。

如果回调返回 true，则接受安全连接，并且从调用请求返回的 Future<HttpClientRequest> 完成与有效的 HttpRequest 对象。如果回调返回 false，则 Future<HttpClientRequest> 完成时带有异常。

如果在连接尝试中收到无效证书，则库会调用在请求时 badCertificateCallback 的值对应的函数，即使此后 badCertificateCallback 的值已经改变。

实现

void set badCertificateCallback(
    bool Function(X509Certificate cert, String host, int port)? callback);