راهنمای کاربر UA PRO

راهنمای شروع

از نخستین قانون خود آغاز کنید و با محدوده، حالت‌های تصادفی، بازگشت به دامنه منبع و انتقال پیکربندی آشنا شوید.

مربوط به نسخه: 1.4.5 · به‌روزرسانی راهنما: 16 نوامبر 2026

این راهنما نسخه 1.4.5 را پوشش می‌دهد. نسخه موجود در منبع نصب انتخابی خود را بررسی کنید.

UA Pro به شما امکان می‌دهد User-Agent ‏(UA) را برای همه وب‌سایت‌ها، دامنه‌های مشخص یا یک زبانه تنظیم کنید. ابتدا صفحاتی را که قانون بر آن‌ها اثر می‌گذارد انتخاب کنید، سپس روش تولید UA را برگزینید. وقتی چند قانون وجود دارد، افزونه بر اساس اولویت یک قانون صفحه اصلی را انتخاب می‌کند؛ منابع معمول داخل صفحه ابتدا UA صفحه اصلی را به ارث می‌برند.

01آشنایی با UA و منابع صفحه

UA توصیفی از هویت است که مرورگر به وب‌سایت‌ها می‌فرستد و معمولاً مرورگر، سیستم‌عامل و دستگاه را در بر می‌گیرد. UA Pro می‌تواند User-Agent درخواست‌های معمول وب را تغییر دهد و مقدار متناظر را برای navigator.userAgent در صفحات معمول ارائه کند.

انتخاب UA موبایل به شما امکان می‌دهد ببینید وب‌سایت برای UAهای موبایل چه پاسخی می‌دهد، اما رایانه را به تلفن تبدیل نمی‌کند و اندازه صفحه، موتور مرورگر، IP یا اثرانگشت کامل مرورگر را نیز خودکار تغییر نمی‌دهد.

فرض کنید نوار نشانی https://shop.example.com/product را نشان می‌دهد:

اصطلاح معنا در این مثال
صفحه اصلی صفحه محصولی که در نوار نشانی باز شده است
دامنه صفحه اصلی shop.example.com، بدون پروتکل یا مسیر
دامنه والد نسبت به shop.example.com، دامنه example.com یک دامنه والد است
زیردامنه img.shop.example.com زیردامنه‌ای زیر shop.example.com است
منابع داخل صفحه تصاویر، اسکریپت‌ها، شیوه‌نامه‌ها، درخواست‌های API، iframeهای شبکه‌ای معمول و موارد دیگری که صفحه بارگیری می‌کند
دامنه منبع دامنه مقصد درخواست منبع، مانند cdn.example.net

در این راهنما «دامنه صفحه اصلی» به نام میزبان صفحه در نوار نشانی گفته می‌شود. این یک دامنه سطح بالا مانند .com نیست و لزوماً یک دامنه ثبت‌شده مانند example.com هم نیست.

02سه مفهوم مستقل تنظیمات

تنظیم پرسشی که پاسخ می‌دهد مثال‌ها
محدوده کدام صفحات از این قانون استفاده می‌کنند؟ سراسری، دامنه example.com، زبانه کنونی
حالت UA محتوای UA از کجا می‌آید؟ UA داخلی، سفارشی، افزودن متن، UA تصادفی
حالت تصادفی وقتی حالت تصادفی انتخاب شود، چه زمانی مقدار جدید انتخاب می‌شود؟ در هر بارگذاری صفحه، برای هر برگه

برای نمونه، «محدوده دامنه + UA تصادفی + برای هر زبانه» یعنی هر زبانه‌ای که از صفحات محدوده آن دامنه بازدید کند، نتیجه تصادفی خود را برای آن قانون ذخیره می‌کند. این به معنای اشتراک یک UA دائمی میان همه زبانه‌های بازدیدکننده دامنه نیست.

2.1 محدوده

محدوده چه چیزی را تحت تأثیر قرار می‌دهد مدت و رابطه جایگزینی
سراسری صفحات معمول وب‌سایت که قانون با اولویت بالاتر ندارند پیکربندی حفظ می‌شود؛ قانون دامنه یا زبانه می‌تواند جای آن را بگیرد
دامنه صفحاتی که دامنه صفحه اصلی آن‌ها با دامنه تعیین‌شده یا یکی از زیردامنه‌های آن مطابقت دارد پیکربندی حفظ می‌شود؛ قانون دامنه مشخص‌تر یا قانون زبانه می‌تواند جای آن را بگیرد
زبانه زبانه‌ای که قانون در آن ساخته شده است بالاترین اولویت؛ هنگام رفتن آن زبانه به وب‌سایت‌های دیگر هم اعمال می‌شود و با بسته شدن زبانه پایان می‌یابد

