: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
import {
addProjectIdIfMissing,
ensureRoutablePathname,
removeProjectIdIfPresent,
stripTrailingSlash,
stripTrailingSlashFromUrl,
} from 'lib/utils/kea-router'
describe('router-utils', () => {
it('does not redirect account URLs to a project URL', () => {
const altered = addProjectIdIfMissing('/account/two_factor', 123)
expect(altered).toEqual('/account/two_factor')
})
it('does not allow account urls to have a project url', () => {
const altered = addProjectIdIfMissing('/project/123/account/two_factor', 123)
expect(altered).toEqual('/account/two_factor')
})
it('allows project urls to use an API key in place of numeric project id', () => {
const altered = addProjectIdIfMissing('/project/phc_gE7SWBNBgFbA4eQ154KPXebyB8KyLJuypR8jg1DSo9Z/replay', 123)
expect(altered).toEqual('/project/phc_gE7SWBNBgFbA4eQ154KPXebyB8KyLJuypR8jg1DSo9Z/replay')
})
it('does not redirect the instance-level feature flags staff tools URL to a project URL', () => {
const altered = addProjectIdIfMissing('/feature-flags/staff', 123)
expect(altered).toEqual('/feature-flags/staff')
})
it('does not redirect the staff tools URL when it carries a query string', () => {
const altered = addProjectIdIfMissing('/feature-flags/staff?team_id=456', 123)
expect(altered).toEqual('/feature-flags/staff?team_id=456')
})
it('does not redirect the staff tools URL when it carries a hash', () => {
const altered = addProjectIdIfMissing('/feature-flags/staff#cache', 123)
expect(altered).toEqual('/feature-flags/staff#cache')
})
it('still adds a project id to other feature flags URLs', () => {
const altered = addProjectIdIfMissing('/feature-flags/123', 123)
expect(altered).toEqual('/project/123/feature-flags/123')
})
it('does not redirect the experiments staff tools URL to a project URL', () => {
const altered = addProjectIdIfMissing('/experiments/staff', 123)
expect(altered).toEqual('/experiments/staff')
})
it('does not redirect the cohorts staff tools URL nested under feature flags staff', () => {
const altered = addProjectIdIfMissing('/feature-flags/staff/cohorts', 123)
expect(altered).toEqual('/feature-flags/staff/cohorts')
})
it('does not add a project id to billing URLs, which are organization-scoped', () => {
expect(addProjectIdIfMissing('/billing', 123)).toEqual('/billing')
expect(addProjectIdIfMissing('/billing/authorization_status', 123)).toEqual('/billing/authorization_status')
})
describe('the id-less /project root', () => {
// An id-less `/project` used to survive the strip pass, match no route, and then get the
// current team prefixed onto it, so the address bar read `/project/<team id>/project`
// behind the 404 scene. Both forms must reduce to the root path instead.
it.each([
['/project', '/'],
['/project/', '/'],
['/project?next=/home', '/?next=/home'],
// The URL the bug itself produced, so bookmarks of it have to land home too
['/project/123/project', '/'],
// These have their own redirects, so stripping the prefix would send them to the
// unrelated /new and /settings scenes
['/project/new', '/project/new'],
['/project/settings', '/project/settings'],
])('reduces %s to %s', (path, expected) => {
expect(removeProjectIdIfPresent(path)).toEqual(expected)
})
it.each(['/project', '/project/'])('sends %s to the current project root', (path) => {
expect(addProjectIdIfMissing(path, 123)).toEqual('/project/123')
})
})
describe('relative path normalization', () => {
it('normalizes ../ prefix to absolute path with project id', () => {
expect(addProjectIdIfMissing('../dashboard/1663553', 112509)).toEqual('/project/112509/dashboard/1663553')
})
it('normalizes multiple ../ prefixes', () => {
expect(addProjectIdIfMissing('../../dashboard/1663553', 112509)).toEqual(
'/project/112509/dashboard/1663553'
)
})
it('normalizes ./ prefix to absolute path with project id', () => {
expect(addProjectIdIfMissing('./insights/abc123', 112509)).toEqual('/project/112509/insights/abc123')
})
it('normalizes repeated ./ prefixes', () => {
expect(addProjectIdIfMissing('././dashboard/1663553', 112509)).toEqual('/project/112509/dashboard/1663553')
})
it('does not alter normal absolute paths', () => {
expect(addProjectIdIfMissing('/dashboard/1663553', 112509)).toEqual('/project/112509/dashboard/1663553')
})
})
describe('stripTrailingSlash', () => {
it('strips a single trailing slash', () => {
expect(stripTrailingSlash('/insights/abc/')).toEqual('/insights/abc')
})
it('strips multiple trailing slashes', () => {
expect(stripTrailingSlash('/insights/abc///')).toEqual('/insights/abc')
})
it('preserves the root path', () => {
expect(stripTrailingSlash('/')).toEqual('/')
})
it('leaves paths without trailing slash unchanged', () => {
expect(stripTrailingSlash('/insights/abc')).toEqual('/insights/abc')
})
it('leaves the empty string unchanged', () => {
expect(stripTrailingSlash('')).toEqual('')
})
})
describe('stripTrailingSlashFromUrl', () => {
it.each([
['/oauth/authorize/', '/oauth/authorize'],
['/oauth/authorize/?client_id=abc', '/oauth/authorize?client_id=abc'],
['/login?next=/oauth/authorize/', '/login?next=/oauth/authorize/'],
['/insights/abc/#panel=/', '/insights/abc#panel=/'],
['/', '/'],
])('turns %s into %s', (input, expected) => {
expect(stripTrailingSlashFromUrl(input)).toEqual(expected)
})
})
describe('ensureRoutablePathname', () => {
// kea-router runs decodeURI(pathname) while matching; a stray `%` used to throw URIError
// and crash routing before any scene loaded. Whatever we return must be decodeURI-safe.
it.each([
['/person/50%off', '/person/50%25off'], // lone `%` gets escaped
['/person/foo%', '/person/foo%25'], // trailing `%` gets escaped
['/person/50%25off', '/person/50%25off'], // already-valid escape is untouched
['/person/foo bar', '/person/foo bar'], // whitespace decodes fine, left alone
['/insights/abc', '/insights/abc'], // plain path untouched
])('makes %s routable as %s', (input, expected) => {
const result = ensureRoutablePathname(input)
expect(result).toEqual(expected)
expect(() => decodeURI(result)).not.toThrow()
})
})
})