posthog-js
Advanced tools
Posthog-js allows you to automatically capture usage and send events to PostHog.
The posthog-js npm package is a JavaScript library for integrating PostHog analytics into web applications. It allows you to track user interactions, capture events, and analyze user behavior in real-time.
Initialization
Initialize the PostHog library with your API key and optional configuration settings.
const posthog = require('posthog-js');
posthog.init('YOUR_API_KEY', { api_host: 'https://app.posthog.com' });Capture Events
Capture custom events with properties to track user interactions and behaviors.
posthog.capture('event_name', { property1: 'value1', property2: 'value2' });Identify Users
Identify users with unique IDs and associate them with properties like email and name.
posthog.identify('user_id', { email: 'user@example.com', name: 'John Doe' });Set User Properties
Set properties for identified users to enrich user profiles with additional information.
posthog.people.set({ property1: 'value1', property2: 'value2' });Feature Flags
Check if a feature flag is enabled for the current user to implement feature toggling.
const isEnabled = posthog.isFeatureEnabled('feature_flag_key');Mixpanel is a powerful analytics tool that offers similar functionalities to PostHog, such as event tracking, user identification, and property setting. Mixpanel also provides advanced features like A/B testing and user segmentation.
Amplitude is an analytics platform focused on product intelligence. It offers event tracking, user identification, and behavioral analytics. Amplitude provides advanced features like cohort analysis and user journey mapping, which can be more detailed than PostHog's offerings.
For information on using this library in your app, see PostHog Docs.
This README is intended for developing the library itself.
Unit tests: run yarn test.
Cypress: run yarn serve to have a test server running and separately yarn cypress to launch Cypress test engine.
Testing on IE11 requires a bit more setup. TestCafe tests will use the
playground application to test the locally built array.full.js bundle. It will
also verify that the events emitted during the testing of playground are loaded
into the PostHog app. By default it uses https://app.posthog.com and the
project with ID 11213. See the testcafe tests to see how to override these if
needed. For PostHog internal users ask @benjackwhite or @hazzadous to invite you
to the Project. You'll need to set POSTHOG_API_KEY to your personal API key, and
POSTHOG_PROJECT_KEY to the key for the project you are using.
You'll also need to sign up to BrowserStack. Note that if you are using CodeSpaces, these variables will already be available in your shell env variables.
After all this, you'll be able to run through the below steps:
nodemon -w src/ --exec bash -c "yarn build-rollup".export BROWSERSTACK_USERNAME=xxx BROWSERSTACK_ACCESS_KEY=xxx.npx testcafe "browserstack:ie" testcafe/e2e.spec.js.You can use the create react app setup in playground/nextjs to test posthog-js as an npm module in a Nextjs application.
posthog locally on port 8000 (DEBUG=1 TEST=1 ./bin/start).python manage.py setup_dev --no-data on posthog repo, which sets up a demo account.http://localhost:8000/project/settings and thencd playground/nextjsand run NEXT_PUBLIC_POSTHOG_KEY='<your-local-api-key>' yarn devInstall Yalc to link a local version of posthog-js in another JS project: npm install -g yalc
posthog-js directory: yalc publishyalc add posthog-js, then install dependenciesposthog this means: yalc add posthog-js && pnpm i && pnpm copy-scripts)yalc update, then install dependenciesposthog this means: yalc update && pnpm i && pnpm copy-scripts)yalc remove posthog-js, then install dependenciesposthog this means: yalc remove posthog-js && pnpm i && pnpm copy-scripts)Just put a bump patch/minor/major label on your PR! Once the PR is merged, a new version with the appropriate version bump will be released, and the dependency will be updated in posthog/PostHog – automatically.
If you want to release a new version without a PR (e.g. because you forgot to use the label), check out the master branch and run npm version [major | minor | patch] && git push --tags - this will trigger the automated release process just like the label.
To release an alpha or beta version, you'll need to use the CLI locally:
posthog-js in npm (check here).npm login).master).npm version [premajor | preminor | prepatch] --preid=beta
npm publish --tag beta
git push --tags
1.57.3 - 2023-05-23
FAQs
Posthog-js allows you to automatically capture usage and send events to PostHog.
The npm package posthog-js receives a total of 616,168 weekly downloads. As such, posthog-js popularity was classified as popular.
We found that posthog-js demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
Security News
NVD’s backlog surpasses 20,000 CVEs as analysis slows and NIST announces new system updates to address ongoing delays.
Security News
Research
A malicious npm package disguised as a WhatsApp client is exploiting authentication flows with a remote kill switch to exfiltrate data and destroy files.