«محدوده سراسری + تصادفی برای هر زبانه» همچنان یک قانون سراسری است؛ ذخیره جداگانه نتایج تصادفی آن را به قانون زبانه با اولویت اول تبدیل نمی‌کند.

2.2 حالت UA

حالت نحوه تولید UA مناسب برای
UA داخلی یک UA از مرورگرها یا دستگاه‌های ازپیش‌تنظیم‌شده انتخاب می‌کند استفاده سریع از هویت ازپیش‌تنظیم‌شده
سفارشی از رشته کامل UA که وارد می‌کنید استفاده می‌کند استفاده از UA مشخص یا ذخیره فهرست UA خودتان
افزودن متن یک فاصله و متن مشخص‌شده را به انتهای UA پیش‌فرض مرورگر می‌افزاید افزودن نشانه شناسایی به UA پیش‌فرض
UA تصادفی یک UA از مجموعه نامزدهای انتخاب‌شده برمی‌گزیند اختصاص مقادیر تصادفی در هر بار بارگیری صفحه یا برای هر زبانه

افزودن متن بر پایه UA پیش‌فرض مرورگر است، نه UA دامنه والد یا UA سراسری که جایگزین شده است. مثلاً اگر قانون سراسری UA سفارشی باشد و قانون دامنه MyTest را اضافه کند، آن دامنه در نهایت از «UA پیش‌فرض مرورگر + فاصله + MyTest» استفاده می‌کند. دو قانون روی هم انباشته نمی‌شوند.

مجموعه نامزدهای تصادفی می‌تواند از UAهای داخلی، فهرست سفارشی، فهرست متن‌های افزودنی یا ترکیبی از آن‌ها تشکیل شود؛ می‌توانید دسته‌های مشخصی را نیز انتخاب کنید. متن‌های افزودنی نامزد ابتدا با UA پیش‌فرض مرورگر ترکیب می‌شوند و سپس وارد انتخاب تصادفی می‌شوند. اگر مجموعه خالی باشد یا محتوای معتبری نداشته باشد، قانون نمی‌تواند قانون معتبر صفحه اصلی شود.

03اولویت قانون صفحه اصلی

قانون زبانه ← مشخص‌ترین قانون معتبر دامنه ← قوانین دامنه والد، مرحله به مرحله ← قانون سراسری ← UA پیش‌فرض مرورگر.

نخستین قانون فعال در این ترتیب که بتواند UA معتبر تولید کند استفاده می‌شود و قوانین بعدی با آن ترکیب نمی‌شوند. میان حالت‌های ثابت و تصادفی اولویت اضافی وجود ندارد.

ترتیب بررسی مثال وقتی صفحه اصلی news.shop.example.com است
1 قانون زبانه کنونی
2 قانون معتبر برای news.shop.example.com
3 قانون معتبر برای shop.example.com
4 قانون معتبر برای example.com
5 قانون سراسری معتبر
6 هیچ‌کدام از موارد بالا معتبر نیست؛ از UA پیش‌فرض مرورگر استفاده شود

«معتبر» دو شرط دارد: قانون فعال باشد و بتواند UA مجاز و غیرخالی تولید کند. قوانین متوقف‌شده، UAهای نامجاز و مجموعه‌های خالی نامزد تصادفی نادیده گرفته می‌شوند.

3.1 نحوه تطبیق دامنه‌ها

وقتی example.com را تنظیم کنید، صفحات اصلی زیر مطابقت دارند:

دامنه صفحه اصلی مطابقت دارد؟
example.com بله
www.example.com بله
shop.example.com بله
a.shop.example.com بله
otherexample.com خیر
example.com.other.net خیر
example.net خیر

در فیلد دامنه example.com را وارد کنید؛ https://، مسیر، پارامترهای پرس‌وجو یا پورت را وارد نکنید. پیکربندی در حال حاضر بر اساس دامنه است، نه مسیر URL.

نسخه 1.4.5 گزینه‌ای برای تطبیق فقط همان نام میزبان دقیق و حذف همه زیردامنه‌ها ندارد. اگر می‌خواهید فقط شاخه shop.example.com را تحت تأثیر قرار دهید، shop.example.com را وارد کنید، اما زیردامنه‌های آن همچنان شامل می‌شوند.

