: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 posthog from 'posthog-js'
import { useEffect, useState } from 'react'
import { FeatureFlagKey } from 'lib/constants'
const DEFAULT_API_KEY = 'sTMFPsFhdP1Ssg'
const runningOnPosthog = !!window.POSTHOG_APP_CONTEXT
const apiKey = runningOnPosthog ? window.JS_POSTHOG_API_KEY : DEFAULT_API_KEY
const apiHost = runningOnPosthog ? window.JS_POSTHOG_HOST : 'https://internal-cf.posthog.com'
// Manifest V3 forbids remote code in an extension, and the browser stores reject it.
const runningInBrowserExtension = !!(globalThis as { chrome?: { runtime?: { id?: string } } }).chrome?.runtime?.id
const initResult = posthog.init(
apiKey || DEFAULT_API_KEY,
{
api_host: apiHost,
opt_out_capturing_by_default: true, // must call .opt_in_capturing() before any events are sent
persistence: 'memory', // We don't want to persist anything, all events are in-memory
persistence_name: apiKey + '_toolbar', // We don't need this but it ensures we don't accidentally mess with the standard persistence
bootstrap: {
featureFlags: {},
},
// The web app imports toolbar modules, which creates this instance on every app page load.
// Only a mounted toolbar reads these flags, so the toolbar loads them and starts the refresh when it mounts.
advanced_disable_feature_flags_on_first_load: true,
remote_config_refresh_interval_ms: 0,
autocapture: false,
// The toolbar runs on customer pages and must not install global exception handlers.
capture_exceptions: false,
capture_pageview: false,
capture_pageleave: false,
disable_surveys: true,
disable_scroll_properties: true,
disable_product_tours: true,
disable_session_recording: true,
disable_external_dependency_loading: runningInBrowserExtension,
session_recording: {
// we want to capture the toolbar (which is marked with ph-no-capture
// so customer sessions don't see it), but also respect the customer's
// ph-no-capture marks
blockClass: 'ph-internal-no-capture',
blockSelector: '.ph-no-capture:not(#__POSTHOG_TOOLBAR__):not(#__POSTHOG_TOOLBAR__ *)',
maskAllInputs: true,
},
},
'ph_toolbar_internal'
)
if (!initResult) {
throw new Error('Failed to initialize PostHog toolbar instance')
}
export const toolbarPosthogJS = initResult
if (runningOnPosthog && window.JS_POSTHOG_SELF_CAPTURE) {
toolbarPosthogJS.debug()
}
/** Capture an exception with a required toolbar context tag for filtering. */
export function captureToolbarException(
error: unknown,
context: string,
additionalProperties?: Record<string, unknown>
): void {
toolbarPosthogJS.captureException(error, {
toolbar_context: context,
...additionalProperties,
})
}
export const useToolbarFeatureFlag = (flag: FeatureFlagKey, match?: string): boolean => {
const [flagValue, setFlagValue] = useState<boolean | string | undefined>(toolbarPosthogJS.getFeatureFlag(flag))
useEffect(() => {
return toolbarPosthogJS.onFeatureFlags(() => setFlagValue(toolbarPosthogJS.getFeatureFlag(flag)))
}, [flag, match])
if (match) {
return flagValue === match
}
return !!flagValue
}