e3893b92ce
* feat(tracker): make message commits low priority (possibly improve browser lags display), add safe polyfill for env methods hijacked by angular * feat(tracker): add bun.sh support * feat(tracker): add bun.sh support to actions * feat(tracker): add bun.sh support to actions * feat(tracker): add bun.sh support to actions * fix(tracker): fix e2e test workflow file * fix(tracker): fix e2e test workflow file * fix(tracker): fix test workflow file * fix(tracker): fix requestIdleCallback check, add test cov for new utilities * fix(tracker): fix eslint complains * fix(ui): fix yarn bug * fix(ui): fix yarn bug * fix(ui): fix yarn bug * fix(ui): fix ci test * fix(ui): fix ci test * fix(ui): fix ci test * fix(ui): fix ci test * fix(ui): fix ci test * fix(ui): fix ci test * fix(ui): fix ci test * fix(ui): debug logs * fix(ui): debug logs * fix(ui): debug logs * fix(ui): debug logs * fix(ui): remove logs * fix(ui): fix waiting for ui * fix(ui): fix? * fix(ui): fix? * fix(ui): fix? * fix(ui): fix? * fix(ui): fix! * fix(ui): fix! * fix(ui): finally
50 lines
1.3 KiB
Markdown
50 lines
1.3 KiB
Markdown
# OpenReplay Tracker
|
|
|
|
The main package of the [OpenReplay](https://openreplay.com/) tracker.
|
|
|
|
## Development & Contribution
|
|
|
|
Please use [bun](https://bun.sh/) to install and build this library. Any submitted pull request must pass **all tests** and should have positive test coverage diff %.
|
|
|
|
## Documentation
|
|
|
|
For launch options and available public methods, [refer to the documentation](https://docs.openreplay.com/installation/javascript-sdk#options)
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
npm i @openreplay/tracker
|
|
```
|
|
|
|
## Usage
|
|
|
|
Initialize the package from your codebase entry point and start the tracker. You must set the `projectKey` option in the constructor. Its value can can be found in your OpenReplay dashboard under [Preferences -> Projects](https://app.openreplay.com/client/projects).
|
|
|
|
```js
|
|
import Tracker from '@openreplay/tracker'
|
|
|
|
const tracker = new Tracker({
|
|
projectKey: YOUR_PROJECT_KEY,
|
|
})
|
|
tracker
|
|
.start({
|
|
userID: 'Mr.Smith',
|
|
metadata: {
|
|
version: '3.5.0',
|
|
balance: '10M',
|
|
role: 'admin',
|
|
},
|
|
})
|
|
.then((startedSession) => {
|
|
if (startedSession.success) {
|
|
console.log(startedSession)
|
|
}
|
|
})
|
|
```
|
|
|
|
Then you can use OpenReplay JavaScript API anywhere in your code.
|
|
|
|
```js
|
|
tracker.setUserID('my_user_id')
|
|
tracker.setMetadata('env', 'prod')
|
|
```
|