در نسخه کنونی، شکل سازگاری *.example.com خود example.com و زیردامنه‌های آن را هم پوشش می‌دهد، نه فقط زیردامنه‌ها را. اگر هر دو قانون معتبر example.com و *.example.com وجود داشته باشند، اولی اولویت دارد؛ وقتی اولی متوقف شود، دومی می‌تواند جای آن را بگیرد. کاربران جدید معمولاً فقط به شکل ساده دامنه نیاز دارند.

3.2 تفاوت توقف موقت و حذف

عمل یا وضعیت معنا
توقف موقت پیکربندی را حفظ می‌کند اما موقتاً آن را از تطبیق کنار می‌گذارد؛ قابل ازسرگیری است
حذف قانون را حذف می‌کند؛ در صورت نیاز دوباره آن را بسازید
جایگزین‌شده قانون همچنان فعال است، اما قانون با اولویت بالاتر بر صفحه کنونی اعمال می‌شود
نامعتبر محتوای کنونی نمی‌تواند UA معتبر تولید کند؛ محتوا یا مجموعه نامزدها را اصلاح کنید

پس از توقف موقت یا حذف یک قانون، افزونه به جست‌وجوی قوانین معتبر دیگر ادامه می‌دهد. بنابراین توقف موقت یک قانون استثنا نیست که صفحه را به استفاده از UA پیش‌فرض مرورگر مجبور کند.

برای مثال فرض کنید تنها قوانین فعال و معتبر، قانون سراسری با UA-G، ‏example.com با UA-P و shop.example.com با UA-C هستند:

عمل نتیجه هنگام باز کردن shop.example.com
هر سه قانون فعال‌اند UA-C
توقف موقت قانون زیردامنه UA-P
توقف موقت قانون دامنه والد نیز UA-G
توقف موقت قانون سراسری نیز UA پیش‌فرض مرورگر
افزودن قانون معتبر زبانه UA-T آن زبانه از UA-T استفاده می‌کند

UA-G، UA-P، UA-C و UA-T در اینجا فقط برچسب‌هایی برای محتواهای متفاوت UA هستند.

04دو حالت تصادفی

4.1 در هر بارگذاری صفحه

در هر بار بارگیری کامل شبکه‌ای صفحه اصلی یک مقدار انتخاب می‌شود و منابع معمول داخل صفحه همان نتیجه صفحه اصلی را دوباره به کار می‌برند. تازه‌سازی یا پیمایش کامل انتخاب جدید انجام می‌دهد؛ درخواست‌های داخل صفحه مانند تصاویر، APIها و iframeها هر کدام انتخاب جدیدی برای صفحه اصلی ایجاد نمی‌کنند.

برای نمونه، فرض کنید مجموعه نامزدها شامل UA-A، UA-B و UA-C است:

عمل یکی از نتایج ممکن
باز کردن صفحه برای نخستین بار سند اصلی و منابع معمول از UA-A استفاده می‌کنند
صفحه سپس تصاویر و APIها را درخواست می‌کند همچنان UA-A
فقط لنگر یا مسیر داخلی SPA تغییر می‌کند همچنان UA-A
تازه‌سازی صفحه انتخاب مجدد؛ ممکن است UA-C استفاده شود
پیمایش کامل به صفحه دیگری که همچنان با این قانون مطابقت دارد انتخاب مجدد؛ ممکن است UA-B استفاده شود

«انتخاب مجدد» به معنای «حتماً دریافت مقدار متفاوت» نیست. همچنین وقتی دکمه عقب یا جلو مرورگر سند ذخیره‌شده را مستقیماً بدون بارگیری شبکه‌ای جدید سند اصلی بازیابی می‌کند، نمی‌توان آن را به‌سادگی انتخاب جدید شمرد.

در تغییر مسیرها نیز قانون قابل اعمال بر اساس صفحه مقصد تعیین می‌شود. در همان پیمایش و همان قانون، هر مرحله تغییر مسیر انتخاب مکرر ایجاد نمی‌کند؛ اگر دامنه مقصد با قانون دیگری تطبیق یابد، آن قانون به جای آن اعمال می‌شود.

4.2 برای هر برگه

نتیجه تصادفی برای هر «قانون + زبانه» ذخیره می‌شود. تا زمانی که پیکربندی تغییر نکند و زبانه بسته نشود، تازه‌سازی و پیمایش کامل تحت همان قانون همچنان از آن نتیجه استفاده می‌کنند.

برای نمونه، حالت تصادفی «برای هر برگه» را برای example.com تنظیم کنید:

