:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
/**
* @jest-environment jsdom
*/
import { CorsPlugin, createCorsPlugin, createHLSPlayerPlugin, WindowTitlePlugin } from './index'
describe('CorsPlugin', () => {
it.each(['https://some-external.js'])('should replace JS urls', (jsUrl) => {
expect(CorsPlugin._replaceJSUrl(jsUrl)).toEqual(`https://replay.ph-proxy.com/proxy?url=${jsUrl}`)
})
it.each([
`@font-face { font-display: fallback; font-family: "Roboto Condensed"; font-weight: 400; font-style: normal; src: url("https://posthog.com/assets/fonts/roboto/roboto_condensed_reg-webfont.woff2?11012022") format("woff2"), url("https://posthog.com/assets/fonts/roboto/roboto_condensed_reg-webfont.woff?11012022")`,
`url("https://app.posthog.com/fonts/my-font.woff2")`,
])('should replace font urls in stylesheets', (content: string) => {
expect(CorsPlugin._replaceFontCssUrls(content)).toMatchSnapshot()
})
it.each(['https://app.posthog.com/fonts/my-font.woff2?t=1234', 'https://app.posthog.com/fonts/my-font.ttf'])(
'should replace font urls in links',
(content: string) => {
expect(CorsPlugin._replaceFontUrl(content)).toEqual(`https://replay.ph-proxy.com/proxy?url=${content}`)
}
)
it.each([
'https://app.posthog.com/my-image.jpeg',
// ttf substring was matching in a previous version
'https://app-static.eu.posthog.com/static/index-EBVVDttf.css',
])('should not replace non-font urls in links', (content: string) => {
expect(CorsPlugin._replaceFontUrl(content)).toEqual(content)
})
it('can replace a modulepreload js link', () => {
const el = document.createElement('link')
el.setAttribute('rel', 'modulepreload')
el.href = 'https://app.posthog.com/my-image.js'
CorsPlugin.onBuild?.(el, { id: 1, replayer: null as unknown as any })
expect(el.href).toEqual(`https://replay.ph-proxy.com/proxy?url=https://app.posthog.com/my-image.js`)
})
it.each([
[null, 'https://replay.ph-proxy.com/proxy?url=https://app.posthog.com/fonts/my-font.woff2#iefix'],
[
'header.payload.signature',
'https://replay.ph-proxy.com/proxy?token=header.payload.signature&url=https://app.posthog.com/fonts/my-font.woff2#iefix',
],
])('sends proxy token %s before the url', (token, expected) => {
const plugin = createCorsPlugin(() => token)
expect(plugin._replaceFontUrl('https://app.posthog.com/fonts/my-font.woff2#iefix')).toEqual(expected)
})
it('reads the latest proxy token for each url', () => {
let token = 'first'
const plugin = createCorsPlugin(() => token)
token = 'second'
expect(plugin._replaceJSUrl('https://some-external.js')).toEqual(
'https://replay.ph-proxy.com/proxy?token=second&url=https://some-external.js'
)
})
})
const mockHlsInstance = {
loadSource: jest.fn(),
attachMedia: jest.fn(),
on: jest.fn(),
destroy: jest.fn(),
}
const mockHlsClass = Object.assign(
jest.fn(() => mockHlsInstance),
{
isSupported: jest.fn(() => true),
Events: { ERROR: 'hlsError' },
ErrorTypes: { NETWORK_ERROR: 'networkError', MEDIA_ERROR: 'mediaError' },
}
)
jest.mock('hls.js', () => ({ __esModule: true, default: mockHlsClass }))
describe('HLSPlayerPlugin', () => {
let plugin: ReturnType<typeof createHLSPlayerPlugin>
// `onBuild` fires `import('hls.js').then(...)` without awaiting it; drain the microtask
// queue so the handler has run before asserting.
const delay = (ms = 0): Promise<void> => new Promise((resolve) => setTimeout(resolve, ms))
beforeEach(() => {
jest.clearAllMocks()
mockHlsClass.isSupported.mockReturnValue(true)
plugin = createHLSPlayerPlugin()
})
it('does nothing for non-video elements', async () => {
const div = document.createElement('div')
await plugin.onBuild?.(div, { id: 1, replayer: null as any })
expect(mockHlsClass).not.toHaveBeenCalled()
})
it('does nothing for video elements without hls-src', async () => {
const video = document.createElement('video')
await plugin.onBuild?.(video, { id: 1, replayer: null as any })
expect(mockHlsClass).not.toHaveBeenCalled()
})
it('dynamically imports hls.js and attaches to video with hls-src', async () => {
const video = document.createElement('video')
video.setAttribute('hls-src', 'https://example.com/stream.m3u8')
await plugin.onBuild?.(video, { id: 1, replayer: null as any })
await delay()
expect(mockHlsClass).toHaveBeenCalled()
expect(mockHlsInstance.loadSource).toHaveBeenCalledWith('https://example.com/stream.m3u8')
expect(mockHlsInstance.attachMedia).toHaveBeenCalledWith(video)
expect(mockHlsInstance.on).toHaveBeenCalledWith('hlsError', expect.any(Function))
})
it('falls back to native HLS when Hls.isSupported() is false', async () => {
mockHlsClass.isSupported.mockReturnValue(false)
const video = document.createElement('video')
video.setAttribute('hls-src', 'https://example.com/stream.m3u8')
video.canPlayType = jest.fn(() => 'maybe') as any
await plugin.onBuild?.(video, { id: 1, replayer: null as any })
await delay()
expect(mockHlsInstance.loadSource).not.toHaveBeenCalled()
expect(video.src).toContain('https://example.com/stream.m3u8')
})
})
describe('WindowTitlePlugin', () => {
it('issues a callback with a valid full snapshot and subsequent incremental mutations', () => {
const mockCallback = jest.fn()
const plugin = WindowTitlePlugin(mockCallback)
plugin.handler?.(
{
windowId: '0191dd6c-cd35-71ad-9114-264ebef5ab38',
type: 2,
data: {
node: {
type: 0,
childNodes: [
{ type: 1, name: 'html' },
{
type: 2,
tagName: 'html',
childNodes: [
{
type: 2,
tagName: 'head',
childNodes: [
{ type: 2, tagName: 'meta' },
{
type: 2,
tagName: 'title',
attributes: {},
childNodes: [
{ id: 123456789, type: 3, textContent: 'Recordings • PostHog' },
],
},
],
},
],
},
],
},
},
} as any,
true,
{ replayer: null as unknown as any }
)
expect(mockCallback).toHaveBeenCalledWith('0191dd6c-cd35-71ad-9114-264ebef5ab38', 'Recordings • PostHog')
mockCallback.mockClear()
plugin.handler?.(
{
type: 3,
windowId: '0191dd6c-cd35-71ad-9114-264ebef5ab38',
data: { texts: [{ id: 123, value: 'PostHog • A new title' }] },
} as any,
true,
{ replayer: null as unknown as any }
)
// not called because the id is not a title element
expect(mockCallback).not.toHaveBeenCalled()
plugin.handler?.(
{
type: 3,
windowId: '0191dd6c-cd35-71ad-9114-264ebef5ab38',
data: { source: 0, texts: [{ id: 123456789, value: 'PostHog • A new title' }] },
} as any,
true,
{ replayer: null as unknown as any }
)
expect(mockCallback).toHaveBeenCalledWith('0191dd6c-cd35-71ad-9114-264ebef5ab38', 'PostHog • A new title')
// new full snapshot clears title references
mockCallback.mockClear()
plugin.handler?.(
{
windowId: '0191dd6c-cd35-71ad-9114-264ebef5ab38',
type: 2,
data: { node: { type: 0, childNodes: [] } },
} as any,
true,
{ replayer: null as unknown as any }
)
plugin.handler?.(
{
type: 3,
windowId: '0191dd6c-cd35-71ad-9114-264ebef5ab38',
data: { source: 0, texts: [{ id: 123456789, value: 'PostHog • A new title' }] },
} as any,
true,
{ replayer: null as unknown as any }
)
expect(mockCallback).not.toHaveBeenCalled()
})
it('does not issue a callback when the windowId is missing', () => {
const mockCallback = jest.fn()
const plugin = WindowTitlePlugin(mockCallback)
plugin.handler?.(
{
type: 2,
data: {
node: {
type: 0,
childNodes: [
{ type: 1, name: 'html' },
{
type: 2,
tagName: 'html',
childNodes: [
{
type: 2,
tagName: 'head',
childNodes: [
{ type: 2, tagName: 'meta' },
{
type: 2,
tagName: 'title',
attributes: {},
childNodes: [{ type: 3, textContent: 'Recordings • PostHog' }],
},
],
},
],
},
],
},
},
} as any,
true,
{ replayer: null as unknown as any }
)
expect(mockCallback).not.toHaveBeenCalled()
})
it('does not issue a callback when no title in head element', () => {
const mockCallback = jest.fn()
const plugin = WindowTitlePlugin(mockCallback)
plugin.handler?.(
{
windowId: '0191dd6c-cd35-71ad-9114-264ebef5ab38',
type: 2,
data: {
node: {
type: 0,
childNodes: [
{ type: 1, name: 'html' },
{
type: 2,
tagName: 'html',
childNodes: [
{
type: 2,
tagName: 'head',
childNodes: [{ type: 2, tagName: 'meta' }],
},
],
},
],
},
},
} as any,
true,
{ replayer: null as unknown as any }
)
expect(mockCallback).not.toHaveBeenCalled()
})
})