Referrer
Node referrer parser and tools (with express middleware).
DO NOT USE
How To Use
Install
npm install referrer
Usage
var referrer = ;referrer;
Express.js Middleware
var referrer = express = ; var app = ; // use middleware (creates a 'referrer' property on 'req')app; app; app; var port = 8000;app;console;
Default Matchers
Social
- Google+
Search
- Bing
- Yahoo
- Baidu
- Yandex
- Naver
- Daum
- Nate
Email Clients
- Gmail
- Yahoo
- Hotmail
- Naver
- Daum
Ads
- Bing
- Yahoo
Internal
Internal referrers occur when a visitor navigates between two pages on the same domain. Example: http://site.com => http://site.com/about
Link
If there is a referrer present but it's unrecognized, we'll just call it a link referrer.
Direct
When a visitor navigates to a site by typing in the url into the address bar, document.referrer
is blank. This is called a direct referral.
Add Default Matchers
Matchers help identify and attach more semantic information to referral sources. If you'd like to help with adding the hundreds of social, search, ad, and other referral sources not matched yet then see below.
To add matchers:
- Using existing matchers as an example, create your matcher at /lib/matchers.json.
- Add your test cases to the test cases file.
- Run and confirm that your test cases pass:
npm test
- Add your matcher to the readme.
- Submit your pull request!
OR
- Submit a Feature Request Issue with the details of the referral source and I'll add it.
Use Custom Matchers
- Coming soon.
Disable Default Matchers
- Coming soon.