عمل یکی از نتایج ممکن
زبانه 1، example.com را باز می‌کند این قانون UA-A را به زبانه 1 پیوند می‌دهد
زبانه 1 تازه‌سازی می‌کند یا به shop.example.com می‌رود و قانون مشخص‌تری وجود ندارد استفاده از UA-A ادامه می‌یابد
زبانه 2، example.com را باز می‌کند برای زبانه 2 یک پیوند ذخیره می‌شود؛ ممکن است UA-B یا همچنان UA-A باشد
زبانه 1 به other.net می‌رود که قانونی ندارد و قانون سراسری نیز وجود ندارد از UA پیش‌فرض مرورگر استفاده می‌کند
زبانه 1 به example.com برمی‌گردد UA-A اولیه این قانون بازیابی می‌شود
زبانه 1 را ببندید و دوباره باز کنید پیوند زبانه اولیه پاک می‌شود و می‌توان دوباره اختصاص داد

اگر قانون جداگانه shop.example.com وجود داشته باشد، حتی اگر هر دو قانون مجموعه نامزد یکسانی انتخاب کنند، همچنان دو قانون متفاوت‌اند و پیوندهای تصادفی را جداگانه ذخیره می‌کنند. پس از تغییر پارامترهای قانون یا کتابخانه نامزدها، یا پس از راه‌اندازی مجدد مرورگر، ممکن است نتایج تصادفی دوباره اختصاص داده شوند.

4.3 ترکیب محدوده و حالت

جدول زیر رفتار را پس از آنکه قانونی اولویت صفحه اصلی را به دست آورد توصیف می‌کند. حالت‌های ثابت شامل UA داخلی، سفارشی و افزودن متن هستند.

محدوده حالت‌های ثابت تصادفی در هر بارگذاری صفحه تصادفی برای هر زبانه
سراسری صفحات منطبق از UA این قانون استفاده می‌کنند در هر بار بارگیری شبکه‌ای صفحه اصلی انتخاب می‌شود هر زبانه پیوند خود را برای این قانون سراسری ذخیره می‌کند
دامنه صفحات دامنه منطبق و زیردامنه‌های آن از این UA استفاده می‌کنند در هر بار بارگیری شبکه‌ای صفحه اصلی در محدوده منطبق انتخاب می‌شود هر زبانه پیوند خود را برای این قانون دامنه ذخیره می‌کند
زبانه این زبانه حتی پس از رفتن به وب‌سایت‌های دیگر از این UA استفاده می‌کند این زبانه در هر بار بارگیری شبکه‌ای صفحه اصلی انتخاب می‌کند این زبانه نتیجه تصادفی ثابتی برای قانون نگه می‌دارد که پس از تازه‌سازی و پیمایش میان سایت‌ها حفظ می‌شود

در همه ترکیب‌ها، منابع معمول داخل صفحه ابتدا UA صفحه اصلی را به ارث می‌برند. حالت تصادفی مدت ماندگاری مقدار را تعیین می‌کند و اولویت قانون را تغییر نمی‌دهد.

05منابع داخل صفحه و بازگشت به دامنه منبع

5.1 وقتی صفحه اصلی قانون دارد، منابع ابتدا ارث می‌برند

فرض کنید قوانین زیر وجود دارند:

  • shop.example.com → UA-Shop.
  • cdn.example.net → UA-CDN.

وقتی shop.example.com را باز می‌کنید و صفحه cdn.example.net/photo.png را بارگیری می‌کند، تصویر از UA-Shop استفاده می‌کند. حتی اگر دامنه مقصد منبع قانون خودش را داشته باشد، جای قانون صفحه اصلی را نمی‌گیرد. این کار UA سند اصلی و منابع معمول داخل صفحه را یکسان نگه می‌دارد.

اگر cdn.example.net را مستقیماً در نوار نشانی زبانه جدید باز کنید، آن دامنه صفحه اصلی می‌شود و می‌تواند با قانون UA-CDN خودش مطابقت یابد.

5.2 کلید بازگشت چه زمانی اثر دارد

قاعده جایگزین دامنه منبع در بخش «بیشتر» به‌طور پیش‌فرض خاموش است. این کلید سراسری مستقلی است و برای همه حالت‌های UA اعمال می‌شود.

فقط زمانی اثر دارد که صفحه اصلی UA معتبر زبانه، دامنه یا سراسری نداشته باشد و به منابع اجازه می‌دهد بر اساس دامنه مقصد خودشان به دنبال قانون دامنه معتبر بگردند. دامنه‌های منابع از همان منطق پیروی می‌کنند: قانون مشخص‌تر اولویت دارد و وقتی قانون فرزند متوقف شود، قانون والد به ارث می‌رسد.

