اجعل المواقع تعمل بالطريقة التي تناسبك أكثر.

ابدأ من هنا

How @grant يعمل

بالنسبة للنصوص البرمجية الجديدة، أعلن عن كل امتيازات API التي تستخدمها. يقوم Social Browser بتشغيل البرامج النصية ذات المنح الصريحة في عالم User Script المعزول ويربط فقط الإمكانات المطلوبة. السيناريو مع @grant none يعمل بدون قدرات جنرال موتورز.

// ==UserScript==// @name Remember display mode// @namespace https://example.com/my-scripts// @match https://example.com/*// @grant GM_getValue// @grant GM_setValue// ==/UserScript== const mode = GM_getValue('displayMode', 'compact');console.log('Saved mode:', mode); GM_setValue('displayMode', 'comfortable');

كلاسيكي GM_* أو الحديثة GM.*?

يدعم Social Browser الأسماء الكلاسيكية المألوفة والحديثة GM.* forms for the main GM capability set. The modern form is Promise-friendly, so use await. اختر نمطًا واحدًا لكل نص وحافظ على الاتساق.

const theme = GM_getValue('theme', 'dark');GM_setValue('theme', 'light');

const theme = await GM.getValue('theme', 'dark');await GM.setValue('theme', 'light');

GM_info / GM.info

استخدم معلومات البرنامج النصي عندما تحتاج إلى فحص البرنامج النصي الحالي أو الإصدار أو المنح أو التطابقات أو معلومات وقت تشغيل Social Browser. لا تقم بسلوك التعليمات البرمجية بشكل صارم حول سلاسل الإصدار إلا إذا كنت بحاجة حقًا إلى منطق التوافق.

// @grant GM_info console.log('Script:', GM_info.script.name);console.log('Version:', GM_info.version);console.log('Handler:', GM_info.scriptHandler);console.log('Grants:', GM_info.scriptGrants);console.log('Matches:', GM_info.scriptMatches);

التخزين

تذكر بيانات البرنامج النصي الصغيرة

تم تحديد نطاق تخزين GM إلى User Script بدلاً من كونه تخزينًا عاديًا للصفحات. إنه مثالي للتفضيلات غير الضارة والعدادات وحالة البرنامج النصي. لا تستخدمه كخزنة غير رسمية لكلمات المرور أو أسرار المصادقة الثنائية (2FA) أو ملفات تعريف الارتباط أو مواد الجلسة.

// @grant GM_getValue// @grant GM_setValue// @grant GM_deleteValue const settings = GM_getValue('settings', { compact: true, rowsPerPage: 25}); settings.rowsPerPage = 50;GM_setValue('settings', settings); // Reset later if the user asks for defaults.// GM_deleteValue('settings');

شاهد تغير القيمة

GM_addValueChangeListener يكون مفيدًا عندما يكون نفس البرنامج النصي مفتوحًا في أكثر من إطار أو علامة تبويب. يتلقى رد الاتصال (name, oldValue, newValue, remote). في Social Browser، يمكن مزامنة أحداث تغيير القيمة عبر الإطارات/علامات التبويب في نفس بروفايل/الجلسة.

// @grant GM_addValueChangeListener// @grant GM_removeValueChangeListener const listenerId = GM_addValueChangeListener( 'displayMode', (name, oldValue, newValue, remote) => { console.log({ name, oldValue, newValue, remote }); }); // Remove it when you no longer need it.// GM_removeValueChangeListener(listenerId);

مساعدين الصفحة

إضافة أنماط أو عناصر صغيرة

GM_addStyle(css) / GM.addStyle(css)

استخدم هذا عندما يكون تخصيص الصفحة مرئيًا في الغالب. إنه أنظف من وضع العديد من الأفراد element.style خصائص.

// @grant GM_addStyle GM_addStyle(` .important-total { font-weight: 700; outline: 2px solid currentColor; padding: 4px 8px; }`);

GM_addElement(...) / GM.addElement(...)

