@segment/in-eu
Version:
Privacy conscious EU detection browser library
51 lines (36 loc) • 1.3 kB
Markdown
# 🇪🇺 in-eu
> Privacy conscious EU detection browser library
`in-eu` is a library for roughly detecting whether a website user is in the EU, without requiring a roundtrip to your server or a lookup against a GeoIP database.
It uses the browser's timezone (via the brilliant [jstz](https://github.com/iansinnott/jstz) and [locale](https://developer.mozilla.org/en-US/docs/Web/API/NavigatorLanguage/language) (`navigator.languages`) to infer whether someone is in the EU.
`in-eu` trades absolute accuracy for a cautious approach that's more lightweight and respectful of end-user privacy.
## Usage
```bash
$ npm install /in-eu
```
```javascript
import inEU from '/in-eu'
inEU()
// => true | false
```
or try one of the more specific helpers:
```javascript
import { isInEUTimezone } from '/in-eu'
/*
Only checks the browser timezone.
Useful for checking if someone is physically present in the EU
*/
isInEUTimezone()
// => true | false
```
```javascript
import { isEULocale } from '/in-eu'
/*
Only uses the browser's language/locale
Useful for checking if someone speaks an european language accounting
for locale. e.g. pt-PT (portuguese from Portugal)
*/
isEULocale()
// => true | false
```
## License
in-eu is released under the MIT license.