findProxy w Darcie oczekuje dyrektywy trasowania

HttpClient z dart:io przyjmuje decyzję o proxy przez findProxy. Funkcja zwrotna zwraca dyrektywę w stylu PAC:

import 'dart:io';

final client = HttpClient()
  ..findProxy = (_) => 'PROXY proxy.example.net:8080';

Użyj tego klienta do żądań aplikacji. Zwracanie http://proxy.example.net:8080 to zły format dla tej funkcji; obsługiwaną formą jest PROXY, po którym następuje host i port. Dla dozwolonych żądań publicznych weź kandydata HTTP z listy proxy HTTP i sformatuj go jako tę dyrektywę.

Funkcja zwrotna otrzymuje URI celu, więc może zwrócić DIRECT przy zamierzonym obejściu. Wynik taki jak PROXY proxy.example.net:8080; DIRECT pozwala też na bezpośrednie obejście, gdy proxy jest niedostępne. Pomiń DIRECT, gdy to obejście nie jest pożądane.

Bez funkcji findProxy to API używa połączeń bezpośrednich. Aplikacje chcące wyboru opartego na środowisku mogą przypisać HttpClient.findProxyFromEnvironment do funkcji zwrotnej.

Dotyczy to kodu Fluttera używającego dart:io na obsługiwanych platformach natywnych. Żądania Flutter Web korzystają z możliwości sieciowych przeglądarki i wymagają jej polityki proxy.