@guardian/ophan-tracker-js 2.4.0 → 2.4.2

package/NPM-dist/core.js

@@ -9,6 +9,12 @@ let platform = null;
 const MaximumComponentNameLength = 50;
 init = function (servingPlatform, httpStatus) {
     platform = servingPlatform;
+    window.addEventListener('pageshow', function (event) {
+        if (event.persisted) {
+            transmit.bumpViewId();
+            sendInitialEvent(httpStatus, location.href, window.document.referrer, 'bfcache');
+        }
+    }, false);
     if (visibility.state() !== 'prerender') {
         return sendInitialEvent(httpStatus);
     }
@@ -65,7 +71,7 @@ const getNavigationType = () => {
     }
     return null;
 };
-sendInitialEvent = function (httpStatus, url = location.href, referrer = window.document.referrer) {
+sendInitialEvent = function (httpStatus, url = location.href, referrer = window.document.referrer, loadType = 'normal') {
     const navigationType = getNavigationType();
     // send initial event
     const event = {
@@ -84,6 +90,9 @@ sendInitialEvent = function (httpStatus, url = location.href, referrer = window.
         // Add navigation type as metadata to the event if it's not null
         event.navigationType = navigationType;
     }
+    if (loadType !== 'normal') {
+        event.loadType = loadType;
+    }
     appendContentType(event);
     appendDataFromLocalStorageToEvent(event);
     transmit.sendInitial(event);

package/NPM-dist/tests/core.test.js

@@ -1,7 +1,11 @@
 import { _testExports } from '../core.js';
 import transmit from '../transmit';
 const mockSendMore = jest.fn();
+const mockSendInitial = jest.fn();
+const mockBumpViewId = jest.fn();
 transmit.sendMore = mockSendMore;
+transmit.sendInitial = mockSendInitial;
+transmit.bumpViewId = mockBumpViewId;
 const { getQueryParameterValue, appendComponentDataToEvent, trimComponentNamesToUrlSafeLength, onLoadCapture, onLoadCaptures, processCaptures, appendContentType, } = _testExports;
 describe('appendComponentDataToEvent', () => {
     beforeEach(() => {
@@ -159,3 +163,57 @@ describe('appendContentType', () => {
         expect(event.contentType).toBeUndefined();
     });
 });
+describe('loadType pageshow handling', () => {
+    let mockAddEventListener;
+    let pageShowHandler;
+    let originalSendInitial;
+    beforeEach(() => {
+        jest.clearAllMocks();
+        mockAddEventListener = jest.fn();
+        window.addEventListener = mockAddEventListener;
+        originalSendInitial = transmit.sendInitial;
+        transmit.sendInitial = jest.fn();
+        const core = require('../core.js').default;
+        core.init('next-gen', 200);
+        const pageShowCall = mockAddEventListener.mock.calls.find(call => call[0] === 'pageshow');
+        pageShowHandler = pageShowCall ? pageShowCall[1] : null;
+    });
+    afterEach(() => {
+        transmit.sendInitial = originalSendInitial;
+    });
+    it('should register pageshow event listener during init', () => {
+        expect(mockAddEventListener).toHaveBeenCalledWith('pageshow', expect.any(Function), false);
+    });
+    it('should call sendInitialEvent with loadType=bfcache when pageshow event has persisted=true', () => {
+        expect(pageShowHandler).toBeTruthy();
+        transmit.sendInitial.mockClear();
+        // Simulate a bfcache restore event
+        const mockEvent = { persisted: true };
+        pageShowHandler(mockEvent);
+        expect(transmit.sendInitial).toHaveBeenCalledWith(expect.objectContaining({
+            loadType: 'bfcache'
+        }));
+    });
+    it('should call bumpViewId when pageshow event has persisted=true', () => {
+        expect(pageShowHandler).toBeTruthy();
+        transmit.bumpViewId.mockClear();
+        // Simulate a bfcache restore event
+        const mockEvent = { persisted: true };
+        pageShowHandler(mockEvent);
+        expect(transmit.bumpViewId).toHaveBeenCalledTimes(1);
+    });
+    it('should not call sendInitialEvent when pageshow event has persisted=false', () => {
+        expect(pageShowHandler).toBeTruthy();
+        transmit.sendInitial.mockClear();
+        const mockEvent = { persisted: false };
+        pageShowHandler(mockEvent);
+        expect(transmit.sendInitial).not.toHaveBeenCalled();
+    });
+    it('should handle pageshow event without persisted property', () => {
+        expect(pageShowHandler).toBeTruthy();
+        transmit.sendInitial.mockClear();
+        const mockEvent = {};
+        pageShowHandler(mockEvent);
+        expect(transmit.sendInitial).not.toHaveBeenCalled();
+    });
+});

package/NPM-dist/types/types/event.d.ts

@@ -31,6 +31,8 @@ interface PageView {
     subscriptionType?: TSubscriptionType;
     membershipTier?: TMembershipTier;
     navigationType?: PerformanceNavigationTiming['type'];
+    /** The type of page load - normal or from cache */
+    loadType?: 'normal' | 'bfcache';
     from?: string;
     to?: string;
     tz?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@guardian/ophan-tracker-js",
-	"version": "2.4.0",
+	"version": "2.4.2",
 	"type": "module",
 	"engines": {
 		"node": ">=16"