: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 { ElementType } from '~/types'
// these plus any element with cursor:pointer will be click targets
export const CLICK_TARGETS = ['a', 'button', 'input', 'select', 'textarea']
export const EXPERIMENT_TARGETS = [
'label',
'h1',
'h2',
'h3',
'h4',
'h5',
'h6',
'span',
'img',
'caption',
'code',
'dd',
'del',
'details',
'dfn',
'footer',
'header',
'ol',
'small',
'summary',
'table',
'tbody',
'td',
'th',
'thead',
'tr',
'tt',
'u',
'ul',
]
export const CLICK_TARGET_SELECTOR = CLICK_TARGETS.join(', ')
export const EXPERIMENT_TARGET_SELECTOR = CLICK_TARGETS.concat(EXPERIMENT_TARGETS).join(', ')
// always ignore the following
export const TAGS_TO_IGNORE = ['html', 'body', 'meta', 'head', 'script', 'link', 'style']
export const escapeRegex = (str: string): string => str.replace(/([.*+?^=!:${}()|[\]/\\])/g, '\\$1')
export function matchesDataAttribute(element: ElementType, dataAttributes: string[]): string | void {
if (!element.attributes) {
return
}
for (const attribute of dataAttributes) {
const regex = new RegExp(`^attr__${attribute.split('*').map(escapeRegex).join('.*')}$`)
const match = Object.keys(element.attributes).find((a) => regex.test(a))
if (match) {
return match.replace(/^attr__/, '')
}
}
}
// not CSS.escape: the backend selector parser matches quoted values literally, so escaping
// anything beyond \ and " (e.g. the dots in data-attr="user.settings.save") breaks server-side matching
const escapeQuotedSelectorValue = (value: string): string => value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')
export function elementToSelector(element: ElementType, dataAttributes: string[]): string {
let selector = ''
const attribute = matchesDataAttribute(element, dataAttributes)
if (attribute) {
selector += `[${attribute}="${escapeQuotedSelectorValue(element.attributes[`attr__${attribute}`])}"]`
return selector
}
if (element.attr_id) {
selector += `[id="${CSS.escape(element.attr_id)}"]`
return selector
}
if (element.tag_name) {
selector += CSS.escape(element.tag_name)
}
if (element.attr_class) {
selector += element.attr_class
.filter((a) => a)
.map((a) => `.${CSS.escape(a)}`)
.join('')
}
if (element.href && element.tag_name === 'a') {
selector += `[href="${CSS.escape(element.href)}"]`
}
if (element.nth_child) {
selector += `:nth-child(${parseInt(element.nth_child as any)})`
}
if (element.nth_of_type) {
selector += `:nth-of-type(${parseInt(element.nth_of_type as any)})`
}
return selector
}