Skip to content

Invoke actions on web pages by typing specific words

License

Notifications You must be signed in to change notification settings

Krisell/type-trigger

Repository files navigation

TypeTrigger

Invoke actions on web pages by typing specific words. Zero runtime dependencies and < 1KB using Brotli compression.

Install

npm i @krisell/type-trigger

How to use

import TypeTrigger from '@krisell/type-trigger'

TypeTrigger.register('beta', () => {
  // Whatever action you want, for instance `showBeta.value = true` in a Vue app
})

TypeTrigger.register('localtesting', () => {
  // Whatever other action you want, for instance `apiURL = 'http://localhost:5000'`
})

As soon as you type beta or localtesting on the keyboard, the actions will be invoked. As soon as an unrecognized pattern is written, the detection is reset, i.e. typing bettabeetaSomeRandombeta will trigger on the last four characters, not before. Typing monkeycode would trigger both monkey and keycode.

Use cases

  • Activate beta features
  • Redirect requests to local/testing domains
  • Show debug information (nothing secret though)
  • Administrative work, e.g. login as other user (of course provided user has authorization)

The trigger words are not intended to be secret or sensitive, just undocumented for the end-user. I have found it much easier to remember and use a trigger word than forcing someone to add a custom LocalStorage value or add a query parameter for testing purposes.

Notes

TypeTrigger listens for keypress events on window.document. Changing this to a specified dom element could be a future addition, feel free to add an issue or send in a PR. Note however that it only listens after the first registration, i.e. only importing the package does not activate it or add the listener. It uses one listener in total, not one per registration.

If you stop the propagation of keypress events before it bubbles up to window.document, it will not reach this package.

Licence

MIT

About

Invoke actions on web pages by typing specific words

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published