Introduce refresh visit action and method to refresh the current page

src/core/drive/page_view.js

@@ -56,7 +56,9 @@ export class PageView extends View {
   }
 
   isPageRefresh(visit) {
-    return !visit || (this.lastRenderedLocation.pathname === visit.location.pathname && visit.action === "replace")
+    if (!visit) { return true }
+
+    return this.lastRenderedLocation.pathname === visit.location.pathname && (visit.action === "replace" || visit.action === "refresh")
   }
 
   shouldPreserveScrollPosition(visit) {

src/core/drive/visit.js

@@ -39,7 +39,8 @@ export const SystemStatusCode = {
 export const Direction = {
   advance: "forward",
   restore: "back",
-  replace: "none"
+  replace: "none",
+  refresh: "none"
 }
 
 export class Visit {
@@ -389,6 +390,7 @@ export class Visit {
   getHistoryMethodForAction(action) {
     switch (action) {
       case "replace":
+      case "refresh":
         return history.replaceState
       case "advance":
       case "restore":

src/core/index.js

@@ -33,7 +33,7 @@ export function registerAdapter(adapter) {
  * @param location Location to visit (a URL or path)
  * @param options Options to apply
  * @param options.action Type of history navigation to apply ("restore",
- * "replace" or "advance")
+ * "replace", "refresh" or "advance")
  * @param options.historyChanged Specifies whether the browser history has
  * already been changed for this visit or not
  * @param options.referrer Specifies the referrer of this visit such that

src/core/session.js

@@ -108,10 +108,12 @@ export class Session {
   }
 
   refresh(url, requestId) {
+    const refreshUrl = url || document.baseURI
     const isRecentRequest = requestId && this.recentRequests.has(requestId)
+
     if (!isRecentRequest) {
       this.cache.exemptPageFromPreview()
-      this.visit(url, { action: "replace" })
+      this.visit(refreshUrl, { action: "refresh" })
     }
   }
 

src/tests/functional/page_refresh_tests.js

@@ -319,3 +319,10 @@ async function assertPageScroll(page, top, left) {
   expect(scrollTop).toEqual(top)
   expect(scrollLeft).toEqual(left)
 }
+
+test("Turbo.session.refresh() will refresh current page", async ({ page }) => {
+  await page.goto("/src/tests/fixtures/page_refresh.html")
+  await page.evaluate(() => window.Turbo.session.refresh())
+
+  await nextEventNamed(page, "turbo:render", { renderMethod: "morph" })
+})

src/tests/functional/visit_tests.js

@@ -256,6 +256,13 @@ test("Visit direction attribute on a replace visit", async ({ page }) => {
   await assertVisitDirectionAttribute(page, "none")
 })
 
+test("Visit direction when refreshing", async ({ page }) => {
+  page.evaluate(() => window.Turbo.session.refresh())
+
+  await assertVisitDirectionAttribute(page, "none")
+})
+
+
 test("Turbo history state after a reload", async ({ page }) => {
   await page.click("#same-origin-link")
   await nextEventNamed(page, "turbo:load")