fix(analytics): pass native arguments to dataLayer and track route changes
Deploy Canina / deploy (push) Successful in 2m20s

This commit is contained in:
devops committed 2026-10-20 10:49:56 +00:00
1 parent f59dd6ebec
commit 1651fd00a2
2 files changed
+163 -14

No files matched your search

@@ -2,13 +2,123 @@ import React from 'react';
import {render,fireEvent,act,cleanup} from '@testing-library/react';
import {vi,beforeEach,afterEach,it,expect} from 'vitest';
import AnalyticsDeferred from '../AnalyticsDeferred';
beforeEach(()=>{vi.useFakeTimers();document.head.innerHTML='';delete window.dataLayer;delete window.clarity;});
afterEach(()=>{cleanup();vi.useRealTimers();vi.unstubAllGlobals();});
it('defers tags until interaction and loads only once',()=>{render(<AnalyticsDeferred gtmId="GTM-test" gaId="G-test" clarityId="test"/>);expect(document.scripts).toHaveLength(0);fireEvent.scroll(window);fireEvent.keyDown(window);act(()=>vi.advanceTimersByTime(3500));expect(document.scripts).toHaveLength(3);expect(window.dataLayer).toEqual(expect.arrayContaining([['config','G-test',{page_path:'/'}]]));});
it.each(['scroll','touchstart','mousemove','keydown'])('loads on %s',event=>{render(<AnalyticsDeferred gtmId="GTM-test"/>);fireEvent(window,new Event(event));expect(document.scripts).toHaveLength(1);});
it('loads clarity when no script exists',()=>{render(<AnalyticsDeferred clarityId="solo"/>);fireEvent.scroll(window);expect(document.querySelector('script')?.src).toBe('https://www.clarity.ms/tag/solo');});
it('preserves the existing clarity implementation',()=>{const clarity=vi.fn();window.clarity=clarity;render(<AnalyticsDeferred clarityId="existing"/>);fireEvent.scroll(window);expect(window.clarity).toBe(clarity);expect(document.querySelector('script')?.src).toBe('https://www.clarity.ms/tag/existing');});
it('queues clarity calls before its script initializes',()=>{render(<AnalyticsDeferred clarityId="queued"/>);fireEvent.scroll(window);window.clarity('event','checkout');expect(window.clarity.q).toEqual([['event','checkout']]);});
it('falls back after 3500ms and reuses existing GA script',()=>{const s=document.createElement('script');s.src='https://www.googletagmanager.com/gtag/js?id=G-test';document.head.append(s);render(<AnalyticsDeferred gaId="G-test"/>);act(()=>vi.advanceTimersByTime(3499));expect(window.dataLayer).toBeUndefined();act(()=>vi.advanceTimersByTime(1));expect(document.scripts).toHaveLength(1);});
it('cancels idle work on unmount',()=>{let cb:()=>void=()=>{};vi.stubGlobal('requestIdleCallback',vi.fn(fn=>{cb=fn;return 9;}));vi.stubGlobal('cancelIdleCallback',vi.fn());const v=render(<AnalyticsDeferred gtmId="GTM-test"/>);act(()=>vi.advanceTimersByTime(3500));v.unmount();act(()=>cb());expect(document.scripts).toHaveLength(0);expect(cancelIdleCallback).toHaveBeenCalledWith(9);});
it('unmount removes event and timeout callbacks',()=>{const v=render(<AnalyticsDeferred gtmId="GTM-test"/>);v.unmount();fireEvent.scroll(window);act(()=>vi.advanceTimersByTime(4000));expect(document.scripts).toHaveLength(0);});
let mockPathname = '/';
vi.mock('next/navigation', () => ({
usePathname: () => mockPathname,
}));
beforeEach(()=>{
vi.useFakeTimers();
mockPathname = '/';
document.head.innerHTML='';
delete (window as any).dataLayer;
delete (window as any).clarity;
delete (window as any).gtag;
});
afterEach(()=>{
cleanup();
vi.useRealTimers();
vi.unstubAllGlobals();
});
it('pushes genuine native arguments object for gtag commands so gtag.js processes them',()=>{
render(<AnalyticsDeferred gaId="G-test"/>);
fireEvent.scroll(window);
act(()=>vi.advanceTimersByTime(3500));
expect(window.dataLayer).toBeDefined();
const configEntry = window.dataLayer?.find(entry => {
return Object.prototype.toString.call(entry) === '[object Arguments]' && entry[0] === 'config';
});
expect(configEntry).toBeDefined();
expect(configEntry[1]).toBe('G-test');
});
it('defers tags until interaction and loads only once',()=>{
render(<AnalyticsDeferred gtmId="GTM-test" gaId="G-test" clarityId="test"/>);
expect(document.scripts).toHaveLength(0);
fireEvent.scroll(window);
fireEvent.keyDown(window);
act(()=>vi.advanceTimersByTime(3500));
expect(document.scripts).toHaveLength(3);
const hasConfig = window.dataLayer?.some(entry => entry[0] === 'config' && entry[1] === 'G-test');
expect(hasConfig).toBe(true);
});
it('tracks client-side route changes when pathname changes',()=>{
const {rerender} = render(<AnalyticsDeferred gaId="G-test" gtmId="GTM-test"/>);
fireEvent.scroll(window);
act(()=>vi.advanceTimersByTime(3500));
// Simulate navigation to blog
mockPathname = '/blog/test-article';
rerender(<AnalyticsDeferred gaId="G-test" gtmId="GTM-test"/>);
const gtmPageView = window.dataLayer?.find(entry => entry.event === 'page_view' && entry.page_path === '/blog/test-article');
expect(gtmPageView).toBeDefined();
const gaPageView = window.dataLayer?.find(entry => {
return Object.prototype.toString.call(entry) === '[object Arguments]' && entry[0] === 'event' && entry[1] === 'page_view';
});
expect(gaPageView).toBeDefined();
expect(gaPageView[2].page_path).toBe('/blog/test-article');
});
it.each(['scroll','touchstart','mousemove','keydown'])('loads on %s',event=>{
render(<AnalyticsDeferred gtmId="GTM-test"/>);
fireEvent(window,new Event(event));
expect(document.scripts).toHaveLength(1);
});
it('loads clarity when no script exists',()=>{
render(<AnalyticsDeferred clarityId="solo"/>);
fireEvent.scroll(window);
expect(document.querySelector('script')?.src).toBe('https://www.clarity.ms/tag/solo');
});
it('preserves the existing clarity implementation',()=>{
const clarity=vi.fn();
(window as any).clarity=clarity;
render(<AnalyticsDeferred clarityId="existing"/>);
fireEvent.scroll(window);
expect((window as any).clarity).toBe(clarity);
expect(document.querySelector('script')?.src).toBe('https://www.clarity.ms/tag/existing');
});
it('queues clarity calls before its script initializes',()=>{
render(<AnalyticsDeferred clarityId="queued"/>);
fireEvent.scroll(window);
(window as any).clarity('event','checkout');
expect((window as any).clarity.q).toEqual([['event','checkout']]);
});
it('falls back after 3500ms and reuses existing GA script',()=>{
const s=document.createElement('script');
s.src='https://www.googletagmanager.com/gtag/js?id=G-test';
document.head.append(s);
render(<AnalyticsDeferred gaId="G-test"/>);
act(()=>vi.advanceTimersByTime(3499));
expect(window.dataLayer).toBeUndefined();
act(()=>vi.advanceTimersByTime(1));
expect(document.scripts).toHaveLength(1);
});
it('cancels idle work on unmount',()=>{
let cb:()=>void=()=>{};
vi.stubGlobal('requestIdleCallback',vi.fn(fn=>{cb=fn;return 9;}));
vi.stubGlobal('cancelIdleCallback',vi.fn());
const v=render(<AnalyticsDeferred gtmId="GTM-test"/>);
act(()=>vi.advanceTimersByTime(3500));
v.unmount();
act(()=>cb());
expect(document.scripts).toHaveLength(0);
expect(cancelIdleCallback).toHaveBeenCalledWith(9);
});
it('unmount removes event and timeout callbacks',()=>{
const v=render(<AnalyticsDeferred gtmId="GTM-test"/>);
v.unmount();
fireEvent.scroll(window);
act(()=>vi.advanceTimersByTime(4000));
expect(document.scripts).toHaveLength(0);
});