آیا صفحه اصلی UA معتبر دارد؟ کلید آیا خود منبع با قانون دامنه معتبر مطابقت دارد؟ UA منابع معمول
بله خاموش یا روشن بله یا خیر UA صفحه اصلی را به ارث می‌برد
خیر خاموش بله یا خیر UA پیش‌فرض مرورگر
خیر روشن بله UA تولیدشده توسط قانون دامنه منبع
خیر روشن خیر UA پیش‌فرض مرورگر

وقتی صفحه اصلی قانون معتبر ندارد، سند اصلی آن همچنان از UA پیش‌فرض مرورگر استفاده می‌کند؛ بازگشت منبع هرگز متقابلاً مقداری به صفحه اصلی اختصاص نمی‌دهد. قانون سراسری معتبر نیز «صفحه اصلی UA معتبر دارد» محسوب می‌شود، پس قانون سراسری مانع تسلط بازگشت منبع بر منابع معمول می‌شود.

5.3 مثال بازگشت

news.example.org را بدون قانون زبانه، قانون دامنه صفحه اصلی یا قانون سراسری باز کنید. همچنین cdn.example.net → UA-CDN وجود دارد:

درخواست بازگشت خاموش بازگشت روشن
سند اصلی news.example.org UA پیش‌فرض UA پیش‌فرض
API مربوط به news.example.org/api UA پیش‌فرض UA پیش‌فرض
cdn.example.net/app.js UA پیش‌فرض UA-CDN
img.cdn.example.net/photo.png UA پیش‌فرض UA-CDN، به ارث رسیده از قانون دامنه والد منبع
other.net/font.woff، بدون قانون منطبق UA پیش‌فرض UA پیش‌فرض

اگر UA-G سراسری اضافه شود، همه درخواست‌های معمول بالا تابع UA-G صفحه اصلی هستند و UA-CDN منبع دیگر جای آن را نمی‌گیرد.

5.4 بازگشت همراه با حالت‌های تصادفی

حالت قانون دامنه منبع روش دریافت مقدار وقتی بازگشت مجاز است
حالت‌های ثابت از UA تنظیم‌شده در قانون منبع استفاده می‌کند
تصادفی در هر بارگذاری صفحه نتیجه برای هر «این بارگیری صفحه میزبان + قانون منبع» ذخیره می‌شود؛ منابعی در آن بارگیری صفحه که با همان قانون مطابقت دارند در آن شریک‌اند
تصادفی برای هر زبانه نتیجه برای هر «زبانه میزبان + قانون منبع» ذخیره می‌شود؛ همان زبانه پس از تازه‌سازی نیز به استفاده از آن ادامه می‌دهد

برای مثال، اگر cdn.example.net از حالت تصادفی استفاده کند و img.cdn.example.net و js.cdn.example.net هر دو آن را به ارث ببرند، در آن پیوند شریک‌اند. اگر img.cdn.example.net قانون معتبر خودش را داشته باشد، به قانون دیگری تعلق دارد و می‌تواند از UA متفاوتی استفاده کند.

زبانه‌های دیگری که از دامنه منبع بازدید می‌کنند پیوندهای تصادفی منبع را که قبلاً برای صفحه کنونی ذخیره شده‌اند بازنویسی نمی‌کنند. روشن کردن بازگشت اجازه می‌دهد قوانین منبع متفاوت در یک صفحه از UAهای متفاوت استفاده کنند؛ اگر می‌خواهید یک صفحه معمول در کل یکسان بماند، معمولاً آن را خاموش نگه دارید (پیش‌فرض).

06تنظیم نخستین قانون

  1. وب‌سایتی را که می‌خواهید پیکربندی کنید باز کنید و روی نماد UA Pro در نوار ابزار کلیک کنید.
  2. اگر دکمه تنظیم قانون برای وب‌سایت کنونی وجود دارد، روی آن کلیک کنید؛ یا از طریق «بیشتر» قانون جدیدی بسازید.
  3. محدوده را انتخاب کنید. برای آزمایش موقت فقط در زبانه کنونی «برگه» را انتخاب کنید؛ برای اعمال روی چند زبانه یک وب‌سایت «دامنه» را انتخاب کنید؛ برای استفاده به عنوان پیش‌فرض همه وب‌سایت‌ها «سراسری» را انتخاب کنید.
  4. اگر دامنه را انتخاب کردید، فیلد دامنه را بررسی کنید. برای نمونه، اگر در www.example.com هستید و می‌خواهید shop.example.com را شامل کنید، example.com را وارد کنید.
  5. یک حالت انتخاب کنید. برای «داخلی» مرورگر یا دستگاه انتخاب کنید؛ برای «سفارشی» UA کامل وارد کنید؛ برای «افزودن متن» فقط متن افزودنی را وارد کنید؛ برای «تصادفی» مجموعه نامزدها و حالت تصادفی را انتخاب کنید.
  6. در «بررسی و اعمال»، محدوده و محتوا را بررسی کنید و روی «اعمال» یا «ذخیره و اعمال» کلیک کنید. منتظر تأیید «قانون ذخیره و فعال شد» بمانید.
  7. صفحه وب را تازه‌سازی کنید و قانون فعال کنونی را که در صفحه اصلی نشان داده می‌شود بررسی کنید. صفحات موجود باید تازه‌سازی شوند تا سند اصلی و اسکریپت‌ها هر دو UA جدید را به کار ببرند.

