Skip to content

Browser extension to collect error samples from web pages with the `trackx` client.

License

Notifications You must be signed in to change notification settings

maxmilton/trackx-magnet

Repository files navigation

Build status Coverage status Chrome web store version Licence

trackx-magnet

A browser extension to collect error data samples for TrackX development.

View event reports at https://dash.trackx.app/projects/trackx-magnet.

Features

  • Inject trackx client into visited web pages
    • Send error report events on captured errors
    • Send a session ping (to count error-free sessions)
  • Modify CSP headers to allow connecting to a TrackX API
  • Preserve privacy — Don't inject client or send anything when specific data matches our curated block list (phrases related to logins, banking, porn, etc.)

TODO

  • Customisable Track API URL
    • Not possible without recompiling the extension so provide good documentation about how to do that
  • User maintained block list + easily add the current URL origin to it

How to install

TODO: Add Firefox install instructions

Verified testers can install directly from the Chrome Web Store:

Add to Chrome

Manual local install

  1. Download the latest release's chrome-extension.zip file from https://github.com/maxmilton/trackx-magnet/releases
  2. Open chrome://extensions
  3. Enable developer mode
  4. Depending on your OS:
    1. Windows/macOS: Drag .zip file into the page
    2. Linux: Unzip then click "load unpacked" button and select the directory

Browser support

Up-to-date versions of Google Chrome and other Chromium based browsers (e.g. Brave, Edge).

Bugs

Please report any bugs you encounter on the GitHub issue tracker.

License

MIT license. See LICENSE.

The magnet icon is from twitter/twemoji which is licensed CC-BY 4.0.


© 2023 Max Milton

About

Browser extension to collect error samples from web pages with the `trackx` client.

Resources

License

Stars

Watchers

Forks

Packages

No packages published