Konfigurowanie tras powrotu

Ukończone

W aplikacji frontonu po stronie klienta istnieje trasa /products, która wyświetla listę produktów na liście zakupów. Po przejściu do /products w aplikacji, wybierając link Produkty, pasek adresu przeglądarki potwierdza, że jesteś w /products. Kiedy odświeżasz przeglądarkę, wyświetlając tę stronę, chcesz odświeżyć i ponownie wyświetlić produkty. Jednak bez trasy powrotnej zostanie wyświetlony błąd 404 z informacją, że nie można odnaleźć strony.

Po odświeżeniu strony zobaczysz błąd 404, ponieważ przeglądarka wysyła żądanie do platformy hostingu, aby obsłużyć trasę /products. Nie ma jednak strony na serwerze o nazwie products to serve.

Na szczęście można łatwo rozwiązać ten problem, tworząc trasę rezerwową. Trasa rezerwowa to trasa, która paruje wszystkie niedopasowane żądania stron do serwera.

Konfigurowanie trasy powrotu

Usługa Azure Static Web Apps obsługuje niestandardowe reguły routingu zdefiniowane w opcjonalnym pliku staticwebapp.config.json znajdującym się w folderze źródłowym aplikacji. Trasę rezerwową nawigacji można zdefiniować w obiekcie navigationFallback . Typowa konfiguracja trasy rezerwowej wygląda następująco: w tym przykładzie.

{
  "navigationFallback": {
    "rewrite": "/index.html",
    "exclude": ["/_framework/*", "/css/*"]
  }
}

Ustawienie	Wartość	Opis
przepisać	/index.html	Plik do obsługi, gdy trasa nie jest zgodna z żadnymi innymi plikami.
wykluczanie	["/_framework/*", "/css/*"]	Ścieżki do ignorowania z routingu rezerwowego.

Reguła powrotu nawigacji jest stosowana po innych regułach routingu, które są wyświetlane w pliku staticwebapp.config.json .

Lokalizacja pliku tras

Zalecana lokalizacja dla staticwebapp.config.json znajduje się w folderze ustawionym app_location jako w pliku przepływu pracy. Plik można jednak umieścić w dowolnej lokalizacji w folderze kodu źródłowego aplikacji.