در فهرست قوانین می‌توانید قوانین را ویرایش، موقتاً متوقف، از سر گرفته یا حذف کنید. قانونی که قانون دیگری جای آن را گرفته همچنان فعال است اما اکنون اولویت ندارد؛ قانون متوقف‌شده در تطبیق شرکت نمی‌کند. اگر هشدار نبود UA معتبر ظاهر شد، محتوای سفارشی یا مجموعه نامزدهای تصادفی را بررسی کنید.

UA سفارشی باید محتوای معتبر سرآیند درخواست در یک خط و بدون شکست خط یا نویسه کنترلی باشد. محتوای سفارشی جدید یا متن افزودنی را می‌توان بر اساس دسته در فهرست ذخیره کرد تا بعداً انتخاب شود یا به عنوان نامزد تصادفی به کار رود.

07فعال‌سازی پنجره شناور UA

بیشتر را باز کنید و پنجره شناور UA را فعال کنید. به‌طور پیش‌فرض خاموش است و می‌تواند در صفحات HTTP/HTTPS قابل دسترسی ظاهر شود.

UA صفحه: مقداری که JavaScript صفحه از navigator.userAgent می‌خواند.

UA درخواست: User-Agent مشاهده‌شده توسط مرورگر برای این درخواست سند اصلی.

این پنجره UA صفحه کنونی در نوار نشانی مرورگر را نشان می‌دهد. UA درخواست‌های تصاویر، اسکریپت‌ها، APIها یا منابع دیگر مانند منابع CDN را شامل نمی‌شود.

اگر هر دو مقدار در دسترس و دقیقاً یکسان باشند، در یک خط نمایش داده می‌شوند. در غیر این صورت جداگانه نمایش داده می‌شوند.

اگر پنجره پس از بارگیری صفحه روشن شده است، صفحه را تازه‌سازی کنید تا درخواست اصلی آن ثبت شود. وقتی درخواست در دسترس نیست، پنجره به جای استفاده از مقدار تنظیم‌شده همان وضعیت را نشان می‌دهد.

برای جابه‌جایی پنجره، دستگیره یا یک برچسب را بکشید. برای تنظیم عرض لبه چپ یا راست و برای تنظیم ارتفاع لبه بالا یا پایین را بکشید. دوبار کلیک روی یک لبه اندازه خودکار را فقط برای همان بُعد بازمی‌گرداند. دکمه نیم‌دایره میزان تیرگی (عدم شفافیت) پس‌زمینه را تنظیم می‌کند. دکمه بستن پنجره را در همه صفحات خاموش می‌کند.

اگر User-Agent طولانی باشد، متن آن در پنجره باریک خودکار به خط بعدی ادامه می‌یابد. در صورت نیاز ارتفاع پنجره بیشتر می‌شود. اگر متن از صفحه نمایش بلندتر است، داخل پنجره پیمایش کنید. عرض و ارتفاع تنظیم‌شده دستی تا زمان بازنشانی حفظ می‌شوند.

پنجره هنگام بارگیری مقادیر صفحه جدید می‌کوشد اندازه یکسانی نگه دارد. جای‌نگهدار بارگیری را نشان می‌دهد و هرگز مقادیر صفحه قبلی را نشان نمی‌دهد. پیمایش کامل صفحه را دوباره می‌سازد، بنابراین پنجره ممکن است برای لحظه‌ای ناپدید شود.

تغییر قانون صفحه‌ای را که قبلاً بارگیری شده یا سرآیند ارسال‌شده با درخواست اولیه آن را تغییر نمی‌دهد. برای بررسی قانون جدید تازه‌سازی کنید. پروکسی یا سرور ممکن است پس از مشاهده مرورگر، سرآیندهای درخواست را تغییر دهد. پنجره نمی‌تواند در صفحات محافظت‌شده مرورگر یا فروشگاه‌های افزونه مرورگر ظاهر شود.

