Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
 LeoVasanko
|
a225bacfc4 | ||
|
LeoVasanko
|
f25bfafbc7 | ||
|
LeoVasanko
|
7ae4fab180 | ||
|
LeoVasanko
|
5bbd9a5484 |
+8
-1
@@ -2,10 +2,17 @@
|
||||
__pycache__/
|
||||
*.py[oc]
|
||||
build/
|
||||
dist/
|
||||
/dist/
|
||||
wheels/
|
||||
*.egg-info
|
||||
|
||||
.*
|
||||
!.gitignore
|
||||
!*/.prettierrc.json
|
||||
*.lock
|
||||
|
||||
# JS build artifacts
|
||||
node_modules/
|
||||
package-lock.json
|
||||
uarite-js/dist/*
|
||||
!uarite-js/dist/uarite.min.js
|
||||
|
||||
@@ -1,19 +1,17 @@
|
||||
# User-Agent Parsing Done Right
|
||||
|
||||
There are plenty of UA parsers for Python: ua-parser is the official Python port of the large upstream project, while user-agents builds on top of it with higher-level device detection. Among newer implementations, user-agent-parser is the most promising and is included here for comparison.
|
||||
|
||||
This module takes a smaller, faster, modern approach. It's a dependency-free pure-Python parser weighing only 25 kB, with strong handling of current browsers and crawlers. Despite its light weight, uarite identifies both browsers and crawlers more accurately than any competing implementation tested here.
|
||||
Fast and accurate handling of modern browsers and crawlers. Despite its light weight, uarite identifies both browsers and crawlers more accurately than any competing implementation tested here. Despite being pure Python, it outperforms ua-parser's C++/Rust variants. We also provide a [JavaScript uarite](https://www.npmjs.com/package/@vasanko/uarite) with exact same output.
|
||||
|
||||
It returns structured classification, but also the thing most applications eventually need: **a short pretty description**.
|
||||
|
||||
## Usage
|
||||
|
||||
Add it to your project:
|
||||
|
||||
```sh
|
||||
uv add uarite
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
```python
|
||||
from uarite import uaparse
|
||||
|
||||
@@ -52,56 +50,61 @@ The engine and os fields are intentionally broad. The kind field distinguishes b
|
||||
|
||||
Detection is necessarily limited by what the User-Agent reveals. Crawlers can masquerade as ordinary browsers or other crawlers, so sites that need stronger identification should use additional methods rather than relying on UA detection alone.
|
||||
|
||||
## Accuracy
|
||||
## Comparison
|
||||
|
||||
The table below compares representative User-Agent formats with ua-parser. user-agents produces nearly identical results and is left out.
|
||||
There are plenty of UA parsers for Python. This comparison includes the ua-parser family — the official port of the large upstream project, benchmarked with all three of its regex backends (Python, RE2, Rust) — plus user-agents, which builds on it with higher-level device detection, and fastuaparser, a single-file heuristic parser in the same weight class as uarite. Among those excluded: user-agent-parser crashes on real-world strings; httpagentparser misidentifies most bots and browser OSes; device-detector has a massive 26 MB install and extremely slow parsing; and crawlerdetect only distinguishes bots from non-bots. The user-agents package has been unmaintained since 2020 but is kept as a reference point.
|
||||
|
||||
| Case | uarite¹ | ua-parser² |
|
||||
| ---------------------------- | ------------------------- | --------------------------------------------- |
|
||||
| Chrome, Windows | Chrome/152 Windows | Chrome/152 Windows |
|
||||
| Safari, macOS | Safari/18 macOS | Safari/18 Mac OS X Mac |
|
||||
| Opera, Linux | Opera/106 Linux | Opera/106 Linux |
|
||||
| Chrome, Android (no model) | Chrome/152 Android | Chrome Mobile/152 Android K❌ |
|
||||
| Chrome, Android (Pixel) | Chrome/118 Pixel 6 | Chrome Mobile/118 Android Pixel 6 |
|
||||
| Edge, Android (model code) | Edge/110 Galaxy S7 | Edge Mobile/110 Android Samsung SM-G930P |
|
||||
| Firefox, Android | Firefox/154 Android 15 | Firefox Mobile/154 Android Generic Smartphone |
|
||||
| Safari, iPhone | iPhone iOS 17 | Mobile Safari/17 iOS iPhone |
|
||||
| Huawei HarmonyOS phone | HuaweiBrowser/6 HarmonyOS | Huawei Browser/6 Android❌ Huawei Browser |
|
||||
| GPTBot | GPTBot (AI) | GPTBot/1 Spider |
|
||||
| Googlebot (disguised) | Googlebot (search) | Googlebot/2 Android❌ Spider |
|
||||
| Facebook preview (disguised) | Facebook | FacebookBot/1 Android Pixel 7 ❌ |
|
||||
| Meta crawler (disguised) | Meta-ExternalAgent (AI) | Chrome/145 Windows ❌ |
|
||||
| WhatsApp preview | WhatsApp | WhatsApp/10 Spider |
|
||||
| Bytespider | Bytespider | Bytespider/ Android❌ Generic Smartphone |
|
||||
| BingPreview | BingPreview | BingPreview/1 Windows❌ Spider |
|
||||
| AhrefsBot | AhrefsBot | AhrefsBot/7 Spider |
|
||||
| python-requests | python-requests/2.32.5 | Python Requests/2 |
|
||||
|
||||
- ❌ marks an incorrect data such as OS from disquise or Android 10; K (compat) on modern devices
|
||||
- ¹ `r.pretty` shown as is
|
||||
- ² `{r.user_agent.family}/{r.user_agent.major} {r.os.family} {r.device.family}`
|
||||
|
||||
On our modern-browser test set, **uarite resolves family, version, and OS at 100%**. ua-parser and user-agents score 80%, while user-agent-parser reaches 92%.
|
||||
|
||||
Crawler detection was tested against real-world UAs from [monperrus/crawler-user-agents](https://github.com/monperrus/crawler-user-agents). user-agent-parser scored 32%, user-agents 60%, and ua-parser 64%. **uarite scores 97%**, identifying the specific crawler by name in 80% of cases.
|
||||
Installed size tracks the design. The minimal heuristic parsers are tiny: fastuaparser installs in 15 kB, uarite in 30 kB. Everything built on ua-parser's regex database starts around half a megabyte, and its accelerated backends add several megabytes of native code.
|
||||
|
||||
The benchmark and test scripts are available in the repository's scripts folder.
|
||||
|
||||
## Performance
|
||||
### Accuracy
|
||||
|
||||
Import and first parse takes about **10 ms** for uarite, compared with 50–90 ms for ua-parser depending on backend.
|
||||
The table below compares representative User-Agent formats with fastuaparser and ua-parser. The user-agents wrapper produces nearly identical results to ua-parser and is left out.
|
||||
|
||||
|
||||
_User-Agents parsed per second per CPU core, first parse of unseen strings, with equal shares of browser and crawler UAs. One-off setup costs excluded._
|
||||
| Case | uarite¹ | fastuaparser² | ua-parser³ |
|
||||
| ---------------------------- | ------------------------- | ------------------------- | --------------------------------------------- |
|
||||
| Chrome, Windows | Chrome/152 Windows | Chrome - Windows | Chrome/152 Windows |
|
||||
| Safari, macOS | Safari/18 macOS | Safari - Mac OS X | Safari/18 Mac OS X Mac |
|
||||
| Opera, Linux | Opera/106 Linux | Opera - Linux | Opera/106 Linux |
|
||||
| Chrome, Android (no model) | Chrome/152 Android | Chrome - Android Mobile | Chrome Mobile/152 Android K❌ |
|
||||
| Chrome, Android (Pixel) | Chrome/118 Pixel 6 | Chrome - Android Mobile | Chrome Mobile/118 Android Pixel 6 |
|
||||
| Edge, Android (model code) | Edge/110 Galaxy S7 | Edge - Android Mobile | Edge Mobile/110 Android Samsung SM-G930P |
|
||||
| Firefox, Android | Firefox/154 Android 15 | Firefox - Android Mobile | Firefox Mobile/154 Android Generic Smartphone |
|
||||
| Safari, iPhone | iPhone iOS 17 | Safari - iOS Mobile | Mobile Safari/17 iOS iPhone |
|
||||
| Huawei HarmonyOS phone | HuaweiBrowser/6 HarmonyOS | Chrome - Android Mobile❌ | Huawei Browser/6 Android❌ Huawei Browser |
|
||||
| GPTBot | GPTBot (AI) | Bot | GPTBot/1 Spider |
|
||||
| Googlebot (disguised) | Googlebot (search) | Bot | Googlebot/2 Android❌ Spider |
|
||||
| Facebook preview (disguised) | Facebook | Chrome - Android Mobile❌ | FacebookBot/1 Android Pixel 7 ❌ |
|
||||
| Meta crawler (disguised) | Meta-ExternalAgent (AI) | Bot | Chrome/145 Windows ❌ |
|
||||
| WhatsApp preview | WhatsApp | Browser - Other❌ | WhatsApp/10 Spider |
|
||||
| Bytespider | Bytespider | Bot | Bytespider/ Android❌ Generic Smartphone |
|
||||
| BingPreview | BingPreview | Browser - Windows❌ | BingPreview/1 Windows❌ Spider |
|
||||
| AhrefsBot | AhrefsBot | Bot | AhrefsBot/7 Spider |
|
||||
| python-requests | python-requests/2.32.5 | Other | Python Requests/2 |
|
||||
|
||||
All parsers cache results. With cache hits, **uarite reaches about 36 million lookups per second**, compared with about 5 million for ua-parser and 600 000 for user-agents.
|
||||
- ❌ marks incorrect data such as an OS from disguise, Android 10; K (compat) on modern devices, or a missed identity
|
||||
- ¹ `r.pretty` shown as is
|
||||
- ² `parse_ua(ua)` shown as is
|
||||
- ³ `{r.user_agent.family}/{r.user_agent.major} {r.os.family} {r.device.family}`
|
||||
|
||||
On our modern-browser test set, scoring only fully correct results (family, version, and OS all right): **uarite 100%**, ua-parser and user-agents 79%. The fastuaparser heuristic resolves the family and OS in 91% of cases, but reports no version numbers at all, so it cannot be scored on the full criterion.
|
||||
|
||||
Crawler detection was tested against [real world UAs](https://github.com/monperrus/crawler-user-agents): **uarite 97%**, fastuaparser 84%, ua-parser 64%, user-agents 60%.
|
||||
|
||||
### Performance
|
||||
|
||||
Import and first parse takes about **10 ms** for uarite and effectively nothing for fastuaparser, compared with 50–90 ms for ua-parser depending on backend.
|
||||
|
||||
|
||||
_User-Agents parsed per second per CPU core, first parse of unseen strings, with equal shares of browser and crawler UAs. One-off setup costs excluded. Cached results and fastuaparser (1 million) are left out of the graph._
|
||||
|
||||
On raw speed fastuaparser wins: a few string searches per UA, no cache needed. The trade-off shows in the accuracy table above. All other parsers cache results. With cache hits, **uarite reaches about 36 million lookups per second**, compared with about 5 million for ua-parser and 600 000 for user-agents.
|
||||
|
||||
## Why yet another UA parser
|
||||
|
||||
Rather than relying on a large historical regex database, the parser focuses on modern UA formats and parses them directly, choosing the most specific interpretation available. This keeps the implementation small while handling today's browsers and crawler traffic well.
|
||||
|
||||
Until now, I had been using those other modules and building my own pretty-UA formatting on top of them, fixing by post processing issues the upstream didn't care of.
|
||||
Rather than relying on a large historical regex database, the parser focuses on modern UA formats and parses them directly, choosing the most specific interpretation available. This keeps the implementation small while handling today's browsers and crawler traffic well. Until now, I had been using those other modules and building my own pretty-UA formatting on top of them, fixing by post processing issues the upstream didn't care of.
|
||||
|
||||
Eventually it became easier to start over with a parser designed around modern traffic. The result is uarite.
|
||||
|
||||
Hopefully it helps you too.
|
||||
Hopefully it helps you too. Star my [GitHub](https://github.com/leovasanko/uarite) if it did.
|
||||
|
||||
+267
-285
@@ -1,12 +1,12 @@
|
||||
<?xml version="1.0" encoding="utf-8" standalone="no"?>
|
||||
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
|
||||
"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
|
||||
<svg xmlns:xlink="http://www.w3.org/1999/xlink" width="864pt" height="122.4pt" viewBox="0 0 864 122.4" xmlns="http://www.w3.org/2000/svg" version="1.1">
|
||||
<svg xmlns:xlink="http://www.w3.org/1999/xlink" width="758.3677pt" height="86.04pt" viewBox="0 0 758.3677 86.04" xmlns="http://www.w3.org/2000/svg" version="1.1">
|
||||
<metadata>
|
||||
<rdf:RDF xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:cc="http://creativecommons.org/ns#" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
|
||||
<cc:Work>
|
||||
<dc:type rdf:resource="http://purl.org/dc/dcmitype/StillImage"/>
|
||||
<dc:date>2026-09-08T21:11:49.096249</dc:date>
|
||||
<dc:date>2026-09-09T18:32:39.096963</dc:date>
|
||||
<dc:format>image/svg+xml</dc:format>
|
||||
<dc:creator>
|
||||
<cc:Agent>
|
||||
@@ -21,67 +21,128 @@
|
||||
</defs>
|
||||
<g id="figure_1">
|
||||
<g id="patch_1">
|
||||
<path d="M 0 122.4
|
||||
L 864 122.4
|
||||
L 864 0
|
||||
<path d="M 0 86.04
|
||||
L 758.3677 86.04
|
||||
L 758.3677 0
|
||||
L 0 0
|
||||
L 0 122.4
|
||||
L 0 86.04
|
||||
z
|
||||
" style="fill: none"/>
|
||||
</g>
|
||||
<g id="axes_1">
|
||||
<g id="patch_2">
|
||||
<path d="M 2 115.018182
|
||||
L 23.088517 115.018182
|
||||
L 23.088517 99.852921
|
||||
L 2 99.852921
|
||||
<path d="M 1.44 80.82
|
||||
L 38.571238 80.82
|
||||
L 38.571238 67.958589
|
||||
L 1.44 67.958589
|
||||
z
|
||||
" clip-path="url(#pc2d639e53a)" style="fill: #6e6e6e"/>
|
||||
" clip-path="url(#p4041b231bc)" style="fill: #6e6e6e"/>
|
||||
</g>
|
||||
<g id="patch_3">
|
||||
<path d="M 2 96.523961
|
||||
L 23.934681 96.523961
|
||||
L 23.934681 81.3587
|
||||
L 2 81.3587
|
||||
<path d="M 1.44 65.135353
|
||||
L 40.996285 65.135353
|
||||
L 40.996285 52.273942
|
||||
L 1.44 52.273942
|
||||
z
|
||||
" clip-path="url(#pc2d639e53a)" style="fill: #6e6e6e"/>
|
||||
" clip-path="url(#p4041b231bc)" style="fill: #6e6e6e"/>
|
||||
</g>
|
||||
<g id="patch_4">
|
||||
<path d="M 2 78.029741
|
||||
L 93.465629 78.029741
|
||||
L 93.465629 62.86448
|
||||
L 2 62.86448
|
||||
<path d="M 1.44 49.450705
|
||||
L 169.540418 49.450705
|
||||
L 169.540418 36.589295
|
||||
L 1.44 36.589295
|
||||
z
|
||||
" clip-path="url(#pc2d639e53a)" style="fill: #6e6e6e"/>
|
||||
" clip-path="url(#p4041b231bc)" style="fill: #6e6e6e"/>
|
||||
</g>
|
||||
<g id="patch_5">
|
||||
<path d="M 2 59.53552
|
||||
L 153.330472 59.53552
|
||||
L 153.330472 44.370259
|
||||
L 2 44.370259
|
||||
<path d="M 1.44 33.766058
|
||||
L 317.786457 33.766058
|
||||
L 317.786457 20.904647
|
||||
L 1.44 20.904647
|
||||
z
|
||||
" clip-path="url(#pc2d639e53a)" style="fill: #6e6e6e"/>
|
||||
" clip-path="url(#p4041b231bc)" style="fill: #6e6e6e"/>
|
||||
</g>
|
||||
<g id="patch_6">
|
||||
<path d="M 2 41.0413
|
||||
L 400.418079 41.0413
|
||||
L 400.418079 25.876039
|
||||
L 2 25.876039
|
||||
<path d="M 1.44 18.081411
|
||||
L 671.04 18.081411
|
||||
L 671.04 5.22
|
||||
L 1.44 5.22
|
||||
z
|
||||
" clip-path="url(#pc2d639e53a)" style="fill: #2b6cb0"/>
|
||||
</g>
|
||||
<g id="patch_7">
|
||||
<path d="M 2 22.547079
|
||||
L 862 22.547079
|
||||
L 862 7.381818
|
||||
L 2 7.381818
|
||||
z
|
||||
" clip-path="url(#pc2d639e53a)" style="fill: #6e6e6e"/>
|
||||
" clip-path="url(#p4041b231bc)" style="fill: #2b6cb0"/>
|
||||
</g>
|
||||
<g id="text_1">
|
||||
<!-- user-agents 3 000 -->
|
||||
<g style="fill: #767676" transform="translate(33.408517 111.957453) scale(0.11 -0.11)">
|
||||
<!-- 3 100 user-agents -->
|
||||
<g style="fill: #767676" transform="translate(46.606438 78.658335) scale(0.11 -0.11)">
|
||||
<defs>
|
||||
<path id="DejaVuSans-16" d="M 2597 2516
|
||||
Q 3050 2419 3304 2112
|
||||
Q 3559 1806 3559 1356
|
||||
Q 3559 666 3084 287
|
||||
Q 2609 -91 1734 -91
|
||||
Q 1441 -91 1130 -33
|
||||
Q 819 25 488 141
|
||||
L 488 750
|
||||
Q 750 597 1062 519
|
||||
Q 1375 441 1716 441
|
||||
Q 2309 441 2620 675
|
||||
Q 2931 909 2931 1356
|
||||
Q 2931 1769 2642 2001
|
||||
Q 2353 2234 1838 2234
|
||||
L 1294 2234
|
||||
L 1294 2753
|
||||
L 1863 2753
|
||||
Q 2328 2753 2575 2939
|
||||
Q 2822 3125 2822 3475
|
||||
Q 2822 3834 2567 4026
|
||||
Q 2313 4219 1838 4219
|
||||
Q 1578 4219 1281 4162
|
||||
Q 984 4106 628 3988
|
||||
L 628 4550
|
||||
Q 988 4650 1302 4700
|
||||
Q 1616 4750 1894 4750
|
||||
Q 2613 4750 3031 4423
|
||||
Q 3450 4097 3450 3541
|
||||
Q 3450 3153 3228 2886
|
||||
Q 3006 2619 2597 2516
|
||||
z
|
||||
" transform="scale(0.015625)"/>
|
||||
<path id="DejaVuSans-62" transform="scale(0.015625)"/>
|
||||
<path id="DejaVuSans-14" d="M 794 531
|
||||
L 1825 531
|
||||
L 1825 4091
|
||||
L 703 3866
|
||||
L 703 4441
|
||||
L 1819 4666
|
||||
L 2450 4666
|
||||
L 2450 531
|
||||
L 3481 531
|
||||
L 3481 0
|
||||
L 794 0
|
||||
L 794 531
|
||||
z
|
||||
" transform="scale(0.015625)"/>
|
||||
<path id="DejaVuSans-13" d="M 2034 4250
|
||||
Q 1547 4250 1301 3770
|
||||
Q 1056 3291 1056 2328
|
||||
Q 1056 1369 1301 889
|
||||
Q 1547 409 2034 409
|
||||
Q 2525 409 2770 889
|
||||
Q 3016 1369 3016 2328
|
||||
Q 3016 3291 2770 3770
|
||||
Q 2525 4250 2034 4250
|
||||
z
|
||||
M 2034 4750
|
||||
Q 2819 4750 3233 4129
|
||||
Q 3647 3509 3647 2328
|
||||
Q 3647 1150 3233 529
|
||||
Q 2819 -91 2034 -91
|
||||
Q 1250 -91 836 529
|
||||
Q 422 1150 422 2328
|
||||
Q 422 3509 836 4129
|
||||
Q 1250 4750 2034 4750
|
||||
z
|
||||
" transform="scale(0.015625)"/>
|
||||
<path id="DejaVuSans-3" transform="scale(0.015625)"/>
|
||||
<path id="DejaVuSans-58" d="M 544 1381
|
||||
L 544 3500
|
||||
L 1119 3500
|
||||
@@ -290,86 +351,31 @@ L 594 3500
|
||||
L 594 4494
|
||||
L 1172 4494
|
||||
z
|
||||
" transform="scale(0.015625)"/>
|
||||
<path id="DejaVuSans-3" transform="scale(0.015625)"/>
|
||||
<path id="DejaVuSans-16" d="M 2597 2516
|
||||
Q 3050 2419 3304 2112
|
||||
Q 3559 1806 3559 1356
|
||||
Q 3559 666 3084 287
|
||||
Q 2609 -91 1734 -91
|
||||
Q 1441 -91 1130 -33
|
||||
Q 819 25 488 141
|
||||
L 488 750
|
||||
Q 750 597 1062 519
|
||||
Q 1375 441 1716 441
|
||||
Q 2309 441 2620 675
|
||||
Q 2931 909 2931 1356
|
||||
Q 2931 1769 2642 2001
|
||||
Q 2353 2234 1838 2234
|
||||
L 1294 2234
|
||||
L 1294 2753
|
||||
L 1863 2753
|
||||
Q 2328 2753 2575 2939
|
||||
Q 2822 3125 2822 3475
|
||||
Q 2822 3834 2567 4026
|
||||
Q 2313 4219 1838 4219
|
||||
Q 1578 4219 1281 4162
|
||||
Q 984 4106 628 3988
|
||||
L 628 4550
|
||||
Q 988 4650 1302 4700
|
||||
Q 1616 4750 1894 4750
|
||||
Q 2613 4750 3031 4423
|
||||
Q 3450 4097 3450 3541
|
||||
Q 3450 3153 3228 2886
|
||||
Q 3006 2619 2597 2516
|
||||
z
|
||||
" transform="scale(0.015625)"/>
|
||||
<path id="DejaVuSans-62" transform="scale(0.015625)"/>
|
||||
<path id="DejaVuSans-13" d="M 2034 4250
|
||||
Q 1547 4250 1301 3770
|
||||
Q 1056 3291 1056 2328
|
||||
Q 1056 1369 1301 889
|
||||
Q 1547 409 2034 409
|
||||
Q 2525 409 2770 889
|
||||
Q 3016 1369 3016 2328
|
||||
Q 3016 3291 2770 3770
|
||||
Q 2525 4250 2034 4250
|
||||
z
|
||||
M 2034 4750
|
||||
Q 2819 4750 3233 4129
|
||||
Q 3647 3509 3647 2328
|
||||
Q 3647 1150 3233 529
|
||||
Q 2819 -91 2034 -91
|
||||
Q 1250 -91 836 529
|
||||
Q 422 1150 422 2328
|
||||
Q 422 3509 836 4129
|
||||
Q 1250 4750 2034 4750
|
||||
z
|
||||
" transform="scale(0.015625)"/>
|
||||
</defs>
|
||||
<use xlink:href="#DejaVuSans-58"/>
|
||||
<use xlink:href="#DejaVuSans-56" transform="translate(63.375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-48" transform="translate(115.46875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(177 0)"/>
|
||||
<use xlink:href="#DejaVuSans-10" transform="translate(211.71875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(247.796875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-4a" transform="translate(309.078125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-48" transform="translate(372.5625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-51" transform="translate(434.09375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-57" transform="translate(497.46875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-56" transform="translate(536.671875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(588.765625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(620.546875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-16" transform="translate(652.328125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-62" transform="translate(715.953125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(747.734375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(811.359375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(874.984375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-16"/>
|
||||
<use xlink:href="#DejaVuSans-62" transform="translate(63.625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-14" transform="translate(95.40625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(159.03125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(222.65625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(286.28125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(318.0625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-58" transform="translate(349.84375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-56" transform="translate(413.21875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-48" transform="translate(465.3125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(526.84375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-10" transform="translate(561.5625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(597.640625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-4a" transform="translate(658.921875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-48" transform="translate(722.40625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-51" transform="translate(783.9375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-57" transform="translate(847.3125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-56" transform="translate(886.515625 0)"/>
|
||||
</g>
|
||||
</g>
|
||||
<g id="text_2">
|
||||
<!-- ua-parser 3 100 -->
|
||||
<g style="fill: #767676" transform="translate(34.254681 93.463233) scale(0.11 -0.11)">
|
||||
<!-- 3 300 ua-parser -->
|
||||
<g style="fill: #767676" transform="translate(49.031485 62.973687) scale(0.11 -0.11)">
|
||||
<defs>
|
||||
<path id="DejaVuSans-53" d="M 1159 525
|
||||
L 1159 -1331
|
||||
@@ -396,44 +402,49 @@ Q 1681 391 2138 391
|
||||
Q 2594 391 2855 752
|
||||
Q 3116 1113 3116 1747
|
||||
z
|
||||
" transform="scale(0.015625)"/>
|
||||
<path id="DejaVuSans-14" d="M 794 531
|
||||
L 1825 531
|
||||
L 1825 4091
|
||||
L 703 3866
|
||||
L 703 4441
|
||||
L 1819 4666
|
||||
L 2450 4666
|
||||
L 2450 531
|
||||
L 3481 531
|
||||
L 3481 0
|
||||
L 794 0
|
||||
L 794 531
|
||||
z
|
||||
" transform="scale(0.015625)"/>
|
||||
</defs>
|
||||
<use xlink:href="#DejaVuSans-58"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(63.375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-10" transform="translate(124.65625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-53" transform="translate(160.734375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(224.21875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(285.5 0)"/>
|
||||
<use xlink:href="#DejaVuSans-56" transform="translate(326.609375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-48" transform="translate(378.703125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(440.234375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(481.34375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(513.125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-16" transform="translate(544.90625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-62" transform="translate(608.53125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-14" transform="translate(640.3125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(703.9375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(767.5625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-16"/>
|
||||
<use xlink:href="#DejaVuSans-62" transform="translate(63.625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-16" transform="translate(95.40625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(159.03125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(222.65625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(286.28125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(318.0625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-58" transform="translate(349.84375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(413.21875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-10" transform="translate(474.5 0)"/>
|
||||
<use xlink:href="#DejaVuSans-53" transform="translate(510.578125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(574.0625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(635.34375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-56" transform="translate(676.453125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-48" transform="translate(728.546875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(790.078125 0)"/>
|
||||
</g>
|
||||
</g>
|
||||
<g id="text_3">
|
||||
<!-- ua-parser (RE2) 13 000 -->
|
||||
<g style="fill: #767676" transform="translate(103.785629 74.969012) scale(0.11 -0.11)">
|
||||
<!-- 14 000 ua-parser (RE2) -->
|
||||
<g style="fill: #767676" transform="translate(177.575618 47.28904) scale(0.11 -0.11)">
|
||||
<defs>
|
||||
<path id="DejaVuSans-17" d="M 2419 4116
|
||||
L 825 1625
|
||||
L 2419 1625
|
||||
L 2419 4116
|
||||
z
|
||||
M 2253 4666
|
||||
L 3047 4666
|
||||
L 3047 1625
|
||||
L 3713 1625
|
||||
L 3713 1100
|
||||
L 3047 1100
|
||||
L 3047 0
|
||||
L 2419 0
|
||||
L 2419 1100
|
||||
L 313 1100
|
||||
L 313 1709
|
||||
L 2253 4666
|
||||
z
|
||||
" transform="scale(0.015625)"/>
|
||||
<path id="DejaVuSans-b" d="M 1984 4856
|
||||
Q 1566 4138 1362 3434
|
||||
Q 1159 2731 1159 2009
|
||||
@@ -528,102 +539,35 @@ Q 928 4138 513 4856
|
||||
z
|
||||
" transform="scale(0.015625)"/>
|
||||
</defs>
|
||||
<use xlink:href="#DejaVuSans-58"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(63.375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-10" transform="translate(124.65625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-53" transform="translate(160.734375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(224.21875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(285.5 0)"/>
|
||||
<use xlink:href="#DejaVuSans-56" transform="translate(326.609375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-48" transform="translate(378.703125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(440.234375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(481.34375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-b" transform="translate(513.125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-35" transform="translate(552.140625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-28" transform="translate(621.625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-15" transform="translate(684.8125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-c" transform="translate(748.4375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(787.453125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(819.234375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-14" transform="translate(851.015625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-16" transform="translate(914.640625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-62" transform="translate(978.265625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(1010.046875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(1073.671875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(1137.296875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-14"/>
|
||||
<use xlink:href="#DejaVuSans-17" transform="translate(63.625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-62" transform="translate(127.25 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(159.03125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(222.65625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(286.28125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(349.90625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(381.6875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-58" transform="translate(413.46875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(476.84375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-10" transform="translate(538.125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-53" transform="translate(574.203125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(637.6875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(698.96875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-56" transform="translate(740.078125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-48" transform="translate(792.171875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(853.703125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(894.8125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-b" transform="translate(926.59375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-35" transform="translate(965.609375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-28" transform="translate(1035.09375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-15" transform="translate(1098.28125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-c" transform="translate(1161.90625 0)"/>
|
||||
</g>
|
||||
</g>
|
||||
<g id="text_4">
|
||||
<!-- ua-parser (Rust) 21 000 -->
|
||||
<g style="fill: #767676" transform="translate(163.650472 56.474791) scale(0.11 -0.11)">
|
||||
<use xlink:href="#DejaVuSans-58"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(63.375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-10" transform="translate(124.65625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-53" transform="translate(160.734375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(224.21875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(285.5 0)"/>
|
||||
<use xlink:href="#DejaVuSans-56" transform="translate(326.609375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-48" transform="translate(378.703125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(440.234375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(481.34375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-b" transform="translate(513.125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-35" transform="translate(552.140625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-58" transform="translate(617.140625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-56" transform="translate(680.515625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-57" transform="translate(732.609375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-c" transform="translate(771.8125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(810.828125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(842.609375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-15" transform="translate(874.390625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-14" transform="translate(938.015625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-62" transform="translate(1001.640625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(1033.421875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(1097.046875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(1160.671875 0)"/>
|
||||
</g>
|
||||
</g>
|
||||
<g id="text_5">
|
||||
<!-- uarite 56 000 -->
|
||||
<g style="fill: #ffffff" transform="translate(312.245579 37.981001) scale(0.11 -0.11)">
|
||||
<!-- 26 000 ua-parser (Rust) -->
|
||||
<g style="fill: #767676" transform="translate(325.821657 31.604393) scale(0.11 -0.11)">
|
||||
<defs>
|
||||
<path id="DejaVuSans-4c" d="M 603 3500
|
||||
L 1178 3500
|
||||
L 1178 0
|
||||
L 603 0
|
||||
L 603 3500
|
||||
z
|
||||
M 603 4863
|
||||
L 1178 4863
|
||||
L 1178 4134
|
||||
L 603 4134
|
||||
L 603 4863
|
||||
z
|
||||
" transform="scale(0.015625)"/>
|
||||
<path id="DejaVuSans-18" d="M 691 4666
|
||||
L 3169 4666
|
||||
L 3169 4134
|
||||
L 1269 4134
|
||||
L 1269 2991
|
||||
Q 1406 3038 1543 3061
|
||||
Q 1681 3084 1819 3084
|
||||
Q 2600 3084 3056 2656
|
||||
Q 3513 2228 3513 1497
|
||||
Q 3513 744 3044 326
|
||||
Q 2575 -91 1722 -91
|
||||
Q 1428 -91 1123 -41
|
||||
Q 819 9 494 109
|
||||
L 494 744
|
||||
Q 775 591 1075 516
|
||||
Q 1375 441 1709 441
|
||||
Q 2250 441 2565 725
|
||||
Q 2881 1009 2881 1497
|
||||
Q 2881 1984 2565 2268
|
||||
Q 2250 2553 1709 2553
|
||||
Q 1456 2553 1204 2497
|
||||
Q 953 2441 691 2322
|
||||
L 691 4666
|
||||
z
|
||||
" transform="scale(0.015625)"/>
|
||||
<path id="DejaVuSans-19" d="M 2113 2584
|
||||
Q 1688 2584 1439 2293
|
||||
Q 1191 2003 1191 1497
|
||||
@@ -655,58 +599,96 @@ Q 3103 4656 3366 4563
|
||||
z
|
||||
" transform="scale(0.015625)"/>
|
||||
</defs>
|
||||
<use xlink:href="#DejaVuSans-58"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(63.375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(124.65625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-4c" transform="translate(165.765625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-57" transform="translate(193.546875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-48" transform="translate(232.75 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(294.28125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(326.0625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-18" transform="translate(357.84375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-19" transform="translate(421.46875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-62" transform="translate(485.09375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(516.875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(580.5 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(644.125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-15"/>
|
||||
<use xlink:href="#DejaVuSans-19" transform="translate(63.625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-62" transform="translate(127.25 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(159.03125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(222.65625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(286.28125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(349.90625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(381.6875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-58" transform="translate(413.46875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(476.84375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-10" transform="translate(538.125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-53" transform="translate(574.203125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(637.6875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(698.96875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-56" transform="translate(740.078125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-48" transform="translate(792.171875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(853.703125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(894.8125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-b" transform="translate(926.59375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-35" transform="translate(965.609375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-58" transform="translate(1030.609375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-56" transform="translate(1093.984375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-57" transform="translate(1146.078125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-c" transform="translate(1185.28125 0)"/>
|
||||
</g>
|
||||
</g>
|
||||
<g id="text_6">
|
||||
<!-- user-agent-parser 120 000 -->
|
||||
<g style="fill: #ffffff" transform="translate(700.930156 19.48635) scale(0.11 -0.11)">
|
||||
<use xlink:href="#DejaVuSans-58"/>
|
||||
<use xlink:href="#DejaVuSans-56" transform="translate(63.375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-48" transform="translate(115.46875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(177 0)"/>
|
||||
<use xlink:href="#DejaVuSans-10" transform="translate(211.71875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(247.796875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-4a" transform="translate(309.078125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-48" transform="translate(372.5625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-51" transform="translate(434.09375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-57" transform="translate(497.46875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-10" transform="translate(536.671875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-53" transform="translate(572.75 0)"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(636.234375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(697.515625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-56" transform="translate(738.625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-48" transform="translate(790.71875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(852.25 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(893.359375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(925.140625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-14" transform="translate(956.921875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-15" transform="translate(1020.546875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(1084.171875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-62" transform="translate(1147.796875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(1179.578125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(1243.203125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(1306.828125 0)"/>
|
||||
<g id="text_5">
|
||||
<!-- 56 000 uarite -->
|
||||
<g style="fill: #767676" transform="translate(679.0752 15.920175) scale(0.11 -0.11)">
|
||||
<defs>
|
||||
<path id="DejaVuSans-18" d="M 691 4666
|
||||
L 3169 4666
|
||||
L 3169 4134
|
||||
L 1269 4134
|
||||
L 1269 2991
|
||||
Q 1406 3038 1543 3061
|
||||
Q 1681 3084 1819 3084
|
||||
Q 2600 3084 3056 2656
|
||||
Q 3513 2228 3513 1497
|
||||
Q 3513 744 3044 326
|
||||
Q 2575 -91 1722 -91
|
||||
Q 1428 -91 1123 -41
|
||||
Q 819 9 494 109
|
||||
L 494 744
|
||||
Q 775 591 1075 516
|
||||
Q 1375 441 1709 441
|
||||
Q 2250 441 2565 725
|
||||
Q 2881 1009 2881 1497
|
||||
Q 2881 1984 2565 2268
|
||||
Q 2250 2553 1709 2553
|
||||
Q 1456 2553 1204 2497
|
||||
Q 953 2441 691 2322
|
||||
L 691 4666
|
||||
z
|
||||
" transform="scale(0.015625)"/>
|
||||
<path id="DejaVuSans-4c" d="M 603 3500
|
||||
L 1178 3500
|
||||
L 1178 0
|
||||
L 603 0
|
||||
L 603 3500
|
||||
z
|
||||
M 603 4863
|
||||
L 1178 4863
|
||||
L 1178 4134
|
||||
L 603 4134
|
||||
L 603 4863
|
||||
z
|
||||
" transform="scale(0.015625)"/>
|
||||
</defs>
|
||||
<use xlink:href="#DejaVuSans-18"/>
|
||||
<use xlink:href="#DejaVuSans-19" transform="translate(63.625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-62" transform="translate(127.25 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(159.03125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(222.65625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-13" transform="translate(286.28125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(349.90625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-3" transform="translate(381.6875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-58" transform="translate(413.46875 0)"/>
|
||||
<use xlink:href="#DejaVuSans-44" transform="translate(476.84375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-55" transform="translate(538.125 0)"/>
|
||||
<use xlink:href="#DejaVuSans-4c" transform="translate(579.234375 0)"/>
|
||||
<use xlink:href="#DejaVuSans-57" transform="translate(607.015625 0)"/>
|
||||
<use xlink:href="#DejaVuSans-48" transform="translate(646.21875 0)"/>
|
||||
</g>
|
||||
</g>
|
||||
</g>
|
||||
</g>
|
||||
<defs>
|
||||
<clipPath id="pc2d639e53a">
|
||||
<rect x="2" y="2" width="860" height="118.4"/>
|
||||
<clipPath id="p4041b231bc">
|
||||
<rect x="1.44" y="1.44" width="669.6" height="83.16"/>
|
||||
</clipPath>
|
||||
</defs>
|
||||
</svg>
|
||||
|
||||
|
Before Width: | Height: | Size: 21 KiB After Width: | Height: | Size: 19 KiB |
@@ -14,6 +14,7 @@ authors = [
|
||||
]
|
||||
keywords = ["user-agent", "ua-parser"]
|
||||
readme = "README.md"
|
||||
license = "MIT OR Unlicense"
|
||||
requires-python = ">=3.10"
|
||||
classifiers = [
|
||||
"Intended Audience :: Developers",
|
||||
|
||||
+2
-2
@@ -17,7 +17,7 @@ benchmark-only dependencies, pulled ad hoc via `uv run --with`.
|
||||
- `prettytable.py` — prints the accuracy-comparison markdown table:
|
||||
|
||||
```
|
||||
uv run --with ua-parser --with user-agents python scripts/prettytable.py
|
||||
uv run --with ua-parser --with fastuaparser python scripts/prettytable.py
|
||||
```
|
||||
|
||||
- `bench.py` — prints browser-accuracy counts, crawler-detection rates,
|
||||
@@ -25,6 +25,6 @@ benchmark-only dependencies, pulled ad hoc via `uv run --with`.
|
||||
mix, bot storm) with cache statistics:
|
||||
|
||||
```
|
||||
uv run --with ua-parser --with user-agents --with user-agent-parser \
|
||||
uv run --with ua-parser --with user-agents --with fastuaparser \
|
||||
python scripts/bench.py
|
||||
```
|
||||
|
||||
+43
-23
@@ -1,16 +1,16 @@
|
||||
# /// script
|
||||
# requires-python = ">=3.14"
|
||||
# dependencies = [
|
||||
# "fastuaparser>=0.1.4",
|
||||
# "ua-parser[re2,regex]>=1.0.2",
|
||||
# "uarite",
|
||||
# "user-agent-parser>=0.2.1",
|
||||
# "user-agents>=2.2.0",
|
||||
# ]
|
||||
#
|
||||
# [tool.uv.sources]
|
||||
# uarite = { path = "..", editable = true }
|
||||
# ///
|
||||
"""Benchmark uarite vs ua-parser vs user-agents vs user-agent-parser.
|
||||
"""Benchmark uarite vs ua-parser vs user-agents vs fastuaparser.
|
||||
|
||||
Reproduces the README's numbers: browser accuracy on 100 modern UAs,
|
||||
crawler detection on 2163 real-world crawler UAs, and timing (unique UAs,
|
||||
@@ -29,8 +29,8 @@ import timeit
|
||||
from pathlib import Path
|
||||
|
||||
import ua_parser
|
||||
from fastuaparser import parse_ua as fua_parse
|
||||
from ua_parser import parse as ua_parse
|
||||
from user_agent_parser import parse as uap_parse
|
||||
from user_agents import parse as uas_parse
|
||||
|
||||
from uarite import uaparse
|
||||
@@ -74,6 +74,7 @@ def uap_re2(ua):
|
||||
def uap_rust(ua):
|
||||
return ua_variant("rust")(ua)
|
||||
|
||||
|
||||
DATA = Path(__file__).parent / "data"
|
||||
BROWSERS = json.loads((DATA / "top-user-agents.json").read_text())
|
||||
CRAWLERS = json.loads((DATA / "crawler-user-agents.json").read_text())
|
||||
@@ -125,7 +126,6 @@ def score_browsers():
|
||||
for name, fn in (
|
||||
("ua-parser", ua_parse),
|
||||
("user-agents", uas_parse),
|
||||
("user-agent-parser", uap_parse),
|
||||
):
|
||||
fam_ok = ver_ok = os_ok = 0
|
||||
for ua in BROWSERS:
|
||||
@@ -135,10 +135,6 @@ def score_browsers():
|
||||
fam = r.user_agent.family or ""
|
||||
maj = r.user_agent.major or ""
|
||||
osf = r.os.family or ""
|
||||
elif name == "user-agent-parser":
|
||||
fam = r[0] or ""
|
||||
maj = (r[1] or "").split(".")[0]
|
||||
osf = r[2] or ""
|
||||
else:
|
||||
fam = r.browser.family or ""
|
||||
maj = str(r.browser.version[0]) if r.browser.version else ""
|
||||
@@ -148,6 +144,29 @@ def score_browsers():
|
||||
ver_ok += emaj == maj
|
||||
os_ok += eos == norm_os(osf)
|
||||
res[name] = (fam_ok, ver_ok, os_ok)
|
||||
# fastuaparser returns one pretty string ("Chrome - Windows") and no
|
||||
# version numbers, so score it on the substrings it does produce.
|
||||
fam_ok = ver_ok = os_ok = 0
|
||||
for ua in BROWSERS:
|
||||
efam, emaj, eos = expected(ua)
|
||||
pretty = fua_parse(ua)
|
||||
fam_ok += efam.split()[0].lower() in pretty.lower()
|
||||
ver_ok += bool(emaj) and emaj in pretty
|
||||
os_ok += bool(
|
||||
re.search(
|
||||
{
|
||||
"ios": r"iOS|iPhone|iPad",
|
||||
"macos": r"Mac",
|
||||
"windows": r"Windows",
|
||||
"linux": r"Linux",
|
||||
"android": r"Android",
|
||||
}[eos],
|
||||
pretty,
|
||||
)
|
||||
if eos
|
||||
else True
|
||||
)
|
||||
res["fastuaparser"] = (fam_ok, ver_ok, os_ok)
|
||||
fam_ok = ver_ok = os_ok = 0
|
||||
for ua in BROWSERS:
|
||||
efam, emaj, eos = expected(ua)
|
||||
@@ -183,7 +202,7 @@ def score_browsers():
|
||||
def score_crawlers():
|
||||
out = {}
|
||||
crashes = 0
|
||||
for name in ("ua-parser", "user-agents", "user-agent-parser", "uarite"):
|
||||
for name in ("ua-parser", "user-agents", "fastuaparser", "uarite"):
|
||||
det = 0
|
||||
for ua in CRAWLER_UAS:
|
||||
try:
|
||||
@@ -195,14 +214,16 @@ def score_crawlers():
|
||||
)
|
||||
elif name == "user-agents":
|
||||
bot = uas_parse(ua).is_bot
|
||||
elif name == "user-agent-parser":
|
||||
bot = uap_parse(ua)[4] == "Bot"
|
||||
elif name == "fastuaparser":
|
||||
# "Bot" is a real verdict; "Other" is a non-browser
|
||||
# client (wget etc.), which is automated traffic too.
|
||||
bot = fua_parse(ua).split(" - ")[0] in ("Bot", "Other")
|
||||
else:
|
||||
# Anything not recognized as a real browser is automated:
|
||||
# known bots, generic spiders, clients, spoofed claims.
|
||||
bot = uaparse(ua).kind != "browser"
|
||||
except Exception:
|
||||
crashes += name == "user-agent-parser"
|
||||
crashes += name == "fastuaparser"
|
||||
continue
|
||||
det += bot
|
||||
out[name] = det
|
||||
@@ -248,7 +269,7 @@ def bench_realistic():
|
||||
("ua-parser (re2)", uap_re2),
|
||||
("ua-parser (rust)", uap_rust),
|
||||
("user-agents", uas_parse),
|
||||
("user-agent-parser", uap_parse),
|
||||
("fastuaparser", fua_parse),
|
||||
("uarite", uaparse),
|
||||
):
|
||||
fn = safe(fn)
|
||||
@@ -261,7 +282,7 @@ def bench_realistic():
|
||||
("ua-parser (re2)", uap_re2),
|
||||
("ua-parser (rust)", uap_rust),
|
||||
("user-agents", uas_parse),
|
||||
("user-agent-parser", uap_parse),
|
||||
("fastuaparser", fua_parse),
|
||||
("uarite", uaparse),
|
||||
):
|
||||
fn = safe(fn)
|
||||
@@ -285,11 +306,8 @@ def cache_info(name):
|
||||
if name == "uarite":
|
||||
i = uaparse.cache_info()
|
||||
return f"{i.hits} hits / {i.misses} misses (cap 1024)"
|
||||
if name == "user-agent-parser":
|
||||
from user_agent_parser.parser import _cached_parse_user_agent
|
||||
|
||||
i = _cached_parse_user_agent.cache_info()
|
||||
return f"{i.hits} hits / {i.misses} misses (cap 512 LRU)"
|
||||
if name == "fastuaparser":
|
||||
return "none (branch parser, ~1 µs flat)"
|
||||
if name == "user-agents":
|
||||
from ua_parser.user_agent_parser import _PARSE_CACHE
|
||||
|
||||
@@ -318,7 +336,7 @@ def bench():
|
||||
("ua-parser (re2)", uap_re2),
|
||||
("ua-parser (rust)", uap_rust),
|
||||
("user-agents", uas_parse),
|
||||
("user-agent-parser", uap_parse),
|
||||
("fastuaparser", fua_parse),
|
||||
("uarite", uaparse),
|
||||
):
|
||||
fn = safe(fn)
|
||||
@@ -331,8 +349,10 @@ def bench():
|
||||
|
||||
if __name__ == "__main__":
|
||||
res, nwork = bench()
|
||||
print(f"## speed (µs per cold parse, {nwork} unique UAs,"
|
||||
" half browsers / half crawlers)")
|
||||
print(
|
||||
f"## speed (µs per cold parse, {nwork} unique UAs,"
|
||||
" half browsers / half crawlers)"
|
||||
)
|
||||
for k, v in res.items():
|
||||
print(f"{k:20} {v:8.1f}")
|
||||
print(f"\n## browser accuracy (n={len(BROWSERS)}): family / version / OS correct")
|
||||
@@ -342,6 +362,6 @@ if __name__ == "__main__":
|
||||
print(f"\n## crawler detection (n={len(CRAWLER_UAS)})")
|
||||
for k, v in det.items():
|
||||
print(f"{k:18} {v:5} ({v / len(CRAWLER_UAS):.1%})")
|
||||
print(f"user-agent-parser crashed on {crashes} UAs")
|
||||
print(f"fastuaparser crashed on {crashes} UAs")
|
||||
print(f"\nuarite URL extraction: {url_got}/{url_have} of instances carrying a URL")
|
||||
bench_realistic()
|
||||
|
||||
@@ -0,0 +1,68 @@
|
||||
"""Generate the JS data tables for uarite-js from the Python source.
|
||||
|
||||
Run from the repository root:
|
||||
|
||||
uv run scripts/port_tables.py
|
||||
|
||||
Writes uarite-js/src/tables.ts. That file is generated — edit the Python
|
||||
tables (uarite/bots.py, uarite/clients.py) instead and re-run this script.
|
||||
"""
|
||||
|
||||
import json
|
||||
from pathlib import Path
|
||||
|
||||
from uarite.bots import BOTS, KIND_LABEL, LABELED, PRETTY_OVERRIDE, PROVIDER_OF
|
||||
from uarite.clients import BROWSERS, SAMSUNG, SAMSUNG_SERIES
|
||||
|
||||
OUT = Path(__file__).resolve().parent.parent / "uarite-js" / "src" / "tables.ts"
|
||||
|
||||
HEADER = """\
|
||||
// Generated by scripts/port_tables.py from uarite/bots.py and
|
||||
// uarite/clients.py. Do not edit by hand; re-run the script.
|
||||
"""
|
||||
|
||||
|
||||
def js(obj: object) -> str:
|
||||
return json.dumps(obj, indent=2, ensure_ascii=False)
|
||||
|
||||
|
||||
def main() -> None:
|
||||
src = [HEADER]
|
||||
src.append(
|
||||
"/** UA token -> display name, checked in order; first hit wins. */\n"
|
||||
f"export const BROWSERS: ReadonlyArray<readonly [string, string]> = {js(list(map(list, BROWSERS)))};\n"
|
||||
)
|
||||
src.append(
|
||||
"/** Lowercase UA substring -> [display name, kind]. First match wins. */\n"
|
||||
f"export const BOTS: Readonly<Record<string, readonly [string, string]>> = {js({k: list(v) for k, v in BOTS.items()})};\n"
|
||||
)
|
||||
src.append(
|
||||
"/** Pretty suffixes for the kinds more precise than a generic spider. */\n"
|
||||
f"export const KIND_LABEL: Readonly<Record<string, string>> = {js(KIND_LABEL)};\n"
|
||||
)
|
||||
src.append(
|
||||
"/** Bot display name -> provider. */\n"
|
||||
f"export const PROVIDER_OF: Readonly<Record<string, string>> = {js(PROVIDER_OF)};\n"
|
||||
)
|
||||
src.append(
|
||||
"/** Per-bot pretty overrides: the full display string. */\n"
|
||||
f"export const PRETTY_OVERRIDE: Readonly<Record<string, string>> = {js(PRETTY_OVERRIDE)};\n"
|
||||
)
|
||||
src.append(
|
||||
"/** Bot names whose kind label is displayed. */\n"
|
||||
f"export const LABELED: ReadonlySet<string> = new Set({js(sorted(LABELED))});\n"
|
||||
)
|
||||
src.append(
|
||||
"/** Samsung model code (without region/carrier letter) -> marketing name. */\n"
|
||||
f"export const SAMSUNG: Readonly<Record<string, string>> = {js(SAMSUNG)};\n"
|
||||
)
|
||||
src.append(
|
||||
"/** Samsung series for codes missing from SAMSUNG. */\n"
|
||||
f"export const SAMSUNG_SERIES: Readonly<Record<string, string>> = {js(SAMSUNG_SERIES)};\n"
|
||||
)
|
||||
OUT.write_text("\n".join(src))
|
||||
print(f"wrote {OUT}")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
+8
-15
@@ -1,15 +1,15 @@
|
||||
"""Print the README's accuracy-comparison table as markdown.
|
||||
|
||||
uarite's column is simply `r.pretty`. The reference modules have no
|
||||
display format; their columns use one plain format string each on their
|
||||
structured output (footnotes ²³ in the README). Requires uarite (installed)
|
||||
plus the benchmark-only reference parsers:
|
||||
uarite's and fastuaparser's columns are simply their pretty-string output.
|
||||
ua-parser has no display format; its column uses one plain format string
|
||||
on the structured output (footnotes ¹² in the README). Requires uarite
|
||||
(installed) plus the benchmark-only reference parsers:
|
||||
|
||||
uv run --with ua-parser --with user-agents python scripts/prettytable.py
|
||||
uv run --with ua-parser --with fastuaparser python scripts/prettytable.py
|
||||
"""
|
||||
|
||||
from fastuaparser import parse_ua as fua_parse
|
||||
from ua_parser import parse as ua_parse
|
||||
from user_agents import parse as uas_parse
|
||||
|
||||
from uarite import uaparse
|
||||
|
||||
@@ -86,15 +86,8 @@ def imitate_uaparser(ua):
|
||||
return f"{fam}/{maj} {osf} {dev}"
|
||||
|
||||
|
||||
def imitate_useragents(ua):
|
||||
r = uas_parse(ua)
|
||||
fam = r.browser.family or ""
|
||||
maj = str(r.browser.version[0]) if r.browser.version else ""
|
||||
return f"{fam}/{maj} {r.os.family or ''} {r.device.family or ''}"
|
||||
|
||||
|
||||
print("| Case | uarite¹ | ua-parser² | user-agents³ |")
|
||||
print("| Case | uarite¹ | fastuaparser² | ua-parser³ |")
|
||||
print("|---|---|---|---|")
|
||||
for name, ua in CASES:
|
||||
ours = uaparse(ua).pretty or "—"
|
||||
print(f"| {name} | {ours} | {imitate_uaparser(ua)} | {imitate_useragents(ua)} |")
|
||||
print(f"| {name} | {ours} | {fua_parse(ua)} | {imitate_uaparser(ua)} |")
|
||||
|
||||
+16
-18
@@ -23,13 +23,14 @@ matplotlib.rcParams["svg.fonttype"] = "path" # text as paths: renders anywhere
|
||||
import matplotlib.pyplot as plt # noqa: E402
|
||||
|
||||
# µs per cold parse, from scripts/bench.py.
|
||||
# fastuaparser (~1 µs, 1M parses/s) and cached results are too far off
|
||||
# this scale to draw meaningfully and are only mentioned in the README.
|
||||
US = {
|
||||
"user-agent-parser": 8.2,
|
||||
"uarite": 17.7,
|
||||
"ua-parser (Rust)": 46.6,
|
||||
"ua-parser (RE2)": 77.1,
|
||||
"ua-parser": 321.5,
|
||||
"user-agents": 334.4,
|
||||
"uarite": 18.0,
|
||||
"ua-parser (Rust)": 38.1,
|
||||
"ua-parser (RE2)": 71.7,
|
||||
"ua-parser": 304.7,
|
||||
"user-agents": 324.6,
|
||||
}
|
||||
|
||||
#: Readable on both white and dark backgrounds.
|
||||
@@ -41,29 +42,26 @@ values = [v for _, v in data][::-1]
|
||||
colors = ["#6e6e6e"] * len(data)
|
||||
colors[names.index("uarite")] = "#2b6cb0"
|
||||
|
||||
fig, ax = plt.subplots(figsize=(12, 1.7), dpi=100)
|
||||
fig, ax = plt.subplots(figsize=(12, 1.5), dpi=100)
|
||||
bars = ax.barh(names, values, color=colors, height=0.82)
|
||||
ax.set_xlim(0, max(values))
|
||||
xmax = max(values)
|
||||
ax.set_xlim(0, xmax)
|
||||
ax.axis("off")
|
||||
|
||||
for bar, name, v in zip(bars, names, values):
|
||||
# Round to two significant digits: 121951 -> "120 000".
|
||||
rounded = round(v, 1 - int(f"{v:.0e}".split("e")[1]))
|
||||
label = f"{name} {rounded:,.0f}".replace(",", " ")
|
||||
label = f"{rounded:,.0f} {name}".replace(",", " ")
|
||||
# va="center" centers the font bbox incl. descender space, which leaves
|
||||
# the glyphs slightly high; nudge down to optically center on the bar.
|
||||
y = bar.get_y() + bar.get_height() / 2 - 0.09
|
||||
if bar.get_width() > max(values) * 0.28:
|
||||
# Long bar: white text inside, right-aligned at the bar end.
|
||||
ax.text(bar.get_width() - max(values) * 0.012, y, label,
|
||||
va="center", ha="right", color="white", fontsize=11)
|
||||
else:
|
||||
# Short bar: theme-neutral gray text just past the bar end.
|
||||
ax.text(bar.get_width() + max(values) * 0.012, y, label,
|
||||
# All labels after the bar: theme-neutral gray, number before name.
|
||||
# The longest bar's label overflows the axes; bbox_inches="tight"
|
||||
# below expands the canvas to include it, so no dead space remains.
|
||||
ax.text(bar.get_width() + xmax * 0.012, y, label,
|
||||
va="center", color=OUTSIDE, fontsize=11)
|
||||
|
||||
fig.tight_layout(pad=0.2)
|
||||
out = Path("docs/bench-speed.svg")
|
||||
out.parent.mkdir(exist_ok=True)
|
||||
fig.savefig(out, transparent=True)
|
||||
fig.savefig(out, transparent=True, bbox_inches="tight", pad_inches=0.02)
|
||||
print("wrote", out)
|
||||
|
||||
@@ -0,0 +1,3 @@
|
||||
{
|
||||
"semi": false
|
||||
}
|
||||
@@ -0,0 +1,89 @@
|
||||
# User-Agent Parsing Done Right
|
||||
|
||||
Fast and accurate handling of modern browsers and crawlers. Despite its light weight and no dependencies, uarite identifies both browsers and crawlers more accurately than any competing implementation tested here. We also provide a [Python uarite](https://pypi.org/project/uarite/) with exact same output.
|
||||
|
||||
It returns structured classification, but also the thing most applications eventually need: **a short pretty description**.
|
||||
|
||||
## Usage
|
||||
|
||||
Add it to your project:
|
||||
|
||||
```sh
|
||||
npm install @vasanko/uarite
|
||||
```
|
||||
|
||||
```js
|
||||
import { uaparse } from "@vasanko/uarite"
|
||||
|
||||
const { pretty, engine, os, kind } = uaparse(
|
||||
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/152.0.0.0 Safari/537.36",
|
||||
)
|
||||
// Chrome/152 Windows, Chromium, Windows, browser
|
||||
|
||||
const { pretty, kind, url, provider } = uaparse(
|
||||
"Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko); compatible; GPTBot/1.2; +https://openai.com/gptbot",
|
||||
)
|
||||
// GPTBot (AI), ai, https://openai.com/gptbot, OpenAI
|
||||
```
|
||||
|
||||
Plain HTML? A prebuilt minified ESM bundle you can host yourself or link from CDN:
|
||||
|
||||
```html
|
||||
<script type="module">
|
||||
import { uaparse } from "https://cdn.jsdelivr.net/npm/@vasanko/uarite/dist/uarite.min.js"
|
||||
console.log(uaparse(navigator.userAgent))
|
||||
</script>
|
||||
```
|
||||
|
||||
## Output
|
||||
|
||||
`uaparse(ua)` returns a `UA` object with string fields. Any field may be empty string when the information is unavailable.
|
||||
|
||||
| Field | Content |
|
||||
| -------- | ------------------------------------------------ |
|
||||
| pretty | Compact display string; raw UA when unrecognized |
|
||||
| engine | Chromium, Gecko, Safari, ArkWeb |
|
||||
| os | Windows, macOS, Linux, iOS, Android, HarmonyOS |
|
||||
| kind | browser, ai, search, social, analytics, spider |
|
||||
| url | Crawler information URL |
|
||||
| provider | Provider of a known crawler family |
|
||||
|
||||
The pretty field is intended for UIs and logs. The url can be attached to it as a link when available.
|
||||
|
||||
The engine and os fields are intentionally broad. The kind field distinguishes browsers from AI collectors, search engines, social previews, monitoring tools, generic spiders, and ordinary HTTP clients. Any non-browser kind represents automated traffic.
|
||||
|
||||
Detection is necessarily limited by what the User-Agent reveals. Crawlers can masquerade as ordinary browsers or other crawlers, so sites that need stronger identification should use additional methods rather than relying on UA detection alone.
|
||||
|
||||
## Comparison
|
||||
|
||||
The popular npm options for this task are bowser and ua-parser-js. The table below compares representative User-Agent formats.
|
||||
|
||||
| Case | uarite¹ | ua-parser-js² | bowser³ |
|
||||
| ---------------------------- | ------------------------- | ------------------------------------ | ------------------------------------ |
|
||||
| Chrome, Windows | Chrome/152 Windows | Chrome/152 Windows | Chrome/152.0.0.0 Windows |
|
||||
| Chrome, Android (no model) | Chrome/152 Android | Mobile Chrome/152 Android K❌ | Chrome/152.0.0.0 Android |
|
||||
| Edge, Android (model code) | Edge/110 Galaxy S7 | Edge/110 Android SM-G930P | Microsoft Edge/110.0.1587.66 Android |
|
||||
| Safari, iPhone | iPhone iOS 17 | Mobile Safari/17 iOS iPhone | Safari/17.0 iOS iPhone |
|
||||
| Huawei HarmonyOS phone | HuaweiBrowser/6 HarmonyOS | Huawei Browser/6 HarmonyOS ALN-AL00 | Android Browser/ Android ❌ |
|
||||
| GPTBot | GPTBot (AI) | WebKit/537 ❌ | GPTBot/1.2 |
|
||||
| Googlebot (disguised) | Googlebot (search) | Mobile Chrome/122 Android Nexus 5 ❌ | Googlebot/2.1 Android❌ |
|
||||
| Facebook preview (disguised) | Facebook | Mobile Chrome/134 Android Pixel 7 ❌ | FacebookExternalHit/ Android❌ |
|
||||
| WhatsApp preview | WhatsApp | (nothing) ❌ | WhatsApp/2.23.20.0 |
|
||||
| python-requests | python-requests/2.32.5 | (nothing) ❌ | (nothing) ❌ |
|
||||
|
||||
- ❌ marks incorrect data such as an OS from a crawler's disguise, a frozen compat placeholder reported as a device, or a missed identity
|
||||
- ¹ `uaparse(ua).pretty` shown as is
|
||||
- ² `{browser.name??''}/{browser.major??''} {os.name??''} {device.model??''}`; free MIT tier of v2
|
||||
- ³ `{browser.name??''}/{browser.version??''} {os.name??''} {platform.model??''}`
|
||||
|
||||
Parsing a mixed set of 316 real-world browser and crawler UAs, parses per second: **uarite 580 000**, bowser 130 000 and ua-parser-js 18 000. The other parsers don't appear to implement caching. For previously seen UA strings, however, uarite reaches **5.6 million**, while all others remain at the rates quoted above.
|
||||
|
||||
All are relatively small: **uarite minifies to 9 kB**, bowser to 37 kB and ua-parser-js to 28 kB.
|
||||
|
||||
## Why yet another UA parser
|
||||
|
||||
Rather than relying on a large historical regex database, the parser focuses on modern UA formats and parses them directly, choosing the most specific interpretation available. This keeps the implementation small while handling today's browsers and crawler traffic well. Until now, I had been using those other modules and building my own pretty-UA formatting on top of them, fixing by post processing issues the upstream didn't care of.
|
||||
|
||||
Eventually it became easier to start over with a parser designed around modern traffic. The result is uarite.
|
||||
|
||||
Hopefully it helps you too. Star my [GitHub](https://github.com/leovasanko/uarite) if it did.
|
||||
Vendored
+1
File diff suppressed because one or more lines are too long
@@ -0,0 +1,43 @@
|
||||
{
|
||||
"name": "@vasanko/uarite",
|
||||
"version": "0.2.2",
|
||||
"description": "User-Agent parsing done right. Accurate, small, dependency-free and fast.",
|
||||
"keywords": [
|
||||
"user-agent",
|
||||
"ua-parser"
|
||||
],
|
||||
"homepage": "https://git.zi.fi/LeoVasanko/uarite",
|
||||
"repository": "https://git.zi.fi/LeoVasanko/uarite",
|
||||
"bugs": "https://github.com/LeoVasanko/uarite",
|
||||
"license": "MIT OR Unlicense",
|
||||
"publishConfig": {
|
||||
"access": "public"
|
||||
},
|
||||
"type": "module",
|
||||
"exports": {
|
||||
".": {
|
||||
"types": "./dist/index.d.ts",
|
||||
"default": "./dist/index.js"
|
||||
}
|
||||
},
|
||||
"files": [
|
||||
"dist"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
},
|
||||
"scripts": {
|
||||
"build": "tsc && npm run build:min",
|
||||
"build:min": "esbuild src/index.ts --bundle --minify --format=esm --target=es2022 --outfile=dist/uarite.min.js",
|
||||
"format": "prettier --write src test",
|
||||
"format:check": "prettier --check src test",
|
||||
"gen:tables": "cd .. && uv run scripts/port_tables.py && cd uarite-js && prettier --write src/tables.ts",
|
||||
"test": "npm run build && node --test test/*.test.js",
|
||||
"prepublishOnly": "npm run build && npm test"
|
||||
},
|
||||
"devDependencies": {
|
||||
"esbuild": "^0.28.2",
|
||||
"prettier": "^3.9.6",
|
||||
"typescript": "^5.6.0"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,311 @@
|
||||
import {
|
||||
BOTS,
|
||||
BROWSERS,
|
||||
KIND_LABEL,
|
||||
LABELED,
|
||||
PRETTY_OVERRIDE,
|
||||
PROVIDER_OF,
|
||||
SAMSUNG,
|
||||
SAMSUNG_SERIES,
|
||||
} from "./tables.js"
|
||||
|
||||
/** Result of parsing a User-Agent string. Any field may be empty. */
|
||||
export interface UA {
|
||||
/** Compact display string; raw UA when unrecognized. */
|
||||
pretty: string
|
||||
/** Chromium, Gecko, Safari, ArkWeb. */
|
||||
engine: string
|
||||
/** Windows, macOS, Linux, iOS, Android, HarmonyOS. */
|
||||
os: string
|
||||
/** browser, ai, search, social, analytics, spider. */
|
||||
kind: string
|
||||
/** Crawler information URL. */
|
||||
url: string
|
||||
/** Provider of a known crawler family. */
|
||||
provider: string
|
||||
}
|
||||
|
||||
const EMPTY: UA = {
|
||||
pretty: "",
|
||||
engine: "",
|
||||
os: "",
|
||||
kind: "",
|
||||
url: "",
|
||||
provider: "",
|
||||
}
|
||||
|
||||
/** Fallback for unknown crawlers: a product token whose name says so. */
|
||||
const BOT_TOKEN = /[^\s();/]*(?:bot|spider|crawl|scan|verif|check)[^\s();/]*/i
|
||||
|
||||
/** A "+https://…" pointer is a crawler tell; real browsers carry no URL. */
|
||||
const URL = /\+\s*(https?:\/\/[^\s;)]+)/
|
||||
const ANY_URL = /(https?:\/\/[^\s;)]+)/
|
||||
|
||||
/** Crawler name next to the info URL: "compatible; Page2RSS/0.7; +http://…". */
|
||||
const COMPATIBLE_NAME = /compatible;\s*([^;/()]+?)(?:\/[\d.vx]+)?\s*;/
|
||||
|
||||
/** Name from an info URL's host when no product token is available. */
|
||||
const HOST = /https?:\/\/(?:www\.)?([^/\s;)]+)/
|
||||
|
||||
/** Android model token: "Android 15; SM-S918B)", "Android 12; Pixel 6; Build/…". */
|
||||
const ANDROID_MODEL = /Android [\d.]+; ([^;()]+?)(?:;|\)| Build\/)/
|
||||
|
||||
/** All known-bot substrings in one compiled pass. */
|
||||
const BOTS_RE = new RegExp(
|
||||
Object.keys(BOTS)
|
||||
.map((s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"))
|
||||
.join("|"),
|
||||
)
|
||||
|
||||
/** The crawler's info URL from the UA, or "" (mailto: is not a URL). */
|
||||
export function url(ua: string): string {
|
||||
const m = URL.exec(ua) ?? ANY_URL.exec(ua)
|
||||
return m ? m[1] : ""
|
||||
}
|
||||
|
||||
/** (display name, kind) of the crawler/unfurler the UA claims. */
|
||||
export function bot(ua: string): readonly [string, string] {
|
||||
const low = ua.toLowerCase()
|
||||
const m = BOTS_RE.exec(low)
|
||||
if (m) return BOTS[m[0]]
|
||||
// Cheap keyword gates keep the regexes off the hot path.
|
||||
if (/(?:bot|spider|crawl|scan|verif|check)/.test(low)) {
|
||||
const t = BOT_TOKEN.exec(ua)
|
||||
if (t) {
|
||||
const name = t[0].replace(/^;+|;+$/g, "")
|
||||
return [name[0].toUpperCase() + name.slice(1), "spider"]
|
||||
}
|
||||
}
|
||||
// An info URL in the UA is a crawler convention. Name it from the
|
||||
// "compatible; Name/x" token, else the first product token, else the
|
||||
// URL's host.
|
||||
if (ua.includes("://")) {
|
||||
let name = ""
|
||||
const cm = COMPATIBLE_NAME.exec(ua)
|
||||
if (cm) {
|
||||
name = cm[1].trim()
|
||||
} else if (!ua.startsWith("Mozilla")) {
|
||||
name = ua.split(" ")[0].split("/")[0]
|
||||
}
|
||||
const nl = name.toLowerCase()
|
||||
if (!name || nl.startsWith("mozilla") || nl.startsWith("msie")) {
|
||||
const hm = HOST.exec(ua)
|
||||
name = hm ? hm[1] : ""
|
||||
}
|
||||
if (name) return [name[0].toUpperCase() + name.slice(1), "spider"]
|
||||
}
|
||||
return ["", ""]
|
||||
}
|
||||
|
||||
/** Major version of a `token/x.y` product in the UA, or "". */
|
||||
export function version(ua: string, token: string): string {
|
||||
const m = new RegExp(
|
||||
`${token.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}/(\\d+)`,
|
||||
).exec(ua)
|
||||
return m ? m[1] : ""
|
||||
}
|
||||
|
||||
/** `Browser/major` for the browsers we care to distinguish. */
|
||||
export function browser(ua: string): string {
|
||||
for (const [token, name] of BROWSERS) {
|
||||
const ver = version(ua, token)
|
||||
if (ver) return `${name}/${ver}`
|
||||
}
|
||||
if (ua.includes("Safari/")) {
|
||||
const ver = version(ua, "Version")
|
||||
return ver ? `Safari/${ver}` : "Safari"
|
||||
}
|
||||
return ""
|
||||
}
|
||||
|
||||
/** Engines that differ from the Chromium default for recognized browsers. */
|
||||
const ENGINES: Readonly<Record<string, string>> = {
|
||||
Firefox: "Gecko",
|
||||
LibreWolf: "Gecko",
|
||||
Safari: "Safari",
|
||||
}
|
||||
|
||||
/** Oldest plausible major versions (≈2023 releases); see the Python source. */
|
||||
const ANCIENT: Readonly<Record<string, number>> = {
|
||||
Firefox: 108,
|
||||
Chrome: 108,
|
||||
Edge: 108,
|
||||
Opera: 95,
|
||||
}
|
||||
|
||||
/** True when a `Browser/major` claims an impossibly old version. */
|
||||
export function spoofed(b: string): boolean {
|
||||
const i = b.indexOf("/")
|
||||
const name = i < 0 ? b : b.slice(0, i)
|
||||
const ver = i < 0 ? "" : b.slice(i + 1)
|
||||
const floor = ANCIENT[name]
|
||||
return floor !== undefined && /^\d+$/.test(ver) && Number(ver) < floor
|
||||
}
|
||||
|
||||
/** Engine for a `Browser/major` result; Chromium is the modern default. */
|
||||
export function engine(b: string): string {
|
||||
const name = b.split("/")[0]
|
||||
return ENGINES[name] ?? (name ? "Chromium" : "")
|
||||
}
|
||||
|
||||
/** Desktop OS name, or "" when not recognizable. */
|
||||
export function os(ua: string): string {
|
||||
if (ua.includes("Windows NT")) return "Windows"
|
||||
if (ua.includes("Mac OS X")) return "macOS"
|
||||
if (ua.includes("Linux") || ua.includes("X11")) return "Linux"
|
||||
if (ua.includes("Windows")) return "Windows"
|
||||
if (ua.includes("Darwin")) return "macOS"
|
||||
return ""
|
||||
}
|
||||
|
||||
/**
|
||||
* Human-readable phone name for an Android model code.
|
||||
*
|
||||
* Returns the input unchanged when nothing is known about it (Pixel and
|
||||
* most other brands already send readable names).
|
||||
*/
|
||||
export function modelName(model: string): string {
|
||||
if (model.startsWith("SM-")) {
|
||||
// Strip the region/carrier suffix: SM-S918B -> SM-S918, and the
|
||||
// Chinese/HK variant's trailing zero: SM-S9370 -> SM-S937.
|
||||
let code = model.replace(/[A-Z]{1,2}$/, "")
|
||||
if (!(code in SAMSUNG) && code.endsWith("0")) code = code.slice(0, -1)
|
||||
if (code in SAMSUNG) return SAMSUNG[code]
|
||||
const series = SAMSUNG_SERIES[code.slice(0, 4)]
|
||||
if (series) return series
|
||||
}
|
||||
return model
|
||||
}
|
||||
|
||||
const CACHE_MAX = 1024
|
||||
const cache = new Map<string, UA>()
|
||||
|
||||
/** Parse a User-Agent string into a compact {@link UA} record. */
|
||||
export function uaparse(ua: string | null | undefined): UA {
|
||||
if (!ua || !ua.trim() || ua === "-" || ua === "null") return EMPTY
|
||||
const hit = cache.get(ua)
|
||||
if (hit) {
|
||||
// Refresh recency, mirroring Python's lru_cache.
|
||||
cache.delete(ua)
|
||||
cache.set(ua, hit)
|
||||
return hit
|
||||
}
|
||||
const r = parse(ua)
|
||||
if (cache.size >= CACHE_MAX) {
|
||||
cache.delete(cache.keys().next().value as string)
|
||||
}
|
||||
cache.set(ua, r)
|
||||
return r
|
||||
}
|
||||
|
||||
function parse(ua: string): UA {
|
||||
const [name, kind] = bot(ua)
|
||||
if (name) {
|
||||
// The browser/OS in crawler UAs is a disguise; the bot identity is
|
||||
// the relevant information, so `engine` and `os` are left empty.
|
||||
let pretty = PRETTY_OVERRIDE[name]
|
||||
if (pretty === undefined) {
|
||||
const label = LABELED.has(name) ? (KIND_LABEL[kind] ?? "") : ""
|
||||
pretty = label ? `${name} (${label})` : name
|
||||
}
|
||||
return {
|
||||
...EMPTY,
|
||||
pretty,
|
||||
kind,
|
||||
url: url(ua),
|
||||
provider: PROVIDER_OF[name] ?? "",
|
||||
}
|
||||
}
|
||||
return parseClient(ua)
|
||||
}
|
||||
|
||||
function parseClient(ua: string): UA {
|
||||
const r = client(ua)
|
||||
// Frozen ancient browser strings are scanners/scripts, not users: show
|
||||
// the claimed browser, but mark it and drop the fake engine/os/kind.
|
||||
if (r.kind === "browser" && spoofed(browser(ua))) {
|
||||
return { ...EMPTY, pretty: `${r.pretty} (spoofed)` }
|
||||
}
|
||||
return r
|
||||
}
|
||||
|
||||
function client(ua: string): UA {
|
||||
// Non-browser HTTP clients ("python-requests/2.32.5", "curl/8.0",
|
||||
// "pip/24.3.1 {json…}"): the first product token, plus the OS when
|
||||
// their payload mentions one in free text.
|
||||
if (!ua.startsWith("Mozilla")) {
|
||||
const token = ua.split(" ")[0]
|
||||
let pretty = token.includes("/") ? token : ua
|
||||
const osName = os(ua)
|
||||
if (osName && !pretty.includes(osName)) pretty = `${pretty} ${osName}`
|
||||
return { ...EMPTY, pretty, os: osName }
|
||||
}
|
||||
|
||||
// HarmonyOS carries an "Android" compatibility token, so it must be
|
||||
// detected before Android.
|
||||
if (
|
||||
ua.includes("OpenHarmony") ||
|
||||
ua.includes("HarmonyOS") ||
|
||||
ua.includes("ArkWeb")
|
||||
) {
|
||||
const b = browser(ua)
|
||||
return {
|
||||
...EMPTY,
|
||||
pretty: b ? `${b} HarmonyOS` : "HarmonyOS",
|
||||
engine: "ArkWeb",
|
||||
os: "HarmonyOS",
|
||||
kind: "browser",
|
||||
}
|
||||
}
|
||||
|
||||
if (ua.includes("iPhone") || ua.includes("iPad")) {
|
||||
const device = ua.includes("iPhone") ? "iPhone" : "iPad"
|
||||
const m = /OS (\d+)/.exec(ua)
|
||||
return {
|
||||
...EMPTY,
|
||||
pretty: m ? `${device} iOS ${m[1]}` : device,
|
||||
engine: "Safari",
|
||||
os: "iOS",
|
||||
kind: "browser",
|
||||
}
|
||||
}
|
||||
|
||||
const am = /Android ([\d.]+)/.exec(ua)
|
||||
if (am) {
|
||||
const b = browser(ua)
|
||||
const mm = ANDROID_MODEL.exec(ua)
|
||||
const token = mm ? mm[1].trim() : ""
|
||||
let parts: string[]
|
||||
if (token === "K") {
|
||||
// Chrome's reduced UA freezes both: "Android 10; K". Neither
|
||||
// is real — report just the OS.
|
||||
parts = [b, "Android"].filter(Boolean)
|
||||
} else {
|
||||
// Firefox sends the form factor ("Mobile"/"Tablet") in the model
|
||||
// slot. A known model replaces the OS.
|
||||
let model = ""
|
||||
if (token && !["wv", "Mobile", "Tablet"].includes(token)) {
|
||||
model = modelName(token)
|
||||
}
|
||||
parts = [b, model || `Android ${am[1]}`].filter(Boolean)
|
||||
}
|
||||
return {
|
||||
...EMPTY,
|
||||
pretty: parts.join(" "),
|
||||
engine: engine(b),
|
||||
os: "Android",
|
||||
kind: "browser",
|
||||
}
|
||||
}
|
||||
|
||||
const b = browser(ua)
|
||||
const osName = os(ua)
|
||||
const pretty = `${b} ${osName}`.trim()
|
||||
return {
|
||||
...EMPTY,
|
||||
pretty: pretty || ua,
|
||||
engine: engine(b),
|
||||
os: osName,
|
||||
kind: "browser",
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,231 @@
|
||||
// Generated by scripts/port_tables.py from uarite/bots.py and
|
||||
// uarite/clients.py. Do not edit by hand; re-run the script.
|
||||
|
||||
/** UA token -> display name, checked in order; first hit wins. */
|
||||
export const BROWSERS: ReadonlyArray<readonly [string, string]> = [
|
||||
["HuaweiBrowser", "HuaweiBrowser"],
|
||||
["EdgA", "Edge"],
|
||||
["Edg", "Edge"],
|
||||
["OPR", "Opera"],
|
||||
["Vivaldi", "Vivaldi"],
|
||||
["YaBrowser", "Yandex"],
|
||||
["Brave", "Brave"],
|
||||
["Whale", "Whale"],
|
||||
["SamsungBrowser", "Samsung Internet"],
|
||||
["MiuiBrowser", "Mi Browser"],
|
||||
["UCBrowser", "UC Browser"],
|
||||
["QQBrowser", "QQ Browser"],
|
||||
["DuckDuckGo", "DuckDuckGo"],
|
||||
["LibreWolf", "LibreWolf"],
|
||||
["Firefox", "Firefox"],
|
||||
["Chrome", "Chrome"],
|
||||
["CriOS", "Chrome"],
|
||||
["FxiOS", "Firefox"],
|
||||
]
|
||||
|
||||
/** Lowercase UA substring -> [display name, kind]. First match wins. */
|
||||
export const BOTS: Readonly<Record<string, readonly [string, string]>> = {
|
||||
"mozilla/5.0 (x11; linux x86_64; rv:45.0) gecko/20100101 firefox/45.0": [
|
||||
"Qualys SSL Labs",
|
||||
"spider",
|
||||
],
|
||||
"feedfetcher-google": ["Feedfetcher-Google", "search"],
|
||||
"google-inspectiontool": ["Google-InspectionTool", "search"],
|
||||
"google-read-aloud": ["Google-Read-Aloud", "ai"],
|
||||
"mediapartners-google": ["Mediapartners-Google", "analytics"],
|
||||
"adsbot-google": ["AdsBot-Google", "analytics"],
|
||||
"apis-google": ["APIs-Google", "spider"],
|
||||
"storebot-google": ["Storebot-Google", "search"],
|
||||
"google-extended": ["Google-Extended", "ai"],
|
||||
googlebot: ["Googlebot", "search"],
|
||||
googleother: ["GoogleOther", "ai"],
|
||||
bingbot: ["Bingbot", "search"],
|
||||
applebot: ["Applebot", "search"],
|
||||
gptbot: ["GPTBot", "ai"],
|
||||
"oai-searchbot": ["OAI-SearchBot", "search"],
|
||||
"chatgpt-user": ["ChatGPT-User", "ai"],
|
||||
"claude-searchbot": ["Claude-SearchBot", "search"],
|
||||
claudebot: ["ClaudeBot", "ai"],
|
||||
"claude-user": ["Claude-User", "ai"],
|
||||
"perplexity-user": ["Perplexity-User", "ai"],
|
||||
perplexitybot: ["PerplexityBot", "search"],
|
||||
grokbot: ["GrokBot", "ai"],
|
||||
bytespider: ["Bytespider", "ai"],
|
||||
reflectionbot: ["Reflectionbot", "ai"],
|
||||
"amzn-searchbot": ["Amzn-SearchBot", "search"],
|
||||
amazonbot: ["Amazonbot", "search"],
|
||||
ahrefsbot: ["AhrefsBot", "search"],
|
||||
mj12bot: ["MJ12bot", "analytics"],
|
||||
facebookexternalhit: ["Facebook", "social"],
|
||||
"meta-externalagent": ["Meta-ExternalAgent", "ai"],
|
||||
"meta-externalfetcher": ["Meta-ExternalFetcher", "ai"],
|
||||
"meta-webindexer": ["Meta-WebIndexer", "search"],
|
||||
bingpreview: ["BingPreview", "search"],
|
||||
pinterest: ["Pinterest", "social"],
|
||||
embedly: ["Embedly", "social"],
|
||||
iframely: ["Iframely", "social"],
|
||||
discordbot: ["Discord", "social"],
|
||||
slackbot: ["Slack", "social"],
|
||||
telegrambot: ["Telegram", "social"],
|
||||
twitterbot: ["Twitter", "social"],
|
||||
linkedinbot: ["LinkedIn", "social"],
|
||||
whatsapp: ["WhatsApp", "social"],
|
||||
headlesschrome: ["HeadlessChrome", "spider"],
|
||||
uptimerobot: ["UptimeRobot", "analytics"],
|
||||
pingdom: ["Pingdom", "analytics"],
|
||||
}
|
||||
|
||||
/** Pretty suffixes for the kinds more precise than a generic spider. */
|
||||
export const KIND_LABEL: Readonly<Record<string, string>> = {
|
||||
ai: "AI",
|
||||
search: "search",
|
||||
social: "social",
|
||||
analytics: "analytics",
|
||||
}
|
||||
|
||||
/** Bot display name -> provider. */
|
||||
export const PROVIDER_OF: Readonly<Record<string, string>> = {
|
||||
GoogleOther: "Google",
|
||||
"Mediapartners-Google": "Google",
|
||||
Googlebot: "Google",
|
||||
"Storebot-Google": "Google",
|
||||
"APIs-Google": "Google",
|
||||
"Google-Extended": "Google",
|
||||
"Google-Read-Aloud": "Google",
|
||||
"Feedfetcher-Google": "Google",
|
||||
"AdsBot-Google": "Google",
|
||||
"Google-InspectionTool": "Google",
|
||||
"Claude-User": "Anthropic",
|
||||
"Claude-SearchBot": "Anthropic",
|
||||
ClaudeBot: "Anthropic",
|
||||
GPTBot: "OpenAI",
|
||||
"ChatGPT-User": "OpenAI",
|
||||
"OAI-SearchBot": "OpenAI",
|
||||
"Perplexity-User": "Perplexity",
|
||||
PerplexityBot: "Perplexity",
|
||||
Amazonbot: "Amazon",
|
||||
"Amzn-SearchBot": "Amazon",
|
||||
Bingbot: "Microsoft",
|
||||
BingPreview: "Microsoft",
|
||||
"Meta-ExternalFetcher": "Meta",
|
||||
"Meta-WebIndexer": "Meta",
|
||||
Facebook: "Meta",
|
||||
"Meta-ExternalAgent": "Meta",
|
||||
}
|
||||
|
||||
/** Per-bot pretty overrides: the full display string. */
|
||||
export const PRETTY_OVERRIDE: Readonly<Record<string, string>> = {
|
||||
Facebook: "Facebook",
|
||||
"Feedfetcher-Google": "Google Feedfetcher (search)",
|
||||
"Google-InspectionTool": "Google InspectionTool (search)",
|
||||
"Google-Read-Aloud": "Google Read-Aloud (AI)",
|
||||
"Mediapartners-Google": "Google Mediapartners (analytics)",
|
||||
"AdsBot-Google": "Google AdsBot (analytics)",
|
||||
"APIs-Google": "Google APIs",
|
||||
"Storebot-Google": "Google Storebot (search)",
|
||||
"Google-Extended": "Google Extended (AI)",
|
||||
GoogleOther: "Google Other (AI)",
|
||||
}
|
||||
|
||||
/** Bot names whose kind label is displayed. */
|
||||
export const LABELED: ReadonlySet<string> = new Set([
|
||||
"APIs-Google",
|
||||
"AdsBot-Google",
|
||||
"ChatGPT-User",
|
||||
"Claude-SearchBot",
|
||||
"Claude-User",
|
||||
"ClaudeBot",
|
||||
"Facebook",
|
||||
"Feedfetcher-Google",
|
||||
"GPTBot",
|
||||
"Google-Extended",
|
||||
"Google-InspectionTool",
|
||||
"Google-Read-Aloud",
|
||||
"GoogleOther",
|
||||
"Googlebot",
|
||||
"Mediapartners-Google",
|
||||
"Meta-ExternalAgent",
|
||||
"Meta-ExternalFetcher",
|
||||
"Meta-WebIndexer",
|
||||
"OAI-SearchBot",
|
||||
"Perplexity-User",
|
||||
"PerplexityBot",
|
||||
"Storebot-Google",
|
||||
])
|
||||
|
||||
/** Samsung model code (without region/carrier letter) -> marketing name. */
|
||||
export const SAMSUNG: Readonly<Record<string, string>> = {
|
||||
"SM-G930": "Galaxy S7",
|
||||
"SM-G935": "Galaxy S7 Edge",
|
||||
"SM-G950": "Galaxy S8",
|
||||
"SM-G955": "Galaxy S8+",
|
||||
"SM-G960": "Galaxy S9",
|
||||
"SM-G965": "Galaxy S9+",
|
||||
"SM-G970": "Galaxy S10e",
|
||||
"SM-G973": "Galaxy S10",
|
||||
"SM-G975": "Galaxy S10+",
|
||||
"SM-G977": "Galaxy S10 5G",
|
||||
"SM-G980": "Galaxy S20",
|
||||
"SM-G981": "Galaxy S20",
|
||||
"SM-G985": "Galaxy S20+",
|
||||
"SM-G986": "Galaxy S20+",
|
||||
"SM-G988": "Galaxy S20 Ultra",
|
||||
"SM-G990": "Galaxy S21 FE",
|
||||
"SM-G991": "Galaxy S21",
|
||||
"SM-G996": "Galaxy S21+",
|
||||
"SM-G998": "Galaxy S21 Ultra",
|
||||
"SM-S901": "Galaxy S22",
|
||||
"SM-S906": "Galaxy S22+",
|
||||
"SM-S908": "Galaxy S22 Ultra",
|
||||
"SM-S911": "Galaxy S23",
|
||||
"SM-S916": "Galaxy S23+",
|
||||
"SM-S918": "Galaxy S23 Ultra",
|
||||
"SM-S921": "Galaxy S24",
|
||||
"SM-S926": "Galaxy S24+",
|
||||
"SM-S928": "Galaxy S24 Ultra",
|
||||
"SM-S931": "Galaxy S25",
|
||||
"SM-S936": "Galaxy S25+",
|
||||
"SM-S937": "Galaxy S25 Edge",
|
||||
"SM-S938": "Galaxy S25 Ultra",
|
||||
"SM-S942": "Galaxy S26",
|
||||
"SM-S946": "Galaxy S26+",
|
||||
"SM-S948": "Galaxy S26 Ultra",
|
||||
"SM-N930": "Galaxy Note 7",
|
||||
"SM-N950": "Galaxy Note 8",
|
||||
"SM-N960": "Galaxy Note 9",
|
||||
"SM-N970": "Galaxy Note 10",
|
||||
"SM-N975": "Galaxy Note 10+",
|
||||
"SM-N980": "Galaxy Note 20",
|
||||
"SM-N981": "Galaxy Note 20",
|
||||
"SM-N985": "Galaxy Note 20 Ultra",
|
||||
"SM-N986": "Galaxy Note 20 Ultra",
|
||||
"SM-F700": "Galaxy Z Flip",
|
||||
"SM-F707": "Galaxy Z Flip 5G",
|
||||
"SM-F711": "Galaxy Z Flip3",
|
||||
"SM-F721": "Galaxy Z Flip4",
|
||||
"SM-F731": "Galaxy Z Flip5",
|
||||
"SM-F741": "Galaxy Z Flip6",
|
||||
"SM-F766": "Galaxy Z Flip7",
|
||||
"SM-F900": "Galaxy Fold",
|
||||
"SM-F907": "Galaxy Fold 5G",
|
||||
"SM-F916": "Galaxy Z Fold2",
|
||||
"SM-F926": "Galaxy Z Fold3",
|
||||
"SM-F936": "Galaxy Z Fold4",
|
||||
"SM-F946": "Galaxy Z Fold5",
|
||||
"SM-F956": "Galaxy Z Fold6",
|
||||
"SM-F966": "Galaxy Z Fold7",
|
||||
}
|
||||
|
||||
/** Samsung series for codes missing from SAMSUNG. */
|
||||
export const SAMSUNG_SERIES: Readonly<Record<string, string>> = {
|
||||
"SM-S": "Galaxy S",
|
||||
"SM-G": "Galaxy S",
|
||||
"SM-N": "Galaxy Note",
|
||||
"SM-A": "Galaxy A",
|
||||
"SM-J": "Galaxy J",
|
||||
"SM-M": "Galaxy M",
|
||||
"SM-E": "Galaxy E",
|
||||
"SM-F": "Galaxy Z",
|
||||
"SM-T": "Galaxy Tab",
|
||||
"SM-X": "Galaxy Tab",
|
||||
}
|
||||
@@ -0,0 +1,145 @@
|
||||
import assert from "node:assert/strict"
|
||||
import { test } from "node:test"
|
||||
import { uaparse } from "../dist/index.js"
|
||||
|
||||
test("empty and missing UAs", () => {
|
||||
for (const ua of ["", " ", "-", "null", null, undefined]) {
|
||||
assert.deepEqual(uaparse(ua), {
|
||||
pretty: "",
|
||||
engine: "",
|
||||
os: "",
|
||||
kind: "",
|
||||
url: "",
|
||||
provider: "",
|
||||
})
|
||||
}
|
||||
})
|
||||
|
||||
test("Chrome on Windows", () => {
|
||||
const r = uaparse(
|
||||
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/152.0.0.0 Safari/537.36",
|
||||
)
|
||||
assert.equal(r.pretty, "Chrome/152 Windows")
|
||||
assert.equal(r.engine, "Chromium")
|
||||
assert.equal(r.os, "Windows")
|
||||
assert.equal(r.kind, "browser")
|
||||
assert.equal(r.url, "")
|
||||
})
|
||||
|
||||
test("Safari on macOS", () => {
|
||||
const r = uaparse(
|
||||
"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15",
|
||||
)
|
||||
assert.equal(r.pretty, "Safari/18 macOS")
|
||||
assert.equal(r.engine, "Safari")
|
||||
})
|
||||
|
||||
test("Firefox on Android keeps the OS version", () => {
|
||||
const r = uaparse(
|
||||
"Mozilla/5.0 (Android 15; Mobile; rv:154.0) Gecko/154.0 Firefox/154.0",
|
||||
)
|
||||
assert.equal(r.pretty, "Firefox/154 Android 15")
|
||||
assert.equal(r.engine, "Gecko")
|
||||
assert.equal(r.os, "Android")
|
||||
})
|
||||
|
||||
test("Chrome on Android with a Pixel model", () => {
|
||||
const r = uaparse(
|
||||
"Mozilla/5.0 (Linux; Android 12; Pixel 6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Mobile Safari/537.36",
|
||||
)
|
||||
assert.equal(r.pretty, "Chrome/118 Pixel 6")
|
||||
assert.equal(r.os, "Android")
|
||||
})
|
||||
|
||||
test("Samsung model codes resolve to marketing names", () => {
|
||||
const r = uaparse(
|
||||
"Mozilla/5.0 (Linux; Android 13; SM-S918B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Mobile Safari/537.36",
|
||||
)
|
||||
assert.equal(r.pretty, "Chrome/118 Galaxy S23 Ultra")
|
||||
})
|
||||
|
||||
test("Chrome reduced UA (Android 10; K)", () => {
|
||||
const r = uaparse(
|
||||
"Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/152.0.0.0 Mobile Safari/537.36",
|
||||
)
|
||||
assert.equal(r.pretty, "Chrome/152 Android")
|
||||
})
|
||||
|
||||
test("iPhone", () => {
|
||||
const r = uaparse(
|
||||
"Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1",
|
||||
)
|
||||
assert.equal(r.pretty, "iPhone iOS 17")
|
||||
assert.equal(r.engine, "Safari")
|
||||
assert.equal(r.os, "iOS")
|
||||
})
|
||||
|
||||
test("HarmonyOS before Android", () => {
|
||||
const r = uaparse(
|
||||
"Mozilla/5.0 (Linux; Android 12; HarmonyOS; ALN-AL00; HMSCore 6.13.0.312) AppleWebKit/537.36 (KHTML, like Gecko) HuaweiBrowser/6.0.1.311 Mobile Safari/537.36",
|
||||
)
|
||||
assert.equal(r.pretty, "HuaweiBrowser/6 HarmonyOS")
|
||||
assert.equal(r.engine, "ArkWeb")
|
||||
assert.equal(r.os, "HarmonyOS")
|
||||
})
|
||||
|
||||
test("ancient browser versions are marked spoofed", () => {
|
||||
const r = uaparse(
|
||||
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.0.0 Safari/537.36",
|
||||
)
|
||||
assert.equal(r.pretty, "Chrome/60 Windows (spoofed)")
|
||||
assert.equal(r.kind, "")
|
||||
})
|
||||
|
||||
test("HTTP clients", () => {
|
||||
assert.equal(
|
||||
uaparse("python-requests/2.32.5").pretty,
|
||||
"python-requests/2.32.5",
|
||||
)
|
||||
assert.equal(uaparse("curl/8.0").pretty, "curl/8.0")
|
||||
})
|
||||
|
||||
test("GPTBot", () => {
|
||||
const r = uaparse(
|
||||
"Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko); compatible; GPTBot/1.2; +https://openai.com/gptbot",
|
||||
)
|
||||
assert.equal(r.pretty, "GPTBot (AI)")
|
||||
assert.equal(r.kind, "ai")
|
||||
assert.equal(r.provider, "OpenAI")
|
||||
assert.equal(r.url, "https://openai.com/gptbot")
|
||||
})
|
||||
|
||||
test("Facebook external hit, disguised as Chrome on Android", () => {
|
||||
const r = uaparse(
|
||||
"Mozilla/5.0 (Linux; Android 13; Pixel 7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.6885.65 Mobile Safari/537.36; compatible; facebookexternalhit/1.1; +http://www.facebook.com/externalhit_uatext.php",
|
||||
)
|
||||
assert.equal(r.pretty, "Facebook")
|
||||
assert.equal(r.kind, "social")
|
||||
assert.equal(r.provider, "Meta")
|
||||
assert.equal(r.url, "http://www.facebook.com/externalhit_uatext.php")
|
||||
})
|
||||
|
||||
test("unknown bot from product token", () => {
|
||||
const r = uaparse("NewBot/1.0 (+https://example.com/bot)")
|
||||
assert.equal(r.pretty, "NewBot")
|
||||
assert.equal(r.kind, "spider")
|
||||
})
|
||||
|
||||
test("named from compatible token", () => {
|
||||
const r = uaparse(
|
||||
"Mozilla/5.0 (compatible; Page2RSS/0.7; +http://page2rss.com/)",
|
||||
)
|
||||
assert.equal(r.pretty, "Page2RSS")
|
||||
assert.equal(r.kind, "spider")
|
||||
})
|
||||
|
||||
test("unrecognized Mozilla UA falls back to the raw string", () => {
|
||||
const ua = "Mozilla/5.0 (something entirely unknown)"
|
||||
assert.equal(uaparse(ua).pretty, ua)
|
||||
})
|
||||
|
||||
test("results are cached", () => {
|
||||
const ua =
|
||||
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/152.0.0.0 Safari/537.36"
|
||||
assert.equal(uaparse(ua), uaparse(ua))
|
||||
})
|
||||
@@ -0,0 +1,14 @@
|
||||
{
|
||||
"compilerOptions": {
|
||||
"target": "ES2022",
|
||||
"module": "NodeNext",
|
||||
"moduleResolution": "NodeNext",
|
||||
"lib": ["ES2022"],
|
||||
"outDir": "dist",
|
||||
"declaration": true,
|
||||
"strict": true,
|
||||
"verbatimModuleSyntax": true,
|
||||
"skipLibCheck": true
|
||||
},
|
||||
"include": ["src"]
|
||||
}
|
||||
Reference in New Issue
Block a user