Konfigurera reservvägar

  • 2 minuter

Det finns en klientväg, /products, i din klientapp som visar en lista med produkter för din inköpslista. När du går till /products i din app genom att välja länken Produkter bekräftar webbläsarens adressfält att du är på /products. När du uppdaterar webbläsaren på den här sidan vill du även att appen ska uppdatera och visa produkterna på nytt. Men utan en återställningsväg ser du ett 404-fel som anger att sidan inte kan hittas.

Att ett 404-felmeddelande visas när du uppdaterar sidan beror på att webbläsaren skickar en begäran till värdplattformen om att visa /products. Det finns dock ingen sida på servern med namnet products to serve.

Lyckligtvis är det enkelt att lösa det här problemet genom att skapa en återställningsväg. En återställningsväg är en väg som parkopplar alla omatchade sidbegäranden till servern.

Konfigurera en reservväg

Azure Static Web Apps stöder anpassade routningsregler som definierats i en valfri staticwebapp.config.json-fil som finns i appens källmapp. Du kan definiera en återställningsväg för navigering i objektet navigationFallback . En vanlig återställningsvägskonfiguration ser ut som i det här exemplet.

{
  "navigationFallback": {
    "rewrite": "/index.html",
    "exclude": ["/_framework/*", "/css/*"]
  }
}
Inställning Värde beskrivning
Skriva /index.html Filen som ska användas när en väg inte matchar några andra filer.
exclude ["/_framework/*", "/css/*"] Sökvägar för att ignorera från återställningsroutning.

Återställningsregeln för navigering tillämpas efter andra routningsregler som visas i filen staticwebapp.config.json .

Routes-filens plats

Den rekommenderade platsen för staticwebapp.config.json finns i mappen som anges app_location som i arbetsflödesfilen. Filen kan dock placeras på valfri plats i programkällkodsmappen.