منوی بیشتر شامل راهنمای کاربران جدید هم هست؛ برای باز کردن وب‌سایت روی UA Pro در پایین آن منو کلیک کنید.

08نحوه تنظیم هدف‌های رایج

هدف روش تنظیم نکته‌ها
آزمایش UA موبایل فقط در زبانه کنونی زبانه + UA موبایل داخلی وقتی آن زبانه به سایت‌های دیگر برود همچنان اعمال می‌شود؛ پس از بستن آن پایان می‌یابد
استفاده از UA ثابت در سراسر یک سایت دامنه example.com + UA داخلی یا سفارشی همه زیردامنه‌ها را شامل می‌شود؛ بر زبانه‌های دیگر هم اعمال می‌شود
استفاده از UA متفاوت برای زیربخش فروشگاه قانون والد را حفظ کنید و قانون shop.example.com را اضافه کنید اگر قانون با اولویت بالاتر نباشد، قانون فرزند اولویت دارد؛ با توقف قانون فرزند، قانون والد می‌تواند جای آن را بگیرد
استفاده از یک UA پیش‌فرض برای همه سایت‌ها با یک سایت استثنا UA-G را سراسری و UA-D را در دامنه هدف تنظیم کنید هرجا قانون دیگری با اولویت بالاتر اعمال نشود، دامنه هدف از UA-D و صفحات دیگر از UA-G استفاده می‌کنند
انتخاب تصادفی دوباره UA یک سایت در هر تازه‌سازی دامنه + UA تصادفی + در هر بارگذاری صفحه منابع در آن بارگیری صفحه در نتیجه شریک‌اند؛ ممکن است انتخاب تکرار شود
ثابت نگه داشتن UA یک سایت در هر زبانه دامنه + UA تصادفی + برای هر برگه هر قانون در هر زبانه پیوندی جداگانه ذخیره می‌کند
تنظیم UA فقط برای منابع خارجی بر اساس دامنه مقصد قانون دامنه منبع بسازید و بازگشت منبع را روشن کنید صفحه میزبان نباید UA معتبر زبانه، دامنه یا سراسری داشته باشد
غیرفعال کردن موقت قانون زیردامنه روی توقف موقت کلیک کنید صفحه از قانون معتبر باقی‌مانده با بالاترین اولویت، مانند قانون برگه، قانون دامنه منطبق دیگر یا قانون سراسری استفاده می‌کند. اگر هیچ‌کدام اعمال نشود، از UA پیش‌فرض مرورگر استفاده می‌کند

09پشتیبان‌گیری و انتقال

قابلیت‌های وارد کردن و صادر کردن در بخش «بیشتر» می‌توانند از قوانین سراسری، قوانین دامنه، کتابخانه سفارشی، کتابخانه متن افزودنی و کلید بازگشت به دامنه منبع نسخه پشتیبان تهیه کنند یا آن‌ها را انتقال دهند.

قوانین زبانه و پیوندهای تصادفی که قبلاً انتخاب شده‌اند بخشی از این خروجی پیکربندی پایدار نیستند. وارد کردن، زبانه‌های اولیه یا وضعیت تصادفی آن‌ها را بازسازی نمی‌کند.

می‌توانید فایل پیکربندی محلی را وارد کنید یا نشانی پیکربندی راه دور را بارگیری و ورود را تأیید کنید. ابتدا نسخه پشتیبان صادر کنید. شیء ارائه‌شده برای قانون سراسری، قوانین دامنه، کتابخانه سفارشی یا کتابخانه متن افزودنی، بخش متناظر خود را جایگزین می‌کند. اگر هر یک از این چهار بخش موجود نباشد یا null باشد، مقدار قبلی آن بدون تغییر می‌ماند؛ به‌ویژه قانون سراسری null قانون سراسری موجود را پاک نمی‌کند. قاعده جایگزین دامنه منبع فقط وقتی فیلد آن true باشد فعال است؛ در غیر این صورت، از جمله نبودن فیلد یا null بودن آن، پس از ورود خاموش است.

در 1.4.5، حالت تصادفی قدیمی domain به صورت «در هر بارگذاری صفحه» در نظر گرفته می‌شود؛ قوانین تصادفی قدیمی که راهبرد تصادفی مشخص نکرده‌اند «برای هر برگه» تلقی می‌شوند. پس از انتقال، حالت مورد نیاز را در رابط بررسی کنید.

10پرسش‌های متداول و محدودیت‌های استفاده

