Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@honeybadger-io/js

Package Overview
Dependencies
Maintainers
8
Versions
99
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@honeybadger-io/js

Universal (Browser & Node) JavaScript error notifier for Honeybadger.io

  • 6.4.3
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
56K
increased by23.76%
Maintainers
8
Weekly downloads
 
Created
Source

Honeybadger for JavaScript

Node CI npm version npm dm npm dt

Universal JavaScript library for integrating apps with the :zap: Honeybadger Error Notifier.

Documentation and Support

For comprehensive documentation and support, check out our documentation site.

Development

Bundling and types

This project is isomorphic, meaning it's a single library which contains both browser and server builds. It's written in TypeScript, and transpiled and bundled with Rollup. Our Rollup config generates three main files:

  1. The server build, which transpiles src/server.ts and its dependencies into dist/server/honeybadger.js.
  2. The browser build, which transpiles src/browser.ts and its dependencies into dist/browser/honeybadger.js.
  3. The minified browser build, which transpiles src/browser.ts and its dependencies into dist/browser/honeybadger.min.js (+ source maps).

In addition, the TypeScript type declaration for each build is generated into its types/ directory (ie dist/browser/types/browser.d.ts and dist/server/types/server.d.ts).

However, since the package is isomorphic, TypeScript users will likely be writing import Honeybadger from '@honeybadger-io/js' or import Honeybadger = require('@honeybadger-io/js') in their IDE. Our package.json has main and browser fields that determine which build they get, but there can only be a single type declaration file. So we use an extra file in the project root, honeybadger.d.ts, that combines the types from both builds.

Tests

  1. To run unit tests for both browser and server builds: npm test. Or separately: npm run test:browser, npm run test:server.
  2. To run integration tests across all supported platforms, set up a BrowserStack account and use BROWSERSTACK_USERNAME=your_username BROWSERSTACK_ACCESS_KEY=your-access-key npm run test:integration.
  3. To test the TypeScript type definitions: npm run tsd.

Releasing

This package comes with a postpublish script (scripts/release-cdn.sh) which is executed every time a new version is released to NPM. The script publishes to our js.honeybadger.io CDN (hosted on AWS via S3/CloudFront).

For the CDN release, make sure you have the following environment variable available in your shell:

export HONEYBADGER_JS_S3_BUCKET=honeybadger-js
export HONEYBADGER_DISTRIBUTION_ID=cloudfront-id

AWS credentials are read from ~/.aws/credentials, using the default profile.

If the CDN release fails for some reason (bad AWS credentials, for instance), re-run the release manually with by executing the script npm run postpublish.



We use BrowserStack to run our automated integration tests on multiple platforms in CI.

License

This package is MIT licensed. See the MIT-LICENSE file in this folder for details.

Keywords

FAQs

Package last updated on 07 Sep 2023

Did you know?

Socket

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.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc