https://github.com/superioone/prime_detector
Basic browser tracker to detect users with certain text selection behavior.
https://github.com/superioone/prime_detector
bloatware meme prime user-tracker
Last synced: 7 months ago
JSON representation
Basic browser tracker to detect users with certain text selection behavior.
- Host: GitHub
- URL: https://github.com/superioone/prime_detector
- Owner: SuperioOne
- License: other
- Created: 2024-05-18T10:20:29.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-05-21T17:32:02.000Z (over 1 year ago)
- Last Synced: 2025-02-25T20:06:55.134Z (8 months ago)
- Topics: bloatware, meme, prime, user-tracker
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/prime_detector
- Size: 9.77 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Prime Detection (No, it's nothing to do with prime numbers)
Basic tracker to detect users with OCD triggering text selection behaviors.
## Usage - Browser
Add `prime_detector.min.js` and use global `prime_detector` to setup your handlers.
```html
prime_detector.init_listener();
window.addEventListener("brazil-mentioned", () => { alert("Hit!"); });
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
```
## Usage - ES/CommonJS/Bloatware
Install, import, initialize and listen for events.
```javascript
import {init_listener} from "prime_detector";
const handle = init_listener();
window.addEventListener("brazil-mentioned", () => {
console.debug("Potential prime user detected.");
// Generate unique finger-print, display memes, idk use your imagination.
});
// handle.stop_it_get_some_help(); // You can always stop the event listener with returned handle object.
```
## Customizing the listener
By default, `init_listener` listens `selectionchange` event on `document` and dispatches custom `brazil-mentioned` event on `window`. You can customize event name, target and source nodes, event debouncer etc.
```javascript
const options = {
target: my_article, // Target DOM node to check for selection and dispatch events. Default is 'window'.
debounce: 1500, // Selection event debounce time. Default is 1000 milliseconds.
event_name: "gotcha" // Custom event name. Default event name is 'brazil-mentioned' to make it more immersive.
};
const handle = init_listener(options);
```
## Custom
If you don't want to use global event listener, you can always call the detection check manually.
```javascript
import {detect_prime} from "prime_detector";
function your_own_trigger(){
// detect_prime also accepts target node as an argument to limit scope.
if (detect_prime()) {
alert("HIT");
} else {
console.debug("Just a regular normie.");
}
}
```