پرسش توضیح
چرا صفحه بلافاصله پس از ذخیره همچنان UA قدیمی را نشان می‌دهد؟ سندهای موجود دوباره بارگیری نمی‌شوند؛ پس از موفقیت ذخیره تازه‌سازی کنید. همچنین بررسی کنید که قانون با اولویت بالاتر جای آن را نگرفته باشد
چرا پس از توقف قانون فرزند همچنان UA سفارشی استفاده می‌شود؟ ممکن است قانون معتبر برگه همچنان اولویت داشته باشد. در غیر این صورت قانون دامنه منطبق دیگر یا قانون سراسری ممکن است جای آن را بگیرد. پس از تغییر قانون صفحه را تازه‌سازی و قانون فعال را بررسی کنید
چرا قانون دامنه منبع من کار نمی‌کند؟ ابتدا بررسی کنید صفحه اصلی از قبل UA معتبر دارد یا نه، سپس روشن بودن بازگشت منبع و در نهایت اعتبار قانون دامنه منبع را بررسی کنید
چرا مقدار تصادفی پس از تازه‌سازی تغییر نمی‌کند؟ حالت هر زبانه بنا بر طراحی آن را حفظ می‌کند؛ حالت هر بار بارگیری صفحه نیز می‌تواند دوباره همان مقدار را انتخاب کند
چرا زبانه‌هایی که هم‌زمان باز شده‌اند UA یکسانی دارند؟ مقادیر تصادفی ممکن است تکرار شوند؛ پیمایش‌های نخست هم‌زمان نیز ممکن است یک مقدار ذخیره از پیش انتخاب‌شده را مشترکاً استفاده کنند
چرا پس از تغییر به UA موبایل صفحه همچنان شبیه سایت دسکتاپ است؟ وب‌سایت‌ها ممکن است به اندازه صفحه، Client Hints یا اطلاعات دیگر هم تکیه کنند؛ تغییر UA به تنهایی چیدمان متفاوت صفحه را تضمین نمی‌کند

پیمایش‌های نخست هم‌زمان از روشی استفاده می‌کنند که پیمایش بومی مرورگر را حفظ می‌کند: وقتی چند زبانه جدید هم‌زمان یک URL را مستقیماً باز کنند و بسته نخست پیش از نصب قانون اختصاصی ارسال شود، ممکن است از همان UA از پیش انتخاب‌شده استفاده کنند؛ سپس هر زبانه پیوند خود را ذخیره می‌کند. افزونه هیچ واسطه پیمایشی اضافه نمی‌کند و POST بومی فرم را به روش پیمایش دیگری تغییر نمی‌دهد.

صفحات معمول HTTP/HTTPS و منابع آن‌ها هدف اصلی این قابلیت هستند. درخواست‌های Service Worker مشترک را نمی‌توان همیشه به یک زبانه نسبت داد؛ همگام‌سازی UA برای Client Hints، ‏navigator داخل Workerها و iframeهای دارای سند بدون شبکه در این نسخه به‌طور کامل پیاده‌سازی نشده است. حفظ Server-Timing اصلی سایت نیز در این تغییر هنوز پیاده‌سازی نشده است. تغییر UA را جعل کامل اثرانگشت مرورگر تلقی نکنید.

1.4.5 از مجوزهای webRequest و webNavigation برای ردیابی پیمایش صفحه اصلی و UA واقعاً ارسال‌شده استفاده می‌کند. از مجوز مسدودسازی درخواست یا مجوز اشکال‌زدا استفاده نمی‌کند.

11بررسی نسخه و منابع

محیط تأیید نهایی 1.3.0 یک نمایه آزمایشی جداشده در Windows Edge 157.0.4341.42 با سایت‌های محلی HTTP/HTTPS بود. اجرای کامل HTTPS در 128 مورد با 2527 assertion موفق شد؛ آزمون بازگشتی مرز HTTP در 5 مورد با 441 assertion موفق شد. این موارد ترکیب قوانین بالا و مرز هم‌زمانی بیان‌شده را تأیید می‌کنند؛ به معنای پوشش همه نسخه‌های مرورگر و وب‌سایت‌ها نیستند.

پنجره نسخه 1.4.5 در نمایه‌های جداشده Chrome و Edge با صفحات محلی HTTPS آزمایش شد. آزمایش‌ها پیمایش، ادغام UA یکسان صفحه و درخواست در یک خط، تغییر اندازه و خواندن با تأخیر را پوشش دادند. همه وب‌سایت‌ها را پوشش نمی‌دهند.

سوابق دقیق آزمون در مدارک پروژه نگهداری می‌شوند. نسخه قابل نصب را در فروشگاه وب Chrome یا صفحه بارگیری آفلاین بررسی کنید؛ نسخه‌های موجود ممکن است با این راهنما متفاوت باشند.