webextensions examples
1.0.0
https://github.com/mdn/webextensions-examples
Поддерживается командой Addons Mozilla.
Webextensions - это способ написать расширения браузера: то есть программы, установленные в веб -браузере, которые изменяют поведение браузера или веб -страниц, загруженных браузером. Вебэктерионы построены на наборе API-поперечных Browser, поэтому Webextensions, написанные для Google Chrome, Opera или Edge, в большинстве случаев будут работать и в Firefox.
Репозиторий «Webextensions-examples» представляет собой коллекцию простых, полных и установленных Webextensions. Примеры показывают, как использовать API Webextensions, и вы можете использовать их в качестве отправной точки для ваших Webextensions.
Для индекса всех примеров см. Страницу «Пример расширения» на MDN.
Примеры предоставляются в соответствии с общественной лицензией Mozilla 2.0.
Чтобы использовать репозиторий, сначала клонируйте его.
Каждый пример находится в папке на верхнем уровне и включает в себя короткую Readme, объясняющую, что он делает. Чтобы увидеть, как работает пример, установите его в Firefox, следуя инструкциям по установке.
Чтобы найти свой путь вокруг внутренней структуры Webextension, посмотрите на анатомию страницы Webextension на MDN.
Чтобы использовать эти примеры в Firefox, используйте самый последний выпуск Firefox. Тем не менее, большинство примеров работают с более ранними выпусками.
Несколько примеров полагаются на API, которые доступны только в предварительных версиях Firefox. Если это так, в примере заявляет минимальную версию, которая ему нужна в атрибуте strict_min_version browser_specific_settings key в файле Manifest.json расширения.
Некоторые примеры работают только на определенных доменах или страницах. Подробная информация о любых ограничениях представлена в файле Readme каждого примера. По умолчанию ни один из примеров не работает в частных просмотрах Windows, см. В деталях расширения в частном просмотре.
Чтобы запустить пример расширения:
about:debugging . Нажмите «Загрузить временное дополнение» и выберите файл manifest.json в папке примера расширения. Вот видео, которое демонстрирует, как это сделать.web-ext run . Это запускает Firefox и автоматически устанавливает расширение. Этот инструмент предоставляет некоторые дополнительные функции разработки, такие как автоматическая перезагрузка. Эти примеры тестируются в Firefox. Они могут работать в других браузерах, если браузер поддерживает используемые API. Обратите внимание, что все эти примеры используют пространство имен browser и обещают работать с асинхронными функциями. Это означает, что примеры не будут работать в Chrome, если вы не используете полифилл, предоставленный Mozilla. Смотрите обзор API Webextension для получения дополнительной информации.
Чтобы узнать больше о разработке Webextensions, см. Документацию Webextensions на MDN для начала работы, руководства, учебных пособий и полных справочных документов API.
Если вы столкнетесь с проблемой:
Если вы не можете решить проблему, подайте ошибку.
Мы приветствуем вклад, будь то новые примеры, новые функции, исправления ошибок или переводы локализируемых строк. Пожалуйста, смотрите файл appling.md для получения более подробной информации.