أنشئ عنصر DOM صغيرًا وألحقه بأمان. يمكنك تمرير العنصر الأصلي أولاً، أو حذفه لاستخدام نص الصفحة.

// @grant GM_addElement const panel = document.querySelector('#account-panel');if (panel) { GM_addElement(panel, 'button', { type: 'button', textContent: 'Copy account ID', className: 'my-copy-button', onclick() { const id = panel.querySelector('.account-id')?.textContent?.trim(); if (id) navigator.clipboard.writeText(id); } });}

الشبكة

تقديم طلبات مميزة مع GM_xmlhttpRequest

صفحة عادية fetch() يتم التحكم فيه من خلال قواعد المتصفح/CORS العادية للصفحة. طلب GM الخاص بـ Social Browser يستخدم API قناة طلب مخصصة لعملية المتصفح. قبل إرسال الطلب، يتم التحقق من وجهته مقارنة بالبرنامج النصي @connect القواعد.

// ==UserScript==// @match https://app.example.com/*// @connect api.example.com// @grant GM_xmlhttpRequest// ==/UserScript== const response = await GM_xmlhttpRequest({ method: 'GET', url: 'https://api.example.com/status', responseType: 'json', timeout: 10000, headers: { Accept: 'application/json' }}); console.log(response.status, response.response);

عمليات الاسترجاعات والإجهاض

يدعم الطلب API عمليات الاسترجاعات للطلبات الشائعة ويقوم بإرجاع مؤشر يمكن إحباطه. استخدم المهلة حتى عندما تدعم الإجهاض أيضًا.

// @connect api.example.com// @grant GM_xmlhttpRequest const request = GM_xmlhttpRequest({ url: 'https://api.example.com/slow-report', timeout: 15000, onload(response) { console.log('Loaded:', response.status); }, onerror(error) { console.error('Request failed:', error); }, ontimeout() { console.warn('Request timed out'); }, onabort() { console.log('Request aborted'); }}); // Cancel only if your script no longer needs the result.// request.abort();

الشكل الحديث: GM.xmlHttpRequest(...) and GM.xmlhttpRequest(...) خريطة لنفس القدرة على الطلب.

المصادر

حزمة نصية قابلة لإعادة الاستخدام، CSS أو أصول أخرى

أعلن عن الأصول مع @resource، ثم قراءته بالاسم. GM_getResourceText returns decoded text. GM_getResourceURL returns a data URL that preserves the response MIME type.

// ==UserScript==// @resource helperCss https://example.com/assets/helper.css// @grant GM_getResourceText// @grant GM_getResourceURL// ==/UserScript== const css = await GM_getResourceText('helperCss');console.log(css); const dataUrl = await GM_getResourceURL('helperCss');console.log(dataUrl);

إذا كان اسم المورد غير موجود، فسيتم إرجاع API undefined. اجعل أسماء الموارد قصيرة ووصفية.

مساعدي المتصفح

علامات التبويب والإخطارات والحافظة

GM_openInTab(url, options)

افتح URL في علامة التبويب Social Browser. استخدم active: false متى يجب أن تفتح علامة التبويب الجديدة دون التركيز.

// @grant GM_openInTab GM_openInTab('https://example.com/report', { active: false});

حالة البرنامج النصي لكل علامة تبويب: GM_getTab, GM_saveTab, GM_getTabs

تقوم API بتخزين حالة User Script الصغيرة المرتبطة بعلامات التبويب. تكون مفيدة عندما يحتاج البرنامج النصي إلى تذكر الخطوة أو العرض الذي ينتمي إلى علامة تبويب معينة دون مزجها مع تفضيلات البرنامج النصي العامة.

// @grant GM_getTab// @grant GM_saveTab// @grant GM_getTabs const tabState = await GM_getTab();await GM_saveTab({ ...tabState, lastPanel: 'orders'}); const allScriptTabs = await GM_getTabs();console.log(allScriptTabs);

GM_notification

