https://github.com/mdn/webextensions-examples
يحتفظ به فريق إضافات موزيلا.
تعتبر WebExtensions طريقة لكتابة ملحقات المتصفح: أي البرامج المثبتة داخل متصفح ويب تعدل سلوك المتصفح أو صفحات الويب المحملة بواسطة المتصفح. تم تصميم WebExtensions على مجموعة من واجهات برمجة تطبيقات المتصفح ، لذلك سيتم تشغيل WebExtensions المكتوبة لـ Google Chrome أو Opera أو Edge ، في معظم الحالات ، في Firefox أيضًا.
يعد مستودع "Webextensions-Examples" مجموعة من WebExtensions البسيطة والكاملة والقابلة للتثبيت. توضح الأمثلة كيفية استخدام واجهات برمجة تطبيقات WebExtensions ، ويمكنك استخدامها كنقطة انطلاق لاتفاقيات الويب الخاصة بك.
للحصول على فهرس لجميع الأمثلة ، راجع صفحة "امتدادات مثال" على MDN.
يتم توفير الأمثلة بموجب ترخيص Mozilla Public 2.0.
لاستخدام المستودع ، أولاً استنساخه.
كل مثال موجود في مجلد المستوى الأعلى ويتضمن إعادة قراءة قصيرة يشرح ما يفعله. لمعرفة كيفية عمل مثال ، قم بتثبيته في Firefox باتباع تعليمات التثبيت.
لإيجاد طريقك حول الهيكل الداخلي لـ Webextension ، إلقاء نظرة على تشريح صفحة WebExtension على MDN.
لاستخدام هذه الأمثلة في Firefox ، استخدم أحدث إصدار من Firefox. ومع ذلك ، تعمل معظم الأمثلة مع الإصدارات السابقة.
تعتمد بعض الأمثلة على واجهات برمجة التطبيقات المتوفرة فقط في إصدارات ما قبل الإصدار من Firefox. عندما يكون هذا هو الحال ، يعلن المثال الحد الأدنى للنسخة التي يحتاجها في سمة strict_min_version
browser_specific_settings key
في ملف manifest.json الخاص بالتمديد.
تعمل بعض الأمثلة فقط على مجالات أو صفحات محددة. يتم توفير تفاصيل أي قيود في ملف ReadMe لكل مثال. لا تعمل أي من الأمثلة في تصفح Windows بشكل افتراضي ، راجع الامتدادات في التصفح الخاص للحصول على التفاصيل.
لتشغيل امتداد مثال:
about:debugging
. انقر فوق تحميل الوظيفة الإضافية المؤقتة وحدد ملف manifest.json
داخل مجلد امتداد مثال. إليك مقطع فيديو يوضح كيفية القيام بذلك.web-ext run
. هذا يطلق Firefox ويقوم بتثبيت الامتداد تلقائيًا. توفر هذه الأداة بعض ميزات التطوير الإضافية ، مثل إعادة التحميل التلقائي. يتم اختبار هذه الأمثلة في Firefox. قد يعملون في متصفحات أخرى ، إذا كان المتصفح يدعم واجهات برمجة التطبيقات المستخدمة. لاحظ أن هذه الأمثلة تستخدم جميعها مساحة اسم browser
ووعد بالعمل مع وظائف غير متزامنة. هذا يعني أن الأمثلة لن تعمل في Chrome إلا إذا كنت تستخدم polyfill التي توفرها Mozilla. راجع نظرة عامة على واجهات برمجة تطبيقات Webextension لمزيد من المعلومات.
لمعرفة المزيد حول تطوير WebExtensions ، راجع وثائق Webextensions على MDN لبدء أدلة البدء ، والدروس التعليمية ، ومستندات مرجعية API الكاملة.
إذا واجهت مشكلة:
إذا لم تتمكن من حل المشكلة ، فقم بتقديم خطأ.
نرحب بالمساهمات ، سواء كانت أمثلة جديدة أو ميزات جديدة أو إصلاحات الأخطاء أو ترجمات السلاسل القابلة للترجمة. يرجى الاطلاع على ملف المساهمة.