Node.js experiments installation

  1. Install the package

    Required

    Install the PostHog Node.js library using your package manager:

    npm install posthog-node
  2. Initialize PostHog

    Required

    Initialize the PostHog client with your project API key:

    Node.js
    import { PostHog } from 'posthog-node'
    const client = new PostHog(
    '<ph_project_api_key>',
    {
    host: 'https://us.i.posthog.com'
    }
    )
  3. Implement your experiment

    Required

    Experiments run on top of our feature flags. You can define which version of your code runs based on the return value of the feature flag:

    Note: Server-side experiment metrics require you to manually send the feature flag information. See this tutorial for more information.

    const experimentFlagValue = await client.getFeatureFlag('your-experiment-feature-flag', 'user distinct id')
    if (experimentFlagValue === 'test' ) {
    // Do something differently for this user
    } else {
    // It's a good idea to let control variant always be the default behaviour,
    // so if something goes wrong with flag evaluation, you don't break your app.
    }
  4. Run your experiment

    Required

    Once you've implemented the feature flag in your code, you'll enable it for a target audience by creating a new experiment in the PostHog dashboard.

  5. Next steps

    Recommended

    ResourceDescription
    Creating an experimentHow to create an experiment in PostHog
    Adding experiment codeHow to implement experiments for all platforms
    Statistical significanceUnderstanding when results are meaningful
    Experiment insightsHow to analyze your experiment data
    More tutorialsOther real-world examples and use cases

Community questions

Was this page useful?

Questions about this page? or post a community question.