إظهار إشعار المتصفح لشيء يجب على المستخدم ملاحظته بالفعل. تجنب البريد العشوائي للإشعارات المتعلقة بنشاط البرنامج النصي الروتيني.

// @grant GM_notification await GM_notification({ title: 'Report ready', text: 'The page data is ready to review.'});

GM_setClipboard(data, type)

انسخ النص (أو HTML عند الطلب) إلى الحافظة. استخدمه بعد إجراء واضح للمستخدم عندما يكون ذلك ممكنًا، حتى يفهم المستخدم سبب تغيير الحافظة الخاصة به.

// @grant GM_setClipboard const orderId = document.querySelector('.order-id')?.textContent?.trim();if (orderId) { GM_setClipboard(orderId, 'text');}

القوائم والتنزيلات

أضف إجراءات المستخدم المتعمدة

GM_registerMenuCommand / GM_unregisterMenuCommand

قم بتسجيل أمر في قائمة User Script. يعد هذا نموذجًا جيدًا للإجراءات التي يجب أن تحدث فقط عندما يطلبها المستخدم صراحةً.

// @grant GM_registerMenuCommand// @grant GM_unregisterMenuCommand const commandId = GM_registerMenuCommand( 'Highlight overdue rows', () => { document.querySelectorAll('.row.overdue').forEach((row) => { row.style.fontWeight = '700'; }); }); // Remove the menu item later if the script no longer needs it.// GM_unregisterMenuCommand(commandId);

GM_download

ابدأ التنزيل من خلال Social Browser. قم بتسمية الملف بشكل واضح واستخدمه فقط عندما يكون التنزيل جزءًا من الغرض المرئي للبرنامج النصي.

// @grant GM_download await GM_download({ url: 'https://example.com/reports/today.csv', name: 'today-report.csv'});

متقدم

unsafeWindow: الجسر إلى الصفحة العالمية فقط عند الضرورة

تعمل User Scripts ذات المنح الصريحة عادةً في عالم معزول. unsafeWindow عبارة عن جسر اختياري للوصول إلى العالميين في العالم الرئيسي للصفحة. استخدمه فقط عندما يكشف موقع الويب عن متغير صفحة أو وظيفة لا يمكن الوصول إليها بواسطة البرنامج النصي المعزول العادي.

// @grant unsafeWindow const appVersion = unsafeWindow.appConfig?.version;if (appVersion) { console.log('Page app version:', appVersion);}

حكم التنفيذ العالمي

مثال كامل

برنامج نصي صغير يجمع بين التخزين والأنماط وأوامر القائمة والحافظة

يبقى هذا المثال صغيرًا عن قصد. فهو يتذكر ما إذا كان التمييز ممكنًا، ويضيف قاعدة نمط واحدة، ويتيح للمستخدم تبديلها من قائمة User Script، وينسخ قيمة الصفحة المرئية فقط عندما يُطلب منه ذلك.

// ==UserScript==// @name Helpful order-page tools// @namespace https://example.com/my-scripts// @version 1.0.0// @match https://example.com/orders/*// @grant GM_getValue// @grant GM_setValue// @grant GM_addStyle// @grant GM_registerMenuCommand// @grant GM_setClipboard// ==/UserScript== (() => { 'use strict';  GM_addStyle(` .sb-order-highlight { outline: 2px solid currentColor; font-weight: 700; } `);  const applyHighlight = () => { const enabled = GM_getValue('highlightEnabled', true); document.querySelectorAll('.order-total').forEach((element) => { element.classList.toggle('sb-order-highlight', enabled); }); };  GM_registerMenuCommand('Toggle order highlighting', () => { const current = GM_getValue('highlightEnabled', true); GM_setValue('highlightEnabled', !current); applyHighlight(); });  GM_registerMenuCommand('Copy current order ID', () => { const orderId = document.querySelector('.order-id')?.textContent?.trim(); if (orderId) { GM_setClipboard(orderId, 'text'); } });  applyHighlight();})();