# trackjs

> TrackJS JavaScript error tracking agent.

Latest version **3.10.4** (published 2023-12-06) · SEE LICENSE IN LICENSE.md license · 0 weekly downloads

## Install

```sh
npm install trackjs
pnpm add trackjs
yarn add trackjs
bun add trackjs
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 3.10.4 |
| Published | 2023-12-06 |
| First published | 2014-10-16 |
| Weekly downloads | 0 |
| License | SEE LICENSE IN LICENSE.md |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 133.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 128 |
| Author | TrackJS |
| Maintainers | trackjs |

## Links

- npm: https://www.npmjs.com/package/trackjs
- Repository: https://github.com/trackjs/trackjs-package
- Homepage: https://trackjs.com/
- Issues: https://github.com/TrackJs/trackjs-package/issues
- npm.io page: https://npm.io/package/trackjs

## Recent versions

- 3.10.4 (latest) — 2023-12-06
- 3.10.4-canary.363 (canary) — 2024-01-03
- 3.10.4-canary.362 — 2023-12-06
- 3.10.3 — 2023-11-13
- 3.10.3-canary.361 — 2023-11-13
- 3.10.2 — 2023-11-13
- 3.10.2-canary.360 — 2023-11-01
- 3.10.1-canary.356 — 2022-03-31
- 3.10.1-canary.355 — 2022-03-31
- 3.10.1 — 2021-08-05
- 3.10.1-canary.349 — 2021-08-05
- 3.10.0 — 2021-07-29
- 3.10.0-canary.348 — 2021-07-19
- 3.9.2 — 2021-05-03
- 3.9.2-canary.346 — 2021-04-30
- … 98 more at https://npm.io/package/trackjs/versions

## README

TrackJS Browser Agent
===============

The browser agent for collecting errors from JavaScript, Network, and console
exceptions. The agent wraps the browser API to record context about your
application, network, and visitor, and include that context when unhandled
errors occur.

You'll need a TrackJS account to use this agent. If you don't have one, [why not
start a free trial today?](https://trackjs.com/signup)

## Quick Start

1. [Signup for TrackJS](https://trackjs.com/signup) and get your token.
2. Add a dependency on TrackJS with `npm install trackjs --save`
3. Install the agent in your app. You can paste the script tags into the
`<head>` of your HTML:

```html
<script src="PATH_TO_TRACKJS/t.js"></script>
<script>
  window.TrackJS && TrackJS.install({ token: 'YOUR_TOKEN_HERE' });
</script>
```

Or you can bundle it as a module into your application.

```javascript
import { TrackJS } from 'trackjs';
TrackJS.install({ token: 'YOUR_TOKEN_HERE' });
```

4. Test it out by calling `TrackJS.track('testing!')` somewhere in your
application.
5. You should see your error on [TrackJS](https://my.trackjs.com/recent) within
a few seconds.


## More Information

You can find more information about how to install and configure the agent in
the [TrackJS Documentation](https://docs.trackjs.com/). If you run into any
trouble, let us know right away at `hello@trackjs.com`

---
_Source: https://npm.io/package/trackjs · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._