کتابخانه
ua-parser-js یه کتابخانه جاوااسکریپت برای تشخیص مرورگر، موتور رندر، سیستم عامل، پردازنده و نوع و مدل دستگاه از روی User-Agent و داده های Client Hints هست. هم توی مرورگر کار می کنه هم توی Node.js. برای آمار بازدید، پیام برای مرورگرهای قدیمی و رفتار متفاوت روی موبایل به درد می خوره.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز AGPL-3.0-or-later؛ هش هر فایل با منبع بررسی شده است.
۱۰۷ کیلوبایت· ۷ فایل· انتشار
SHA-256: 506462f545eb810192aa0cd26fd880d7234c62d0878969cc079981481d9fa2ea
ua-parser-js رشته User-Agent مرورگر رو می گیره و بهش ساختار می ده: اسم مرورگر، موتور رندر، سیستم عامل، معماری پردازنده، نوع و مدل دستگاه. خود User-Agent یه متن بلند و درهم برهمه و نوشتن Regex دستی برای همه ترکیب هاش دردسر داره. این کتابخانه اون زحمت رو برمی داره و نتیجه رو توی یه شیء مرتب تحویلت می ده. از Client Hints هم پشتیبانی می کنه و هم توی مرورگر کار می کنه هم توی Node.js.
کاربردهاش ساده و ملموسه. فرض کن یه فروشگاه اینترنتی داری و می خوای بدونی بازدیدکننده هات بیشتر با اندروید میان یا آیفون. یا می خوای به کسی که با یه مرورگر خیلی قدیمی اومده، پیام «مرورگرت رو به روز کن» نشون بدی. یا توی سرور Node.js می خوای لاگ درخواست ها رو بر اساس نوع دستگاه دسته بندی کنی. تو همه این موارد کتابخانه فقط اطلاعات رو بهت می ده و تصمیمش با خودته.
قبل از انتخابش چند نکته رو جدی بگیر. User-Agent رو هر کسی می تونه تغییر بده، پس هیچ تصمیم امنیتی رو روش بنا نکن. اگه می خوای بدونی مرورگر یه قابلیت رو داره یا نه، تشخیص قابلیت (feature detection) راه درست تره، نه حدس زدن از روی اسم مرورگر. یه نکته دیگه هم اینه که مرورگرهای مبتنی بر کرومیوم چند ساله جزئیات User-Agent رو کم کردن و اطلاعات دقیق تر رو از راه Client Hints می دن. این اطلاعات معمولا فقط توی زمینه امن (HTTPS) در دسترسه. پس اگه سایتت هنوز روی HTTP هست، انتظار نتیجه کامل نداشته باش.
نکته آخر مجوزه. مجوز این بسته بین نسخه ها فرق کرده و نسخه های تازه تر با AGPL منتشر می شن، مجوزی که برای سرویس های تحت شبکه شرط های مشخصی داره. اگه قراره توی محصول تجاری یا قالب و افزونه فروشی ازش استفاده کنی، قبل از شروع متن مجوز همون نسخه ای که برمی داری رو بخون و اگه لازم شد با سازنده یا یه مشاور حقوقی مشورت کن. نسخه های رسمی و بدون تغییر ua-parser-js توی مخزن داخلی ما هم در دسترسه، برای روزهایی که دسترسی به npm یا سرورهای خارجی مشکل داره.
برای استفاده توی یه صفحه معمولی یا قالب وردپرسی، فایل رو با کد آماده پایین همین صفحه به سایتت اضافه کن. بعدش این مراحل رو جلو ببر:
اگه سایتت کش سنگین داره، حواست باشه صفحه ای که بر اساس نوع دستگاه تغییر می کنه برای همه کاربرها یکسان کش نشه.
اسم و نسخه مرورگر، موتور رندر، سیستم عامل، معماری پردازنده و نوع و مدل دستگاه رو از User-Agent یا Client Hints درمیاره. دقتش به چیزی که مرورگر می فرسته بستگی داره و همه فیلدها همیشه پر نمی شن، مخصوصا مدل دستگاه.
آره، چون یه کتابخانه جاوااسکریپته و به وردپرس وابسته نیست. فایلش رو توی قالب یا افزونه خودت با wp_enqueue_script لود کن و بعد توی اسکریپت خودت صداش بزن. اگه تشخیص سمت سرور می خوای، اون رو جداگانه توی PHP یا Node.js انجام بده.
ua-parser-js می گه کاربر با چه مرورگر و دستگاهی اومده، ولی تشخیص قابلیت می گه مرورگر یه ویژگی مشخص رو داره یا نه. برای اینکه بفهمی یه API کار می کنه، تشخیص قابلیت قابل اعتمادتره. برای آمار و گزارش گیری، ua-parser-js مناسب تره.
مجوز AGPL شرط های مشخصی داره، مخصوصا وقتی نرم افزار از راه شبکه به کاربرها سرویس می ده. مجوز هم بین نسخه ها فرق کرده. قبل از استفاده توی محصول تجاری متن مجوز نسخه خودت رو بخون و اگه مطمئن نبودی، با سازنده یا یه مشاور حقوقی مشورت کن.
مرورگرها، مخصوصا کرومیوم، عمدا جزئیات User-Agent رو کم کردن. اطلاعات دقیق تر فقط از راه Client Hints و معمولا روی HTTPS در دسترسه. پس اگه سایتت امن نیست یا مرورگر اون داده رو نفرسته، نتیجه کلی تر می شه.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.